MicPish
Kgh
Install / Use
/learn @mithun50/MicPishREADME
MicPish
MicPish is a Flask-based web application designed to capture Audio file (of 4sec) and gather IP-based geolocation data from users. It integrates with SSH tunnel to securely expose your local server to the internet, enabling external access.
Table of Contents
Features
- Captures Audio file (of 4sec) from users and saves them locally.
- Collects and logs geolocation data such as IP address, city, region, country, latitude, and longitude.
- Uses SSH to expose the local Flask server to the internet.
- Cross-platform support for Linux, macOS, Windows (Git Bash or Cygwin), and Termux on Android.
Requirements
- Python 3.x
- pip (Python package installer)
- ssh installed on your Device
Installation
Clone the Repository
git clone https://github.com/mithun50/MicPish.git
cd MicPish
Run the Setup Script
The setup script will install all required dependencies and prepare your environment.
For Linux, macOS, and Termux (Android):
chmod +x setup.sh
./setup.sh
For Windows:
- Install Python 3.x from python.org.
- Install pip and figlet manually or using the Cygwin setup.
- Run
setup.shin Git Bash or manually install dependencies listed inrequirements.txt. - Install the
OpenSSHin your environment
Manual Setup (if not using setup.sh)
- Install Python dependencies after installing the python on the device:
pip install flask pyfiglet pyngrok requests termcolor - Install
figlet and Openssh:- Debian/Ubuntu:
sudo apt install figletandsudo apt install openssh-server -y - Red Hat/Fedora:
sudo yum install figletandsudo dnf install openssh-server -y - macOS (Homebrew):
brew install figletandbrew install openssh - Termux(android):
pkg install figletandpkg install openssh -y
- Debian/Ubuntu:
Usage
-
Expose the Server:
- The script will use the Portforwarding using the "SSH tunnel"
-
Access the Web Interface:
- After starting the server, navigate to the provided URL and Send it to Victim(either local or the SSH tunnel public URL).
-
Capture Data:
- The server captures 4sec Audio File and logs IP-based geolocation data whenever a user accesses the
/endpoint.
- The server captures 4sec Audio File and logs IP-based geolocation data whenever a user accesses the
Disclaimer
This project is for educational purposes only. It demonstrates basic Flask and Python scripting skills along with web-based data handling. It is not intended for malicious or unauthorized use. The author is not responsible for any misuse of this tool.
