BagheeraView

BagheeraView is an image viewer specifically designed for the KDE ecosystem. Built with Python and PySide6, it leverages Baloo to deliver a powerful, agile, and fluid metadata-based image management experience without abandoning classic folder management.

🚀 Key Features

Enhanced Baloo Search: Blazing fast image retrieval using the KDE Baloo indexing framework, featuring advanced capabilities not natively available in Baloo, such as folder recursive search and results text exclusion.
Versatile Thumbnail Grid: A fluid and responsive browser for large collections, offering both Flat View, Date View and Folder View modes.
Face Detection: Integrated computer vision to detect faces within your photos and assign person names.
Metadata: A basic viewer for EXIF, IPTC, and XMP data.
Tagging & Rating & Comments System: Effortlessly manage tags, ratings and comments that integrate directly with your filesystem's extended attributes.
Smart State Persistence: The application remembers your workflow. Your last used sort order and view settings are automatically saved and restored upon startup.

🛠 Technical Stack

Language: Python 3
GUI Framework: PySide6 (Qt for Python)
KDE Integration: Baloo search and management
Metadata Handling: Advanced image header manipulation to store faces and support to file extended attributes

🌐 Internationalization (i18n)

BagheeraView is designed for a global audience with localized interface support. Initial supported languages include:

English (Base development language)
Galician
Spanish

Note: Following internal configuration standards, all source code labels and developer logs are maintained in English for technical consistency.

⚙️ Configuration & Persistence

BagheeraView is built for workflow continuity. The application stores the user's environment state in the local configuration:

Restore Last Layout: Last layout and preferences are automatically saved and restored every time you launch it.
Keyboard configuration: All hotkeys can be parametriced by the user.
Interface Language: The application automatically detects the system locale and applies the corresponding translation on startup or user can decide main language.

📥 Installation (Development)

Ensure you have the necessary PySide6 dependencies and KDE development headers for Baloo installed on your system.

Bash

# Clone the repository
git clone https://github.com/youruser/BagheeraView.git
cd BagheeraView

# Install dependencies
pip install -r requirements.txt

# Run the application
python main.py

🤝 Contributing

We follow an English-first policy for the codebase and documentation.

Fork the project.
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.

3.1 KiB Raw Blame History