✨ hub: Add booklore

Author: arnaud

hub/booklore/.env

@@ -0,0 +1,23 @@
+PROJECT=booklore
+DOMAIN=stack.localhost
+
+# User and Timezone Settings
+# PUID and PGID define the user/group running the container.
+# TZ sets the timezone for correct time-related operations.
+PUID=1000      # Default user ID (Check with `id -u` on Linux/Mac)
+PGID=1000      # Default group ID (Check with `id -g` on Linux/Mac)
+TZ=Etc/UTC     # Change this to your timezone (e.g., America/New_York, Asia/Kolkata)
+
+# Database Credentials (Replace with a secure password)
+# This password is used by MariaDB. Make sure to keep it secure.
+MYSQL_ROOT_PASSWORD=super_secure_password
+MYSQL_DATABASE=booklore
+MYSQL_USER=booklore
+MYSQL_PASSWORD=your_secure_password
+
+# Paths for Docker Volumes (Update these paths as per your system)
+# These paths store persistent data for Booklore and MariaDB.
+# Replace "/path/to/..." with actual directories on your system.
+# BOOKLORE_DATA_PATH=/path/to/booklore/data       # Example: /home/user/booklore/data (Stores app-related data)
+# BOOKLORE_BOOKS_PATH=/path/to/booklore/books     # Example: /home/user/booklore/books (Stores book files)
+# MARIADB_CONFIG_PATH=/path/to/mariadb/config     # Example: /home/user/booklore/mariadb/config (Stores database config)

hub/booklore/compose.yaml

@@ -0,0 +1,40 @@
+# SPDX-License-Identifier: MIT
+# This is a https://stack.lol docker compose file.
+
+services:
+  booklore:
+    image: ghcr.io/adityachandelgit/booklore-app:v${BOOKLORE_VERSION:-0.9.0}
+    env_file: .env
+    environment:
+      - DATABASE_URL=jdbc:mariadb://mariadb:3306/${MYSQL_DATABASE}
+      - DATABASE_USERNAME=${MYSQL_USER}
+      - DATABASE_PASSWORD=${MYSQL_PASSWORD}
+    depends_on:
+      mariadb:
+        condition: service_healthy
+    volumes:
+      - ${BOOKLORE_DATA_PATH:-booklore_data}:/app/data
+      - ${BOOKLORE_BOOKS_PATH:-books}:/books
+    labels:
+      dash.url: https://$PROJECT.$DOMAIN
+      traefik.http.routers.booklore.rule: Host(`$PROJECT.$DOMAIN`)
+      traefik.http.services.booklore.loadbalancer.server.port: 6060
+
+  mariadb:
+    image: linuxserver/mariadb:11.4.5
+    container_name: booklore_mariadb
+    env_file:
+      - .env
+    volumes:
+      - ${MARIADB_CONFIG_PATH:-mariadb_config}:/config
+    restart: unless-stopped
+    healthcheck:
+      test: ["CMD", "mariadb-admin", "ping", "-h", "localhost"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+
+volumes:
+  booklore_data:
+  mariadb_config:
+  books:

hub/booklore/stack.yaml

@@ -0,0 +1,35 @@
+# SPDX-License-Identifier: MIT
+# yaml-language-server: $schema=https://stack.lol/schemas/stack.config.schema.yaml
+# This is a https://stack.lol stack metadata file.
+slug: booklore
+name: BookLore
+icon: Ⓑ
+flavor: DockerCompose
+version: "0.9.0"
+updated_at: 2025-05-17
+description: Hosting, manage, and explore books
+author: Aditya Chandel
+license: GPL-3.0
+repository: https://github.com/adityachandelgit/BookLore
+stars: 684
+tags: []
+alternativeTo: []
+readme: |
+
+  BookLore is a self-hosted web app for organizing and managing your personal book collection. It provides an intuitive interface to browse, read, and track your progress across PDFs and eBooks. With robust metadata management, multi-user support, and a sleek, modern UI, BookLore makes it easy to build and explore your personal library.
+
+  ![preview](https://github.com/adityachandelgit/BookLore/raw/develop/assets/demo.gif)
+
+  <hr>
+
+  ### Features
+
+  - 📚 **Organized Book Management** - Categorize books with **Libraries** and **Shelves** for easy discovery and structured organization.
+  - 🧠 **Smart Metadata Handling** - Automatically fetch book details from **Goodreads**, **Amazon**, and **Google Books**, or edit them manually with fine-grained control.
+  - 👥 **Multi-User Support** - Admins can create accounts, assign libraries, and manage permissions for metadata edits, uploads, and downloads.
+  - 📖 **Built-in PDF & ePub Reader** - A fast, feature-rich reader for PDFs and ePubs, with customizable reading settings and a clean UI.
+  - 🌐 **OPDS 1.2 Support** - Browse and download books through the **Open Publication Distribution System** – compatible with many reading apps.
+  - 🔐 **Optional OIDC Authentication** - Secure access with **OpenID Connect**, supporting both local JWT authentication and external providers like **Authentik**.
+  - 📤 **Multi-Book Uploads** - Upload multiple books at once with metadata auto-detection and file organization.
+  - 📧 **Send Books via Email** - Share books directly with others by sending them via email – quick and easy.
+  - 🚀 **Continuous Improvements** - Frequent updates with new features, performance enhancements, and UI improvements. BookLore is perfect for self-hosters who want complete control over their digital library.