Local viewer for Stable Diffusion generated images built with CustomTkinter. Gallery view of selected folder. Autodetect newly generated images.
Last updated May 16, 2026
82
Stars
7
Forks
0
Issues
0
Stars/day
Attention Score
2
Topics
Language breakdown
No language data available.
โธ Files
click to expand
README
Promptvision
Promptvision is a powerful and user-friendly image viewer application built with Python and customtkinter. It provides an intuitive interface for browsing, organizing, and managing your image collections.
Features
- Image browsing with next/previous navigation
- Metadata generation display for each image
- Gallery view for quick image overview
- Favorite image marking and exporting
- Auto-update feature for monitoring new images in the selected directory
- Settings management for persistent user preferences
- Keyboard shortcuts for efficient navigation
Installation
- Clone the repository:
git clone https://github.com/yourusername/promptvision.git
cd promptvision
- Install the required dependencies:
pip install -r requirements.txt
- For Linux users, install tkinter:
sudo apt-get install python3-tk
On Fedora or Red Hat-based systems:
sudo dnf install python3-tkinter
On Arch Linux:
sudo pacman -S tk
Usage
To run Promptvision, execute the following command in the project directory:
python promptvision.py
Key Bindings
- Left Arrow / 'A': Previous image
- Right Arrow / 'D': Next image
- 'F': Toggle favorite status of the current image
Image viewer

(WSL2 on Windows 10)
Settings
Customize your Promptvision experience with the settings panel:

Gallery
(WSL2 on Windows 10)
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create your feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
License
This project is licensed under the MIT License - see the LICENSE file for details.
๐ More in this category