Skip to content
eufratePublic

About

LocalDrop is a lightweight and intuitive tool for sharing files on your local network via an HTTP server. Perfect for quickly transferring files between computers on the same network without using cloud services or USB drives

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

Β 

History

5 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

LocalDrop

LocalDrop is a lightweight and intuitive tool for sharing files on your local network via an HTTP server. Perfect for quickly transferring files between computers on the same network without using cloud services or USB drives.


πŸ”œ Coming Soon

A Secure Edition of LocalDrop is currently in development.

Stay tuned for updates! πŸ›‘οΈ


✨ Features

  • πŸš€ HTTP Server - Share files instantly
  • πŸ”’ Password protection - Keep your files secure
  • πŸ“‚ Dedicated folder - ~/Desktop/LocalDrop
  • βš™οΈ Custom port - Choose your preferred port (default: 8000)
  • 🌐 Remote access - Download from any PC on the network
  • πŸ“Š Server status - Check if the server is running
  • πŸ–₯️ Cross-platform - Works on Linux, Windows and Mac

πŸ“‹ Prerequisites

  • Python 3.6+
  • No external libraries required (uses only standard library)

πŸš€ Installation

# 1. Clone the repository
git clone https://github.com/eufrate/LocalDrop.git

# 2. Enter the folder
cd LocalDrop

# 3. Make it executable (optional, on Linux/Mac)
chmod +x LocalDrop.py

# 4. Run the tool
python3 LocalDrop.py

πŸ’» Usage

Starting the tool

python3 LocalDrop.py

Main menu

    1.[+] Start the server.
    2.[+] Service info.
    3.[+] Start a protected server.
    4.[#] Exit

Option 1: Start Server (No Password)

Starts the HTTP server without authentication.

1. Choose 1
2. Select port (default or custom)
3. Server started!

Example:

Choose an option: 1
1[+] Use default
2[+] Use custom port
Choose an option: 1
Serving at port 8000
Access: http://192.168.1.17:8000/

Option 2: Service Info

Shows information about the server status.

1.[!] Access: http://192.168.1.17:8000/
2.[!] Server status: Running
3.[!] Service version: 1.0
4.[!] Share folder: /home/user/Desktop/LocalDrop

Option 3: Start Protected Server (With Password)

Starts the server with password protection.

1. Choose 3
2. Enter password (e.g., 123)
3. Choose port (default 8000)
4. Protected server started!

Example:

Choose an option: 3
[*] Choose a password: 123
[+] Choose a port (enter for default): 
Serving protected server at port 8000
Access: http://192.168.1.17:8000/

Option 4: Exit

Exits the program.


On the other machine

From terminal (Linux/Mac)

Without password:

# Download a file
wget http://192.168.1.17:8000/file.exe

# With custom name
wget http://192.168.1.17:8000/file.exe -O new_name.exe

# With curl
curl -O http://192.168.1.17:8000/file.exe

With password:

# wget
wget --user=anything --password=123 http://192.168.1.17:8000/file.exe

# curl
curl -u :123 http://192.168.1.17:8000/file.exe -O

From terminal (Windows PowerShell)

Without password:

Invoke-WebRequest -Uri "http://192.168.1.17:8000/file.exe" -OutFile "file.exe"

With password:

$cred = Get-Credential
Invoke-WebRequest -Uri "http://192.168.1.17:8000/file.exe" -Credential $cred -OutFile "file.exe"

βš™οΈ Configuration

Main variables in code

PORT = 8000                # Default port
SharePath = "~/Desktop/LocalDrop"  # Shared folder

Ports

  • Default: 8000
  • Custom: any port 1024-65535
  • Privileged ports: 1-1024 (require sudo)

πŸ” Troubleshooting

"Address already in use" / Port busy

# The port is already in use
# Solution 1: Use a different port (option 2)
# Solution 2: Kill the process
lsof -t -i:8000 | xargs kill -9   # Linux/Mac

"Permission denied"

# Ports < 1024 require privileges
sudo python3 LocalDrop.py

"Connection refused"

# The server is not running
# Start the server before connecting

The folder doesn't exist

# The tool will create it for you
# Or create it manually:
mkdir ~/Desktop/LocalDrop

❓ FAQ

How secure is it?

  • Password travels in Base64 (NOT encrypted)
  • Do not use on public internet
  • Recommended for trusted local networks

Where are the shared files?

  • Default: ~/Desktop/LocalDrop
  • Put all files to share here
  • The tool creates the folder automatically

Is the server still running?

  • Check with curl http://localhost:8000
  • Or use option 2 from the menu: "Service info"

Can I change the folder?

  • Modify SharePath in the code
  • Restart the tool

Does it work on Windows?

  • βœ… Yes, Python is cross-platform
  • Use python LocalDrop.py on Windows

πŸ“„ License

MIT License - See LICENSE file for details.


πŸ‘€ Author


⭐️ Support

If you like this project, star it on GitHub!

GitHub stars


Happy sharing! πŸ“πŸš€

About

LocalDrop is a lightweight and intuitive tool for sharing files on your local network via an HTTP server. Perfect for quickly transferring files between computers on the same network without using cloud services or USB drives

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages