README.md
# SagoImageBrowser
A Qt6-based image browser application for viewing and managing image collections.
## Features
- Browse images in a directory tree with file system navigation
- Multi-threaded, cached thumbnail generation for a responsive UI
- Single image view mode with keyboard-driven zoom, pan, fit and navigation
- Fullscreen viewing
- EXIF/IPTC metadata panel (camera, exposure, ISO, focal length, dimensions, …)
- Geo location with a clickable OpenStreetMap link when an image is geotagged
- Edit image captions (written to the IPTC Caption-Abstract tag)
- Lossless 90° rotation (updates the EXIF orientation tag, pixel data untouched)
- Move images to trash and delete files
- Right-click context menus (including copying file paths), also in fullscreen
- Configurable keyboard shortcuts
- Preferences for background color, thumbnail cache size, dock locking and layout
- Path entry field with autocomplete
- Translations (Danish included)
- Supports every image format provided by the installed Qt image plugins
## Requirements
- C++17 or later
- CMake 3.21+
- Qt6 (Widgets and LinguistTools components)
- Git and a network connection — Exiv2 (v0.28.8) is fetched and statically linked
at configure time via CMake `FetchContent`
## Building
### Prerequisites
Install Qt6 development files:
```bash
# On Ubuntu/Debian
sudo apt-get install qt6-base-dev qt6-tools-dev
# On macOS with Homebrew
brew install qt6
```
### Build Steps
```bash
cd SagoImageBrowser
cmake -B build
cmake --build build
```
The compiled executable will be at `./build/SagoImageBrowser`.
### Installing
```bash
cmake --install build
```
This installs the executable, a `.desktop` entry and the application icon.
## Running
```bash
./build/SagoImageBrowser [path]
```
An optional directory or image path can be passed on the command line.
## Tests
A small test for the EXIF reader is built alongside the application:
```bash
./build/test_exifreader
```
## Project Structure
```
src/
├── main.cpp # Application entry point
├── mainwindow.h/cpp # Main application window
├── imagemodel.h/cpp # Image list/grid data model
├── fsdirmodel.h/cpp # Directory tree model
├── imageviewwidget.h/cpp # Single-image display widget (zoom/pan)
├── thumbnailworker.h/cpp # Background thumbnail generation
├── thumbnailcache.h/cpp # Thumbnail caching
├── thumbnaildelegate.h/cpp # Thumbnail rendering in the view
├── exifreader.h/cpp # EXIF/IPTC reading, caption writing, rotation
├── preferencesdialog.h/cpp # Preferences dialog
├── shortcutmanager.h/cpp # Configurable keyboard shortcuts
└── pathcompletermodel.h/cpp # Autocomplete for the path field
test/ # Unit tests
translations/ # Qt translation files (.ts)
extra/ # Desktop entry and icons
CMakeLists.txt # Build configuration
```
## License
GPL 3.0 or later, see `LICENSE` file for details.
Some files might have more liberal licenses, see individual file headers for details.