WebShare for Windows

WebShare for Windows is a file-sharing application that utilizes PySide6 (Qt6) for a dark mode GUI and Flask for a local web server. Users can upload and download files easily through a web interface, with QR code support for quick access.

💪 Features

Core Features

• Local File Sharing: Upload files from your PC and share them with other devices on the network.
• Text Sharing: Share text snippets easily with clipboard support.
• QR Code Generation: Automatically generates a QR code for easy access to the server URL.
• Dark Mode UI: A modern, visually appealing interface with mobile-responsive design.
• File Upload & Download: List and download files from the web interface.
• File Management: Delete files from the web interface or application.
• Storage Statistics: Track file count and storage usage.
• Upload Progress: Visual feedback during file uploads.
• Customizable Port: Configure the server port as needed.
• About Dialog: View information about the application.
• Update Checker: Check for and download new versions of the application.
• Clickable URL: Click the server URL to open it in your browser.
• Copy to Clipboard: Easily copy the server URL with one click.

Advanced Features

• Password Protection: Secure your server with optional password authentication
• Multiple File Upload: Upload multiple files at once with batch processing
• Drag & Drop: Drag files directly from your desktop into the browser
• File Preview: Preview images, text files, and PDFs without downloading
• System Tray: Minimize to system tray with quick access to uploads folder
• Enhanced Progress: Real-time progress tracking for multiple file uploads
• Mobile Optimized: Responsive web interface works great on phones and tablets

Security & Performance

• File Upload Limits: Configurable maximum file size (default 500 MB) and total storage (default 10 GB)
• File Type Validation: Block dangerous file types (executables, scripts) and optionally whitelist allowed extensions
• Filename Sanitization: Automatically sanitize filenames to prevent path traversal and security issues
• Rate Limiting: Prevent abuse with configurable upload rate limits
• Production Server: Uses Waitress WSGI server for better performance and stability
• Comprehensive Logging: Structured logging with rotation for all server events, uploads, downloads, and errors
• Configuration System: JSON-based configuration file for easy customization
• Error Handling: Improved error handling with user-friendly messages

Installation & Usage

Option 1: Download Installer (Recommended)

1. Download the latest installer from the Releases page
2. Run the installer and follow the setup wizard
3. Launch WebShare from the Start Menu or Desktop shortcut

Option 2: Download Portable Build

1. Download the latest release ZIP file from the Releases page
2. Extract the ZIP file to your desired location
3. Run WebShare.exe

No Python installation required for either option!

Option 3: Run from Source

1. Clone this repository:

git clone https://github.com/oop7/WebShare-for-Windows.git
cd WebShare-for-Windows

2. Install the required packages:

pip install -r requirements.txt

3. Run the application:

python main.py

Usage

1. Click "Start WebShare Server" to launch the local server.
2. A QR code will be generated; scan it to access the web interface.
3. Use the web interface to upload and download files.
4. View storage statistics in the application.
5. Delete files individually from the web interface or all at once from the application.
6. Click "About" to view information about the application.
7. Click "Check for Updates" to check for and download new versions.

Configuration

On first run, a config.json file will be created in the application directory. You can customize:

• Upload Limits: Maximum file size and total storage
• File Type Restrictions: Allowed/blocked file extensions
• Server Settings: Port, host, connection limits
• Security: Rate limiting, filename sanitization
• Logging: Log levels, file rotation settings

Example configuration:

{
    "server": {
        "host": "0.0.0.0",
        "port": 5000,
        "max_connections": 100
    },
    "upload": {
        "max_file_size_mb": 500,
        "max_total_size_gb": 10,
        "sanitize_filenames": true
    },
    "security": {
        "password_protected": false,
        "password": "your_secure_password"
    },
    "ui": {
        "show_system_tray": true,
        "minimize_to_tray": true
    }
}

Enable Password Protection: Set "password_protected": true and specify your desired password in config.json.

Logs are stored in the logs/ directory with automatic rotation.

🏗️ Project Structure

WebShare-for-Windows/
├── .github/                # GitHub Actions
│   └── workflows/
│       └── build-windows.yml  # Automated build workflow
├── app/                    # Application package
│   ├── templates/          # HTML templates
│   │   ├── icon/           # Application icons (icon.ico, icon.png, icon48.png)
│   │   ├── index.html      # Web interface
│   │   └── login.html      # Login page
│   ├── utils/              # Utility functions
│   │   ├── icon_fallback.py
│   │   ├── network.py
│   │   └── qr_helper.py
│   ├── __init__.py         # Package initialization
│   ├── auth.py             # Authentication system
│   ├── config.py           # Configuration management
│   ├── file_ops.py         # File operations
│   ├── file_validator.py   # File validation and security
│   ├── gui.py              # PySide6 GUI implementation
│   ├── logger.py           # Logging system
│   ├── routes.py           # Flask routes
│   ├── server.py           # Flask server implementation
│   ├── settings_dialog.py  # Settings dialog
│   └── version.py          # Version information
├── logs/                   # Log files directory
├── temp/                   # Temporary files directory
├── uploads/                # Default upload directory
├── .gitignore              # Git ignore file
├── config.json             # Configuration file (auto-generated)
├── LICENSE                 # MIT License
├── main.py                 # Main application entry point
├── pytest.ini              # Pytest configuration
├── README.md               # Project documentation
└── requirements.txt        # Python dependencies

📜 License

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

📙 Acknowledgments

• PySide6 (Qt6) for the GUI framework
• Flask for the web server
• Waitress for production WSGI server
• QRCode for QR code generation
• Humanize for human-readable file sizes

🔒 Security Notes

• By default, dangerous file types (executables, scripts) are blocked
• All filenames are sanitized to prevent path traversal attacks
• Rate limiting is enabled to prevent abuse
• The server binds to all interfaces (0.0.0.0) by default - use firewall rules to restrict access
• For additional security, consider using the application only on trusted networks
• Check config.json to customize security settings