Imaegete

A simple image viewer built with PyQt6 and GlavnaQt.

Features

• Zoom, pan, and basic slideshow
• Animated GIF support
• On‑disk metadata cache, and in‑memory pixmap cache
• Watch folders for changes
• Keyboard shortcuts and command mode (:)

Install

git clone https://github.com/actx4gh/Imaegete.git
cd Imaegete
pip install -r requirements.txt

Usage

python main.py [options] [path]

Common options

• --start_dirs DIR scan folders (default: .)
• --categories list of sort folders
• --cache_dir DIR cache files (default: ~/.config/Imaegete/cache)
• --clear_cache clear cache and exit

For full options: python main.py --help

Controls

Action	Keyboard	Mouse
Navigation
Next image	→ (Right Arrow) / j	–
Previous image	← (Left Arrow) / k	–
First image	Home / gg	–
Last image	End / G	–
Random image	R	–
Slideshow
Toggle slideshow	S	–
Increase slideshow speed	]	–
Decrease slideshow speed	[	–
Zoom & Pan
Zoom in	+	Mouse wheel up
Zoom out	-	Mouse wheel down
Reset zoom (fit to window)	=	–
Pan (when zoomed)	–	Click & drag
View
Toggle fullscreen	F	–
Edit & Manage
Delete current image	Delete	–
Undo last delete	U	–
Vim-style Modes
Enter command mode (:)	:	–
Enter filename search mode (/)	/	–
Exit command/search (Escape)	Esc	–
Quit & Misc
Quit application	Q	–

License

AGPLv3 (see LICENSE)

Under the AGPLv3, any modified version or derivative work that is used, especially in a networked or distributed environment—by a school, company, or other organization—must also be licensed under the AGPLv3, with its source code made available to users.