Powerful Features for Your Library

Everything you need to manage, organize, and enjoy your digital book collection.

📚 Comprehensive Format Support

Dust supports all major eBook and comic formats, making it the one-stop solution for your entire digital library.

  • eBooks: EPUB, PDF, MOBI, AZW3
  • Comics: CBR, CBZ
  • Automatic format detection and handling
  • Optimized streaming for large files

🔍 Intelligent Metadata Management

Never manually enter book information again. Dust automatically enriches your library with professional metadata.

  • ISBN-based metadata lookup (ISBN10 and ISBN13)
  • Integration with OpenLibrary and Google Books APIs
  • Automatic cover art download and management
  • Author information with biographies and images
  • Publication dates, publishers, and descriptions

📂 Smart File Organization

Dust automatically indexes your existing file structure without requiring reorganization.

  • Automatic directory scanning and monitoring
  • Configurable scan intervals (default: 5 minutes)
  • Support for multiple media directories
  • Handles books organized by author or by ISBN
  • Detects and archives missing files automatically

👥 Multi-User with Permissions

Perfect for households or shared libraries with granular access control.

  • Individual user accounts with secure JWT authentication
  • Role-based access control (Admin, Librarian, User, Guest)
  • Customizable permissions per user or role
  • Tag-based content filtering (e.g., NSFW restrictions)
  • Per-user reading progress and preferences

📊 Reading Progress Tracking

Never lose your place again with automatic progress sync across all your devices.

  • Track current page and completion percentage
  • View reading history and statistics
  • Currently reading vs. completed books
  • Reading streaks and activity tracking
  • Recently read books at a glance

🏷️ Flexible Tagging System

Organize your library your way with a powerful and extensible tagging system.

  • 60+ pre-configured tags across genres, formats, and content ratings
  • Custom categories: genre, format, content-rating, and more
  • Permission-required tags for content control
  • Filter books by multiple tags (include/exclude)
  • Color-coded tag visualization

🔌 RESTful API

Build your own clients and integrations with Dust's comprehensive REST API.

  • 50+ documented API endpoints
  • Complete authentication and authorization system
  • JSON responses for easy integration
  • WebSocket support planned for real-time updates
  • CORS-enabled for web applications

📦 Archive Management

Keep your library clean and organized with automatic archival features.

  • Automatic archival of books with missing files
  • Manual archive/unarchive capabilities
  • Archive statistics and reporting
  • Cleanup intervals (default: 60 minutes)
  • Preservation of metadata for archived items

🚀 Easy Deployment

Get your server running in minutes with minimal configuration required.

  • One-command installation script for Ubuntu/Debian
  • Docker support with docker-compose
  • Single binary deployment (no runtime dependencies except musl)
  • Bundled SQLite database (no separate database server needed)
  • Systemd service for automatic startup
  • Environment-based configuration

🔒 Security First

Your library is protected with industry-standard security practices.

  • JWT token authentication with HS256 signing
  • Bcrypt password hashing
  • Session management with configurable expiration
  • Permission checks at every endpoint
  • Secure environment variable configuration

Ready to Get Started?

Set up your own Dust server in just a few minutes.

Installation Guide API Documentation