🚀 LocalDrop Pro – Secure Local File Sharing

LocalDrop Pro is a sleek, modern desktop application that allows you to share files and folders over your local network instantly using a browser — no external services, no uploads, no hassle.

Built with Python + CustomTkinter, it provides a clean UI, QR-based access, and token-based security for safe local transfers.

---

✨ Features

• 📁 Share Files & Folders over LAN instantly
• 🔗 Auto-generated URL + QR Code for quick access
• 🔐 Secure Token-Based Access Control
• 📱 Device Detection (Android, iPhone, Windows, etc.)
• 📊 Live Network Activity Logs
• 🌐 Dynamic IP Selection
• 🎨 Dark/Light Mode Toggle
• ⚡ Multi-device Support (Threaded Server)
• 🧠 Smart File Icons (media, docs, archives, etc.)

---

🚀 Installation & Demo

To run the application without setting up a local development environment, you can download the pre-compiled executable:

• Windows (.exe): Download from Google Drive

---

🛠️ Tech Stack

• Python 3
• CustomTkinter – Modern UI
• http.server – Lightweight HTTP server
• socketserver – Multi-threaded handling
• qrcode – QR code generation
• Tkinter – File dialogs & system integration

---

📦 Installation

1. Clone the repository

git clone https://github.com/your-username/localdrop-pro.git
cd localdrop-pro

2. Install dependencies

pip install customtkinter qrcode[pil]

3. Run the application

python main.py

---

🚀 Usage

1. Launch the app

2. Select your network IP

3. Choose:

   • 📄 File
   • 📁 Folder

4. Click 🚀 Start Server

5. Share via:

   • QR Code 📱
   • URL 🔗

6. Open the link on any device in the same network

---

🔐 Security

• Each session generates a unique token

• Unauthorized requests are:

  • ❌ Blocked
  • 🚨 Logged in activity panel

• Only users with the correct link (token) can access files

---

📡 How It Works

• Spins up a local HTTP server on your selected IP
• Serves files via browser interface
• Adds token validation layer for security
• Tracks connected devices via User-Agent parsing

---

📁 Project Structure

localdrop-pro/
│── main.py
│── README.md

---

⚠️ Limitations

• Works only on the same local network (LAN/WiFi)
• Large file transfers depend on network speed

---

💡 Future Improvements

• ⬆️ Upload support (receive files)
• 🔑 Password protection
• 📊 Transfer progress tracking
• 📦 Zip folder downloads
• 🌍 Cross-network tunneling (like ngrok)
• 🧾 Download history

---

👨‍💻 Author

Utkarsh Gupta

---