Blombooru v1.41.0-rc.2

Blombooru is a private, self-hosted media tagging tool designed as an alternative to image boorus for managing personal media collections.

Key Features

• Danbooru-Style Tagging: Includes a tagging system with categories (artist, character, copyright, meta, general), parent-child media relationships, albums, and full support for Danbooru-compatible search syntax.
• AI Integration: Support for viewing AI metadata from tools such as SwarmUI, ComfyUI, and A1111. Includes integration with the WDv3 Auto Tagger for automated tag suggestions.
• External Booru Import: Allows importing media directly from supported boorus (e.g., Danbooru, Gelbooru) via URL. Metadata such as tags, rating, and sources are automatically mapped and imported.
• API Compatibility: Implements a Danbooru v2 compatible API. This allows you to connect third-party Booru clients (such as Grabber, Tachiyomi, or BooruNav) to your Blombooru instance.
• Security & Access Control: Management actions (uploading, editing, deleting) require an admin login. A Secure Mode can also be enabled to require login to interact with Blombooru (including to view media), while still allowing access to shared media.
• Customizable Interface: Built with Tailwind CSS for responsiveness. Includes built-in themes (Catppuccin variants, Gruvbox, Nord, Everforest, OLED) and supports adding custom CSS themes.
• System Architecture: Built on Python (FastAPI) and PostgreSQL 17. Optional Redis caching is available for faster autocomplete and queries. Supports multi-instance setups and shared tag databases.

Installation Instructions

Docker is the recommended installation method. To deploy Blombooru using Docker:

1. Download docker-compose.yml and example.env from the release assets below.
2. (Optional) If you intend to use a shared tag database across multiple instances, also download docker-compose.shared-tags.yml.
3. Follow the Installation instructions in the README to complete the setup.

What's Changed

• feat: Add a new "Default Light" light theme
• feat: Add changelog modal shown after updates
• feat: Add more granular control over API keys (for #88)
• feat: Add more search query options
• feat: Add password reset script
• feat: Add "related tags" section to the tag editor in the media page (for #125)
• feat: Add support for many more media formats
• feat: Allow blacklisting entire tag categories for AI tagger
• feat: Allow downloading and removing AI tagger models via Admin Panel
• feat: Allow re-linking media (for #113)
• feat: Allow setting category weights for TF-IDF similarity index
• feat: Allow showing both rating filter buttons and custom filter buttons
• feat: Allow using any rating/custom filter buttons at one time
• feat: Combine direct web fetch with booru importer
• feat: Completely remake and improve the media uploader
• feat: Improve "From Device" Post Update modal
• feat: Improve "From URL" Post Update modal
• feat: Improve several sections' looks in the Admin Panel
• feat: Improve tags tooltip in gallery
• feat: Remove second confirm modal from bulk apply implications and alias buttons
• feat: Reorganize parts of the Admin Panel
• feat: Show more detailed info when downloading AI tagger models
• feat: Show search results live in tag and album searcher
• feat: Significantly improve accuracy of tag suggestion algorithm
• feat: Stream AI tagger results
• fix: Actually cancel AI tagger model download when Cancel button is pressed
• fix: Actually cancel tag predictor when Cancel button is pressed
• fix: Add missing strings to Swedish i18n keys
• fix: Do not allow aliases to also exist as tags under any circumstances
• fix: Do not do hover effect on non-interactible tags
• fix: Filter "I'm Feeling Lucky" and Related Media results more accurately
• fix: Fix broken loading spinner in a few places
• fix: Fix custom BG setting not being disableable
• fix: Fix GPU acceleration not working in Docker
• fix: Fix issue where a few modals' buttons don't respond to inputs
• fix: Improve tertiary text contrast in Default Dark theme
• fix: Initialize Wenmode at module scope
• fix: Make TF-IDF tag similarity index rebuild more responsive (for #123)
• fix: Move some hardcoded strings to the i18n system
• fix: Only select visible media when double-clicking "Select All" button
• fix: Persist AI tagger model in Docker-hosted instances
• fix: Prevent duplicate tag implications in backend by @j-penrose in #127 (for #126)
• fix: Prevent duplicate tag implications in frontend (for #105)
• fix: Significantly improve search parser
• fix: Sync fresh DB build structure with migrated DB structure (for #129)
• fix: Unify styling deviations
• fix: Update instance name and theme on-the-fly without requiring a page reload
• fix, perf: Significantly improve handling of large tag implication sets (for #129)
• fix, perf: Significantly optimize bulk modals
• refac: Add registry for supported file types
• refac: Move all SVG icons into proper icons system
• refac: Store AI tagger model in /data folder
• chore: Upgrade wenmode by @lepture in #131
• docs: Add Changelog file
• docs: Update internal API docs
• docs, ui: upd ru locale & readme by @cobaltcobaltcobalt in #128

Full Changelog: v1.41.0-rc.1...v1.41.0-rc.2

Credits & Acknowledgements

Thank you to the following contributors and community members for their help in improving Blombooru:

• @cobaltcobaltcobalt for maintaining the Russian translation.
• @j-penrose for PRing a bug fix, reporting bugs, and suggesting a feature.
• @lepture for PRing an update and fix to the implementation of Wenmode, and for creating Wenmode.
• @grognakmedia for reporting a bug and allowing me to use ideas from their fork.
• @softnsleepi for reporting a bug

New Contributors

Contributors who have had their first pull request merged:

• @j-penrose made their first contribution in #127
• @lepture made their first contribution in #131