refactor: major improvements and bug fixes

Author: oop7

.gitignore

@@ -0,0 +1,41 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+env/
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual Environment
+venv/
+ENV/
+env/
+
+# Application specific
+uploads/
+qr_code.png
+
+# OS specific
+.DS_Store
+Thumbs.db
+.directory
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo 

README.md

@@ -8,6 +8,12 @@ WebShare for Windows is a file-sharing application that utilizes PyQt5 for a dar
 - **QR Code Generation**: Automatically generates a QR code for easy access to the server URL.
 - **Dark Mode UI**: A modern, visually appealing interface.
 - **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.
 
 ## 📄 Requirements
 
@@ -16,27 +22,60 @@ WebShare for Windows is a file-sharing application that utilizes PyQt5 for a dar
 
 ## 💻 Installation & Usage
 
-1. Download the latest executable from the [Releases](https://github.com/oop7/WebShare-for-Windows/releases) Section.
-  
+1. Clone this repository:
+```bash
+git clone https://github.com/oop7/WebShare-for-Windows.git
+cd WebShare-for-Windows
+```
+
 2. Install the required packages:
 ```bash
 pip install -r requirements.txt
 ```
+
 3. Run the application:
 ```bash
-Run.bat
+python main.py
 ```
+
+Alternatively, you can download the latest executable from the [Releases](https://github.com/oop7/WebShare-for-Windows/releases) section.
+
 ### **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.
+
+## 🏗️ Project Structure
+
+```
+WebShare-for-Windows/
+├── app/                    # Application package
+│   ├── static/             # Static files for Flask
+│   ├── templates/          # HTML templates
+│   ├── utils/              # Utility functions
+│   ├── __init__.py         # Package initialization
+│   ├── gui.py              # PyQt5 GUI implementation
+│   └── server.py           # Flask server implementation
+├── uploads/                # Default upload directory
+├── .gitignore              # Git ignore file
+├── LICENSE                 # MIT License
+├── main.py                 # Main application entry point
+├── README.md               # Project documentation
+├── requirements.txt        # Python dependencies
+└── Run.bat                 # Windows batch script to run the app
+```
 
 ## 📜 License
 This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
 
 ## 📙 Acknowledgments
 
-- PyQt5
-- Flask
-- QRCode
+- PyQt5 for the GUI framework
+- Flask for the web server
+- QRCode for QR code generation
+- Humanize for human-readable file sizes

Run.bat

@@ -1,3 +1,3 @@
 @echo off
-python "%~dp0main.py"
+python main.py
 pause

app/__init__.py

@@ -0,0 +1,18 @@
+"""
+WebShare for Windows application package
+"""
+
+# Import version information
+from app.version import __version__, __author__
+
+# Import utility functions first
+from app.utils import get_local_ip, generate_qr_image, get_pixmap_from_base64
+
+# Then import server functionality
+from app.server import app, run_server, UPLOAD_FOLDER
+
+# Finally import the GUI class
+from app.gui import WebShareApp
+
+# Export all needed symbols
+__all__ = ['WebShareApp', 'app', 'run_server', '__version__', '__author__']