Blombooru v1.41.0-rc.3

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. 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: Allow reordering albums (for #121)
feat: Allow reordering sub-albums and media in albums (for #121)
feat: Add manual sort mode to albums (for #121)
feat: Add support for JPEG-XL (for #140)
feat: Add support for PixAI Tagger v1.0 AI tagger model
feat: Add folder -> album mapping support to uploader (for #89)
feat: Add sidecar metadata and metadata extraction to uploader (for #89)
feat: Add support for uploading a text file list of links to import media from to uploader (for #107)
feat: Add range selection support to uploader
feat: Add multi-select support to albums and tags in pending entities panel in uploader
feat: Add a "Prune Albums" button by @highersky659 in #139
feat: Add metadata extraction support for more AI imagegen services
feat: Add setting for automatically extracting and parsing tags from AI metadata in uploader (for #132)
feat: Add album metrics recalculation button
feat: Add search query qualifier (e.g. id:) helper to tag search bars
feat: Add acknowledgements generator
feat: Replace "back to top" button with an acknowledgements button
feat: Improve styling, styling consistency, and compactness in various areas
feat: Improve uploader tag preview
feat: Improve uploader pending entities panel contents
feat: Improve multi-select in uploader
fix: Fix cancelling and aborting pending uploads to uploader queue
fix: Fix issue where bulk AI tagger modal does not work (for #137)
fix: Fix untracked media not working in uploader (for #134)
fix: Fix bad TF-IDF similarity index rebuild flag condition
fix: Fix media count so it displays the actual amount of visible media in an album due to applied filters
fix: Fix issues with viewport cutoff on mobile
fix: Hide albums that would be empty if opened due to applied filters
fix: Hide header while dragging to allow autoscrolling on upper and lower edges
fix: Do not allow media page keyboard shortcuts when a modal is open
fix: Normalize and deduplicate booru domains in booru credential config
perf: Significantly optimize external booru fetching by reusing HTTP sessions & connection pools
refac, perf: Significantly improve efficiency and speed of album handling
refac, perf: Common implication expansion code by @j-penrose in #136 (for #135)
refac: Add user ID to user agent for requests to Danbooru
refac: Add reusable album tree component
refac: Refactor AI imagegen service metadata extraction to be backend-only
refac: Refactor markdown parser to be proper and reusable
refac: Improve media cache handling
docs: Add acknowledgements file
docs: Add license files for TailwindCSS and Chart.JS
docs: Move search syntax guide modal content to docs
docs: Update the contributing docs

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

Credits & Acknowledgements

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

@IZA09 for suggesting features
@PureDragon666 for suggesting a feature
@leopoldious for suggesting a feature
@j-penrose for suggesting a feature, reporting bugs, and for making code contributions
@falchionenjoyer for reporting a bug

New Contributors

Contributors who have had their first pull request merged:

@j-penrose made their first contribution in #136
@highersky659 made their first contribution in #139

mrblomblo/blombooru v1.41.0-rc.3 on GitHub