Blombooru v1.40.0-rc.1

Warning

This is a pre-release version intended for testing before the official 1.40.0 release. You may encounter bugs. Please report any issues you find! To use it, simply change BLOMBOORU_TAG=latest to BLOMBOORU_TAG=pre in .env.

Note

The Russian and Chinese (Simplified) translations are not up to speed in this release.

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:

Download docker-compose.yml and example.env from the release assets below.
(Optional) If you intend to use a shared tag database across multiple instances, also download docker-compose.shared-tags.yml.
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 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: Add persistent settings and tag blacklisting capabilities to the AI tagger & Move said settings to Admin Panel (for #71, #72)
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)
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)
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
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
docs: Update internal API documentation and add last updated dates to all docs

Full Changelog: v1.39.0...v1.40.0-rc.1

Credits & Acknowledgements

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

@cobaltcobaltcobalt for suggesting features.
@gary-host-laptop for suggesting features.
@br33zy59 for reporting bugs.
@PureDragon666 for reporting a bug.

New Contributors

Contributors who has had their first pull request merged:

mrblomblo/blombooru v1.40.0-rc.1 on GitHub