wdrive is a complete open-source Python project that creates a local Google Drive-like server on your Wi-Fi network. Built with Flask, it allows you to easily share files between devices without needing internet connectivity.

• File Upload & Download: Drag-and-drop interface with progress tracking
• File Management: View, rename, delete files with a beautiful web interface
• Search & Filter: Find files quickly by name or type
• Multi-device Access: Works on phones, tablets, laptops via web browser
• PWA Support: Install as an app on mobile devices

• Password Protection: Configurable authentication
• Multi-threaded: Fast concurrent uploads/downloads
• Large File Support: Handle files up to 16GB
• Access Logging: Track all file operations with timestamps

• Python 3.7 or higher
• Windows/macOS/Linux

1. Clone the repository:

   git clone https://github.com/xspoilt-dev/wdrive.git
   cd wdrive

2. Install dependencies:

   pip install -r requirements.txt

3. Run the server:

   python run.py

4. Access the server:

   • Open http://127.0.0.1:8080 in your browser
   • Or use the generated QR code on mobile
   • Default password: wdrive123

Basic usage:

python run.py

With custom options:

python run.py --host 0.0.0.0 --port 8080 --password mypassword

Available options:

• --host HOST: Host address (default: 0.0.0.0)
• --port PORT: Port number (default: 8080)
• --password PWD: Custom password
• --debug: Enable debug mode
• --config FILE: Use config file

1. Desktop/Laptop: http://[YOUR-IP]:8080/
2. Mobile: Scan the QR code displayed when server starts
3. Same Network: All devices must be on the same Wi-Fi network

1. Open the wdrive website on your mobile browser
2. Look for "Add to Home Screen" or "Install App" option
3. Follow the prompts to install
4. Access wdrive like a native app!

wdrive/
├── app.py                 # Main Flask application
├── run.py               # Server startup script
├── requirements.txt     # Python dependencies
├── config.ini          # Configuration file
├── utils/              # Utility modules
│   ├── __init__.py
│   ├── file_manager.py  # File operations
│   ├── logger.py       # Logging utilities
│   └── qr_generator.py # QR code generation
├── templates/          # Jinja2 HTML templates
│   ├── base.html
│   ├── index.html      # File listing page
│   ├── login.html      # Authentication page
│   └── upload.html     # File upload page
├── static/            # Static assets
│   ├── css/
│   ├── js/
│   ├── favicon.svg
│   ├── manifest.json  # PWA manifest
│   └── sw.js         # Service worker
├── shared/           # Upload directory (auto-created)
└── logs/            # Log files (auto-created)

[server]
host = 0.0.0.0
port = 8080
debug = false

[security]
require_auth = true
max_file_size = 17179869184  # 16 GB

[features]
enable_dns_server = true
enable_qr_code = true
enable_file_preview = true

• WDRIVE_PASSWORD: Set default password
• WDRIVE_PORT: Set default port
• WDRIVE_HOST: Set default host

• Drag & Drop: Drop files directly onto the webpage
• Multi-file: Upload multiple files simultaneously
• Progress Tracking: Real-time upload progress
• Auto-rename: Prevents filename conflicts
• Type Validation: Configurable file type restrictions

• Preview: View images, videos, PDFs in browser
• Search: Find files by name or extension
• Filtering: Filter by file type (images, documents, etc.)
• Bulk Operations: Select and manage multiple files

• Images: JPG, PNG, GIF, SVG, WebP, BMP
• Videos: MP4, AVI, MOV, MKV, WebM, WMV
• Audio: MP3, WAV, FLAC, AAC, OGG, WMA
• Documents: PDF, DOC, DOCX, XLS, XLSX, PPT, PPTX
• Text: TXT, MD, RTF, HTML, CSS, JS, Python
• Archives: ZIP, RAR, 7Z, TAR, GZ
• And many more...

Create a portable executable with PyInstaller:

pip install pyinstaller
pyinstaller --onefile --add-data "templates;templates" --add-data "static;static" run.py

The executable will be in the dist/ directory.

• Local Network Only: Server binds to local network interfaces
• Password Protection: Configurable authentication required
• File Validation: Configurable file type restrictions
• Access Logging: All operations are logged with IP addresses
• No Internet Required: Completely offline operation

Permission Denied (Port 53/80):

• Run as administrator/root
• Use alternative ports (8080, 3000, etc.)

Cannot Access from Mobile:

• Ensure all devices are on same Wi-Fi network
• Check firewall settings
• Try IP address instead of 'wdrive' domain

Upload Fails:

• Check file size limits (16GB max by default)
• Verify file type is allowed
• Ensure sufficient disk space

• Use SSD storage for better performance
• Increase max_file_size if needed
• Monitor logs/wdrive.log for issues
• Use wired network for fastest transfers

Contributions are welcome! Please feel free to submit pull requests, report bugs, or suggest features.

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests if applicable
5. Submit a pull request

This project is licensed under the MIT License - see the LICENSE file for details.

• Flask: Web framework
• Bootstrap: UI framework
• Bootstrap Icons: Icon library
• qrcode: QR code generation

Telegram: x_spoilt

⭐ Star this repository if you find it useful!

🐛 Found a bug? Report it here

💡 Have an idea? Suggest a feature