A lightweight, customizable desktop widget that displays a slideshow of images from a folder of your choice. Perfect for motivational quotes, inspirational images, or personal photos that keep you focused throughout your day.
- Image Slideshow: Display images from any folder with customizable timing
- Sleek Interface Options:
- Borderless mode with custom title bar
- Dark/light theme options
- Always-on-top capability
- User-friendly Controls:
- Position lock to prevent accidental movement
- Minimize to taskbar
- Right-click menu for all settings
- Windows Integration:
- Add to startup for automatic launch at Windows login
- Save position and settings between sessions
- Download the latest release from the Releases section
- Scroll down to "Assets" and click the "MotivationWidget.exe" to download.
- Run the executable file - no installation needed!
- Note: This program is safe and secure. Kindly read the Security and Privacy section below for more info.
-
Clone this repository
git clone https://github.com/PaenuthOtherProjs/Motivational-widget.git cd Motivational-widget -
Install required packages
pip install -r requirements.txt
-
Run the application
python motivation_widget.py
- First Launch: On first launch, you'll have to right click inside the widget and select a folder containing images
- Image Selection: Choose any folder with JPG, PNG, GIF, or BMP images
- Settings:
- Right-click on the widget to access all settings
- Left-click and drag the title bar to move the widget (when position is unlocked)
| Option | Description |
|---|---|
| Select Folder | Choose a folder containing your images |
| Set Duration | Change how long each image is displayed (seconds) |
| Always on Top | Keep the widget visible above other windows |
| Lock Position | Prevent accidental movement |
| Dark Mode | Toggle between light and dark themes |
| Borderless Mode | Toggle window borders |
| Run at Startup | Set to run automatically when you log in |
Settings are automatically saved to %USERPROFILE%\motivation_widget_config.json and loaded on startup.
- Windows 7 or higher
- Python 3.7+ (if running from source)
- Not tested on other OS
Contributions are welcome! Please check the CONTRIBUTING.md file for guidelines.
This project is licensed under the MIT License - see the LICENSE file for details.
The Motivational Widget is completely safe and contains no malicious code. Important privacy features:
- Fully Offline: This application never connects to the internet
- Zero Data Collection: We don't collect, store, or transmit any user data
- Local Storage Only: All settings are stored locally on your computer in a simple configuration file
- Open Source: The entire codebase is available for review
Some antivirus programs may flag the executable as suspicious. These are false positives due to several factors:
- It's a standalone executable created with a Python packager (like PyInstaller)
- It accesses your file system (to display your images)
- It uses "run at startup" capability
- It's unsigned (not code-signed with a certificate)
These are common triggers for heuristic-based detection algorithms, especially detection systems like "Tedy" which flag programs based on behavioral patterns rather than actual malicious code.
If your antivirus flags this application, you have several options:
- Run from source: The safest option is to run the Python source code directly
- Review the code: Examine what the program actually does
- Add an exception: Configure your antivirus to allow this specific application
The application is built with standard Python libraries and Tkinter for the GUI. It only requires file system access to:
- Read images from your selected folder
- Save/load your configuration preferences
- Create a startup entry if you enable the "Run at Startup" option