EBook on Producthunt daily

BookLore

Mon, 30 Jun 2025 15:32:16 +0800

adityachandelgit/BookLore

BookLore

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.

✨ Key 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. Stay tuned for updates!

🎥 Video Guides & Tutorials

For a step-by-step walkthrough, check out the official BookLore video guides on YouTube:

📺 BookLore Tutorials – YouTube

These videos cover deployment, configuration, and feature highlights to help you get started quickly.

🐳 Deploy with Docker

You can quickly set up and run BookLore using Docker.

1️⃣ Install Docker & Docker Compose

Ensure you have Docker and Docker Compose installed.

2️⃣ Create docker-compose.yml

Create a docker-compose.yml file with content:

services:
  booklore:
    image: ghcr.io/adityachandelgit/booklore-app:latest
    container_name: booklore
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
      - DATABASE_URL=jdbc:mariadb://mariadb:3306/booklore # Only modify this if you're familiar with JDBC and your database setup
      - DATABASE_USERNAME=booklore # Must match MYSQL_USER defined in the mariadb container
      - DATABASE_PASSWORD=your_secure_password # Use a strong password; must match MYSQL_PASSWORD defined in the mariadb container 
      - SWAGGER_ENABLED=false # Enable or disable Swagger UI (API docs). Set to 'true' to allow access; 'false' to block access (recommended for production).
    depends_on:
      mariadb:
        condition: service_healthy
    ports:
      - "6060:6060"
    volumes:
      - /your/local/path/to/booklore/data:/app/data
      - /your/local/path/to/booklore/books:/books
    restart: unless-stopped

  mariadb:
    image: lscr.io/linuxserver/mariadb:11.4.5
    container_name: mariadb
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
      - MYSQL_ROOT_PASSWORD=super_secure_password # Use a strong password for the database's root user, should be different from MYSQL_PASSWORD
      - MYSQL_DATABASE=booklore
      - MYSQL_USER=booklore # Must match DATABASE_USERNAME defined in the booklore container
      - MYSQL_PASSWORD=your_secure_password # Use a strong password; must match DATABASE_PASSWORD defined in the booklore container
    volumes:
      - /your/local/path/to/mariadb/config:/config
    restart: unless-stopped
    healthcheck:
      test: ["CMD", "mariadb-admin", "ping", "-h", "localhost"]
      interval: 5s
      timeout: 5s
      retries: 10

Note: You can find the latest BookLore image tag BOOKLORE_IMAGE_TAG (e.g. v.0.x.x) from the Releases section: 📦 Latest Image Tag – GitHub Releases

3️⃣ Start the Containers

Run the following command to start the services:

`1`	`docker compose up -d`

4️⃣ Access BookLore

Once the containers are up, access BookLore in your browser at:

`1`	`http://localhost:6060`

🔑 OIDC/OAuth2 Authentication (Authentik, Pocket ID, etc.)

BookLore supports optional OIDC/OAuth2 authentication for secure access. This feature allows you to integrate external authentication providers for a seamless login experience.

While the integration has been tested with Authentik and Pocket ID, it should work with other OIDC providers like Authelia as well. The setup allows you to use either JWT-based local authentication or external providers, giving users the flexibility to choose their preferred method.

For detailed instructions on setting up OIDC authentication:

🔐 Remote Authentication (Trusted Header SSO, Forward Auth)

If you run BookLore behind a reverse proxy with remote authentication (middleware), you can enable automatic login by setting REMOTE_AUTH_ENABLED to true.

This allows you to use your existing authentication system (e.g., OAuth, SAML) to log in to BookLore.

The following remote auth environment variables can be configured:

Variable Name	Description	Default Value
REMOTE_AUTH_ENABLED	Enable remote authentication	`false`
REMOTE_AUTH_CREATE_NEW_USERS	Auto-create users from remote auth	`true`
REMOTE_AUTH_HEADER_NAME	HTTP header containing user’s name	`Remote-Name`
REMOTE_AUTH_HEADER_USER	HTTP header containing username	`Remote-User`
REMOTE_AUTH_HEADER_EMAIL	HTTP header containing user’s email	`Remote-Email`
REMOTE_AUTH_HEADER_GROUPS	HTTP header containing user’s groups	`Remote-Groups`
REMOTE_AUTH_ADMIN_GROUP	Group name that grants admin privileges	-

Example implementations:

🤝 Community & Support

🐞 Found a bug? Open an issue
✨ Want to contribute? Check out CONTRIBUTING.md
💬 Ask questions or share feedback: Discussions
💬 Join our Discord: Click here to chat with the community

👨‍💻 Contributors & Developers

Thanks to all the amazing people who contribute to Booklore.

⭐ Star History

💖 Support the Project

If you find BookLore helpful, consider ⭐ starring the repo!

Or support the project via Venmo:

🧰 Tech Stack

⚖️ License

GNU GPL v3
Copyright 2024-2025

tchMaterial-parser

Sun, 18 May 2025 15:26:34 +0800

happycola233/tchMaterial-parser

国家中小学智慧教育平台电子课本下载工具

[!TIP] 🚀最新版本 v3.0 现已发布，欢迎体验！

本工具可以帮助您从国家中小学智慧教育平台获取电子课本的 PDF 文件网址并进行下载，让您更方便地获取课本内容。

[!NOTE]

自2025 年 2 月起，国家中小学智慧教育平台需要登录才能访问电子课本资源，用户需提供 Access Token（即登录凭据）才可正常使用本工具的下载功能。

