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.

1. Fork the project.

2. Create your Feature Branch (git checkout -b feature/AmazingFeature).

3. Commit your changes (git commit -m 'Add some AmazingFeature').

4. Push to the branch (git push origin feature/AmazingFeature).

5. Open a Pull Request.