Securely and anonymously share files over the Tor network
TorDrop is intended for educational and personal privacy purposes.
The author is not responsible for any misuse or illegal activity caused by using this software.
Use responsibly and always comply with your local laws.
Note: This tool will never include any Tor packages or any functionality for bypassing local Tor network blocks (such as bridges). Users are expected to install and configure Tor separately.
TorDrop is a CLI tool for securely and anonymously sharing files over the Tor network.
It creates a unique .onion link to share your file, protecting both your identity and the recipient's.
- 🔒 Secure & Anonymous: All traffic routed through the Tor network
- ⏰ Temporary Links: Set TTL for link expiration
- 📥 One-Time Downloads: Link expires after first download
- 📱 QR Code Support: Easy mobile sharing
- Python 3.6+
- Tor
Before installing TorDrop, ensure you have:
- Python 3.6+
- Tor installed in your system or placed in the project folder
For system-wide Tor installation:
- Linux:
sudo apt install tor(Debian/Ubuntu) or equivalent for your distribution - Windows: Download from Tor Project website
You can place the Tor executable directly in the project folder:
- Linux: Name it
tor - Windows: Name it
tor.exe
-
Make the installation script executable:
chmod +x install.sh
-
Run the installation script:
./install.sh
-
Follow the prompts to complete installation
-
Run PowerShell as Administrator
-
Execute the installation script:
.\install.ps1
-
Follow the prompts to complete installation
If you prefer manual installation:
-
Install dependencies:
pip install -r requirements.txt
-
Run directly:
python tordrop.py /path/to/your/file.zip
python tordrop.py /path/to/your/file.zip
# One-time download
python tordrop.py --once /path/to/your/file.zip
# 1-hour expiration
python tordrop.py --ttl 3600 /path/to/your/file.zip
# Development mode (without Tor)
python tordrop.py run
| Option | Description | Default |
|---|---|---|
--ttl <seconds> |
Time-to-live (0 = forever) | 0 |
--once |
One-time download | False |
--simple |
Simplified HTML template | False |
--port <port> |
Local port | 8080 |
--tor-path <path> |
Tor executable path | tor |
--no-qr |
Disable QR code | False |
--debug |
Enable debug output | False |
- Starts a Tor process on your machine
- Creates an ephemeral hidden service
- Forwards the service to a local Flask web server
- Generates a shareable
.onionlink - Recipients access the file via Tor Browser
This project is licensed under the GNU GPL v3.0 – see the LICENSE file for details.