github mrblomblo/blombooru v1.38.0

latest releases: v1.41.0-rc.1, v1.40.1, v1.40.0...
5 months ago

Blombooru v1.38.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

  • fix: Fix uploads failing when files are added to upload queue with file scanner
  • fix: Do not display potentially sensitive information in error messages unless in debug mode
  • refac: Media now also uploads in 99MB chunks when necessary
  • refac: Add GZip compression for HTTP responses over 1MB in size
  • feat: Add Chinese (Simplified) translation by @2455DD in #56
  • feat: Many security fixes and additions (regarding cookies, SQL, CORS, path traversal, etc.)
  • feat: Improved logging
  • docs: Add SECURITY.md

Full Changelog: v1.37.0...v1.38.0

Credits & Acknowledgements

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

New Contributors

Don't miss a new blombooru release

NewReleases is sending notifications on new releases.