First Commit

Author: TutorialsAndroid

README.md

@@ -0,0 +1,185 @@
+# 🌦️ Weather Widget (PyQt6)
+
+A lightweight **desktop weather widget for Windows** built with **Python + PyQt6**.  
+It displays real-time weather for your city and sits neatly on your desktop like a native widget.
+
+The widget automatically detects your location on first launch and updates the weather every 10 minutes.
+
+---
+
+## ✨ Features
+
+• 🌍 Auto detect location on first launch  
+• 🌡️ Real-time weather updates  
+• 🔄 Automatic refresh every 10 minutes  
+• ☀️ Weather condition icons  
+• 🎨 Temperature color indicators  
+• 📌 Draggable floating desktop widget  
+• 🖥️ Always-on-top frameless UI  
+• ⚙️ System tray integration  
+• 🚀 Optional **Start with Windows** toggle  
+• 📍 Manual city selection  
+• 🔔 Weather update notifications
+
+---
+
+## ⬇️ Download
+
+You can download the latest installer here:
+
+[![Download Installer](https://img.shields.io/badge/Download-Windows%20Installer-blue?style=for-the-badge&logo=windows)](https://github.com/TutorialsAndroid/weather-widget/releases/latest)
+
+After downloading:
+
+1. Run the installer
+2. Launch **Weather Widget**
+3. The widget will appear on your desktop
+
+---
+
+## 🖥️ How It Works
+
+The widget:
+
+1. Detects your location using IP geolocation
+2. Fetches weather data from a **secure serverless API**
+3. Displays temperature, description, and weather icon
+4. Saves your city and widget position locally
+
+Your settings are stored in:
+
+```
+
+LOCALAPPDATA/WeatherWidget/config.json
+
+```
+
+---
+
+## 📦 Requirements
+
+If running from source:
+
+```
+
+Python 3.9+
+PyQt6
+requests
+
+````
+
+Install dependencies:
+
+```bash
+pip install PyQt6 requests
+````
+
+---
+
+## ▶️ Run From Source
+
+Clone the repository:
+
+```bash
+git clone https://github.com/TutorialsAndroid/weather-widget.git
+cd weather-widget
+```
+
+Run:
+
+```bash
+python weather-widget.py
+```
+
+Main application file:
+
+```
+weather-widget.py
+```
+
+Source code:
+
+---
+
+## 🏗 Build EXE
+
+Install PyInstaller:
+
+```bash
+pip install pyinstaller
+```
+
+Build executable:
+
+```bash
+pyinstaller --noconfirm --onefile --windowed --icon=weather.ico weather-widget.py
+```
+
+The executable will appear in:
+
+```
+dist/weather-widget.exe
+```
+
+---
+
+## 📦 Build Installer (Inno Setup)
+
+Example script:
+
+```ini
+[Setup]
+AppName=Weather Widget
+AppVersion=1.0
+DefaultDirName={pf}\WeatherWidget
+DefaultGroupName=WeatherWidget
+OutputDir=.
+OutputBaseFilename=WeatherWidgetInstaller
+
+[Files]
+Source: "dist\weather-widget.exe"; DestDir: "{app}"
+
+[Icons]
+Name: "{group}\Weather Widget"; Filename: "{app}\weather-widget.exe"
+```
+
+Compile with **Inno Setup Compiler**.
+
+---
+
+## ⚙️ System Tray Menu
+
+Right-click or click the **⋮ menu** to access:
+
+```
+Refresh
+Auto Detect Location
+Change City
+Start with Windows
+Exit
+```
+
+---
+
+## 🔒 Security
+
+The OpenWeather API key is **not included in this repository**.
+
+Weather requests are proxied through a **serverless API** to prevent key exposure.
+
+---
+
+## 📜 License
+
+MIT License
+
+---
+
+## 👨‍💻 Author (Akshay - TutorialsAndroid)
+
+Built with ❤️ using **Python + PyQt6**
+
+
+![Python](https://img.shields.io/badge/Python-3.9+-blue)
+![Platform](https://img.shields.io/badge/Platform-Windows-lightgrey)
+![License](https://img.shields.io/badge/License-MIT-green)