Blombooru v1.40.0

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 full support for custom CSS themes and a custom theme manager (for #69)
• feat: Allow user to set a custom background (for #68)
• feat: Allow user to more easily customize logo and instance title in header (for #85)
• feat: Allow user to set media relations through post IDs (for #66)
• feat: Add ability to edit and rename tags directly from the Admin Panel (for #65)
• feat: Add a new bulk rating editing modal to quickly change ratings for multiple items (for #73)
• feat: Make AI tagger settings persistent and tag blacklisting capabilities (for #72)
• feat: Move AI tagger settings to Admin Panel (for #71)
• feat: Add support for wildcard tag implications (for #75)
• feat: Add Popular Tags modes (show all related tags or only related tags from current page) (for #60)
• feat: Add new API endpoint for serving instance info (for #80)
• feat: Enable API key authentication for admin-only media endpoints (for #79)
• feat: Add a dedicated 404 page for non-existent pages, media, and albums (for #70)
• feat: Display loading indicator while fetching related media (for #76)
• feat: Add in-line on-the-fly tag creation (for #78)
• feat: Allow updating existing posts (for #67)
• feat: Sort media alphabetically in uploader
• feat: Fetch and assign artist commentary as description in booru importer
• fix: Stop Service Worker from intercepting media requests to fix loading issues with very large files
• fix: Fix the scanner skipping untracked media that shared the same name as tracked media
• fix: Fix Booru import not working as expected (for #83)
• fix: Fix incorrect logic in the rating filter
• fix: Fix bad fullscreen viewer handling for videos
• fix: Fix a memory leak in the modal close logic
• fix: Fix various minor UI styling issues (border colors, hover transitions, and paddings)
• fix: Assign proper page titles (the browser tab) to pages where previously missing
• fix: Make page titles (the browser tab) use i18n
• fix: Make auth behavior more consistent and predictable (for #87)
• fix: Display loading skeleton when loading preview image in booru importer
• perf: Migrate filesize to bigint to fully support extremely large files
• perf: Chunk media responses and guarantee chunk size caps to improve video streaming and performance
• perf: Hold database connections for shorter durations when serving media files
• perf: Increase media cache length from 1 day to 1 year
• perf: More than double the speed of media uploading (for #97)
• refac: Fully refactor the Admin Panel frontend into focused, modular components
• refac: Refactor relation manager modal into a reusable component for the UI
• refac: Stop sending referrer information to GitHub to improve instance privacy
• refac: Organize JS files
• refac: Update significantly out-of-date serviceworker
• security: Do not allow search engines to index instance if auth is required to view media
• security: Fix SSRF and redirect vulnerability in booru importer's image proxy endpoint (for CVE-2026-57448)
• docs: Update internal API documentation and add last updated dates to all docs
• docs: Update the security documentation
• i18n: Update Russian translation by @cobaltcobaltcobalt in #100

Full Changelog: v1.39.0...v1.40.0

Credits & Acknowledgements

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

• @cobaltcobaltcobalt for suggesting features, reporting bugs, and for maintaining the Russian translation.
• @gary-host-laptop for suggesting features.
• @br33zy59 for reporting bugs.
• @PureDragon666 for reporting bugs.
• @stackallocator for suggesting a feature.
• @beepboopnumbers for reporting a bug

New Contributors

Contributors who has had their first pull request merged: