Blombooru v1.41.0-rc.1

Warning

This is an early pre-release version intended for testing before the official 1.41.0 release and is not representative of what the official 1.41.0 release will be like. 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

Blombooru now has an official Discord server! Feel free to join: https://discord.gg/ywpaZh4tHx

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 random and tag count sorting options by @br33zy59 in #94
feat: Add bulk tag alias and implication apply buttons (for #109)
feat: Add a basic tag gallery by @softnsleepi in #102
feat: Add post navigation buttons (Prev/Next) (for #86)
feat: Add tag merging
feat: Add tag alias management (for #110)
feat: Add keyboard shortcuts to media fullscreen viewer, post navigation, and gallery navigation
feat: Add customizable keybindings for keyboard shortcuts
feat: Add keybinding cheatsheet to help modal
feat: Add GPU-accelerated (CUDA) AI tagging (for #91)
feat: Add "Back to Album" button
feat: Add direct web fetching as a media upload option by @br33zy59 in #96
feat: Apply tag aliases and implications on automated tagging operations (for #108)
feat: Deduplicate tags on automated tagging operations
feat: Fade-in media items as they load in the gallery
feat: Improve sorting options UI by @br33zy59 in #94
feat: Only display related media from the album when viewing media from an album
feat: Respect album context for media hierarchy items
feat: Reorganize parts of the Admin Panel
feat: Use a better algorithm for near-instant and significantly more accurate related post suggestions
feat: Track which album media is viewed from
feat: Unload AI tagging model after one minute of not being used
fix: Fix unresponsive chevron in media hierarchy dropdown
fix: Small styling inconsistencies throughout
fix: Add descriptions to backup archives by @grognakmedia in #104
fix: Remove cap on the commit list in the updater
fix: Fix backup not working at all (for #103, #106)
fix: Move a few more hardcoded strings to the i18n system
fix: Fix full backup not actually fully backing up your instance
fix: Do not close media picker modal on outside click
fix: Display days with zero uploads in the stats page
fix: Fix media upload button status not resetting
fix: Use media loading skeleton in more places
fix: Validate selected custom sidebar filter button
fix: Increase rate limiter threshold (for #116)
fix: Remove chunked downloading for one-shot download requests by @br33zy59 in #115 (for #114)
fix: Reduce unnecessary network requests when using the AI tag predictor
fix: Disable default browser autocomplete in the search bar by @grognakmedia in #119
refac: Add comprehensive test suite for the backup system and post similarity service
refac: Unify clientside rating filter storage locations to be cookie-based
security: Add noreferrer policy to all links linking to the GH repo
docs: Update internal API documentation
docs: Remove outdated CSV tag list from suggestions

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

Credits & Acknowledgements

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

@br33zy59 for making several code contributions and reporting a bug.
@grognakmedia for PRing bug fixes, reporting a bug, and allowing me to use ideas from their fork.
@softnsleepi for making the tag gallery.
@sanityy55 for suggesting a feature.
@cobaltcobaltcobalt for suggesting a feature.
@Pahvikapteeni for suggesting a feature.
@denylizer for reporting a bug.

New Contributors

Contributors who have had their first pull request merged:

@br33zy59 made their first contribution in #94
@grognakmedia made their first contribution in #104
@softnsleepi made their first contribution in #102

Navigation Menu

v1.41.0-rc.1

Choose a tag to compare

Sorry, something went wrong.