👉请先按照下方指南设置 Access Token，否则程序将无法解析资源！

✨工具特点

支持 Access Token 登录🔑：支持用户手动输入 Access Token，在 Windows 操作系统下会存入注册表，下次启动可自动加载。
支持批量下载📚：一次输入多个电子课本预览页面网址，即可批量下载 PDF 课本文件。
自动文件命名📂：程序会自动使用教材名称作为文件名，方便管理下载的课本文件。
高 DPI 适配🖥️：优化 UI 以适配高分辨率屏幕，避免界面模糊问题。
下载进度可视化📊：实时显示下载进度，支持暂停/恢复操作。
跨平台支持💻：支持 Windows、Linux、macOS 等操作系统（需要图形界面）。

⬇️下载与安装方法

GitHub Releases 页面

由于我们的精力有限，本项目的 GitHub Releases 页面仅会发布适用于 Windows 与 Linux 操作系统的 x64 架构的程序。

在下载完成之后，即可运行本程序，不需要额外的安装步骤。

Arch 用户软件仓库（AUR）

对于 Arch Linux 操作系统，本程序已发布至Arch 用户软件仓库，因此您还可以通过在终端中输入以下命令安装：

`1`	`yay -S tchmaterial-parser`

感谢 @iamzhz 制作了本工具的发行包（#26）！

🛠️使用方法

1. 输入教材链接📥

将电子课本的预览页面网址粘贴到程序文本框中，支持多个 URL（每行一个）。

示例网址：

`1`	`https://basic.smartedu.cn/tchMaterial/detail?contentType=assets_document&contentId=XXXXXX&catalogType=tchMaterial&subCatalog=tchMaterial`

2. 设置 Access Token🔑

若您第一次使用本程序，需点击 “设置 Token” 按钮，粘贴 Access Token 并保存。

打开浏览器，访问国家中小学智慧教育平台并登录账号。
按下 F12 或 Ctrl+Shift+I，或右键——检查（审查元素）打开开发者工具，选择控制台（Console）。

在控制台粘贴以下代码后回车（Enter）：

(function() {
  const authKey = Object.keys(localStorage).find(key => key.startsWith("ND_UC_AUTH"));
  if (!authKey) {
    console.error("未找到 Access Token，请确保已登录！");
    return;
  }
  const tokenData = JSON.parse(localStorage.getItem(authKey));
  const accessToken = JSON.parse(tokenData.value).access_token;
  console.log("%cAccess Token: ", "color: green; font-weight: bold", accessToken);
})();

复制控制台输出的 Access Token，然后在本程序中点击 “设置 Token” 按钮，粘贴并保存 Token。

[!NOTE] Access Token 可能会过期，若下载失败提示 401 Unauthorized，请重新获取并设置新的 Token。

3. 开始下载🚀

点击 “下载” 按钮，程序将自动解析并下载 PDF 课本。

本工具支持批量下载，所有 PDF 文件会自动按课本名称命名并保存在选定目录中。

❓常见问题

1. 为什么下载失败？⚠️

检查是否已正确设置 Access Token🔑，且没有过期。
确认网络连接是否正常🌐，有时网络不稳定可能导致下载失败。
确保输入的网址有效🔗，部分旧资源可能已被移除。

2. Access Token 保存在哪里？💾

Windows 操作系统：Token 会存储在注册表 HKEY_CURRENT_USER\Software\tchMaterial-parser 项中的 AccessToken 值。
Linux 操作系统: Token 会存储在 ~/.config/tchMaterial-parser/data.json 的文件中。
macOS 等操作系统：Token 仅在运行时临时存储于内存，不会自动保存，程序重启后需重新输入，目前我们正在努力改进该功能。

3. Token 会不会泄露？🔐

本程序不会上传 Token，也不会存储在云端，仅用于本地请求授权。
请勿在公开场合分享 Token，以免您的账号被他人使用，造成严重后果。

⭐Star History

🤝贡献指南

如果您发现 Bug 或有改进建议，欢迎提交 Issue 或 Pull Request，让我们一起完善本工具！

📜许可证

本项目基于 MIT 许可证，欢迎自由使用和二次开发。

💌友情链接

📚您也可以在 ChinaTextbook 项目中下载归档的教材 PDF。

EBook on Producthunt daily

BookLore

adityachandelgit/BookLore

BookLore

✨ Key Features

🎥 Video Guides & Tutorials

🐳 Deploy with Docker

1️⃣ Install Docker & Docker Compose

2️⃣ Create docker-compose.yml

3️⃣ Start the Containers

4️⃣ Access BookLore

🔑 OIDC/OAuth2 Authentication (Authentik, Pocket ID, etc.)

🔐 Remote Authentication (Trusted Header SSO, Forward Auth)

🤝 Community & Support

👨‍💻 Contributors & Developers

⭐ Star History

💖 Support the Project

🧰 Tech Stack

⚖️ License

tchMaterial-parser

happycola233/tchMaterial-parser

国家中小学智慧教育平台 电子课本下载工具

✨工具特点

⬇️下载与安装方法

GitHub Releases 页面

Arch 用户软件仓库（AUR）

🛠️使用方法

1. 输入教材链接📥

2. 设置 Access Token🔑

3. 开始下载🚀

❓常见问题

1. 为什么下载失败？⚠️

2. Access Token 保存在哪里？💾

3. Token 会不会泄露？🔐

⭐Star History

🤝贡献指南

📜许可证

💌友情链接

国家中小学智慧教育平台电子课本下载工具