diff --git a/README.md b/README.md new file mode 100644 index 0000000..4e5d753 --- /dev/null +++ b/README.md @@ -0,0 +1,63 @@ +# 🚀 LiteMon v1.0 - Lightweight Windows Resource Monitor + +**LiteMon** is a super lightweight, portable, and elegant system monitor widget for Windows. Built using Python and PyQt6, this widget is specifically designed to sit perfectly on your Taskbar or Desktop without disrupting your productivity, providing real-time information about your hardware and network conditions. + +![LiteMon Preview](https://img.shields.io/badge/Status-Active-brightgreen) ![Platform](https://img.shields.io/badge/Platform-Windows%2010%20%7C%2011-blue) ![License](https://img.shields.io/badge/License-Free-orange) + +## ✨ Key Features + +📊 **Real-Time Metrics:** +* **System:** CPU Usage (%), RAM Usage (%), and System Uptime. +* **Network:** Upload/Download Speeds (Bytes/Bits) and Ping Latency (ms). +* **IP Address:** Displays both Local IP and Public IP. + +📌 **Taskbar Lock (True Always-on-Top):** +* Powered by native Windows API injection that anchors LiteMon directly to the Taskbar (`Shell_TrayWnd`). +* **Click-immune:** It will never get hidden or sent to the back, even when you interact with the Windows 11 Taskbar. + +🎨 **Endless Customization:** +* **Layout Modes:** Choose between a 1-line horizontal, a compact 2-line horizontal (perfect for the Taskbar), or a vertical layout. +* **Smart Themes:** Comes with popular pre-installed themes (*Catppuccin, Dracula, Tokyo Night, Nord, etc.*). +* **Custom Style:** Total freedom to change Fonts, Background Colors, Text Colors, and Window Opacity. +* **Rounded Toggle:** Option for smooth rounded corners or sharp square edges. +* **Dynamic Colors:** Text automatically turns red (warning state) if CPU/RAM exceeds 85% or Ping goes above 100ms. + +⚙️ **Practical & Functional:** +* **100% Portable:** No installation required! Just run the `.exe` file. +* **Auto-Start:** Can be set to run automatically on Windows boot. +* **System Tray Integration:** A convenient icon in the system tray (next to the clock) allows you to instantly bring the widget back to the front with a single click. +* **Quick Utilities:** Right-click menu includes instant shortcuts to essential Windows tools (*Task Manager, Resource Monitor, CMD, Device Manager, etc.*). +* **Bilingual:** Fully supports English & Bahasa Indonesia. + +--- + +## 🚀 How to Use (Quick Start) + +Using LiteMon is incredibly simple: + +1. **Download** the latest `litemon_v1.exe` file from this repository. +2. **Move** the `.exe` file to a safe folder on your computer (e.g., `D:\Tools\LiteMon\`). +3. **Double-click** the file to run it. +4. **Right-click** anywhere on the widget to open the configuration menu (change layout, switch themes, enable auto-start, etc.). +5. Drag and place the widget anywhere you like, including inside your Taskbar! + +*(Note: All your preferences will be automatically saved in a `litemon_config.json` file generated in the same folder).* + +--- + +## 📁 Included Files in this Repository + +* `litemon_v1.exe` : The ready-to-use, compiled portable application (for end-users). +* `litemon_v1.py` : The original Python source code (for anyone interested in seeing how it works behind the scenes). +* `litemon_icon.ico` : The application icon asset. + +--- + +## 👨‍💻 Creator & Support + +Handcrafted with ☕ by **Mas Budi** (@masbudikusuma). + +* 🌐 **Official Website:** [litemon.masbudi.my.id](https://litemon.masbudi.my.id) +* 🎁 **Donate / Support:** [donate.masbudi.my.id/LiteMon](https://donate.masbudi.my.id/LiteMon) + +*This widget is 100% FREE. If you find this tool helpful for your daily workflow, your support is highly appreciated and will help fuel future updates!*