Skip to content

beecho01/Booklight

Repository files navigation

Contributors Forks Stargazers Issues MIT License


Booklight

Booklight

A native Windows desktop client for Audiobookshelf, built with Tauri v2, React 18, TypeScript, and Fluent UI.
Explore the docs »

Report Bug · Request Feature



Table of Contents
  1. About The Project
  2. Getting Started
  3. Usage
  4. Roadmap
  5. Contributing
  6. License
  7. Acknowledgments

About The Project

Booklight is a native Windows desktop client for Audiobookshelf - a self-hosted audiobook and podcast server. It provides a polished, Windows 11-native experience with Mica transparency effects, Fluent UI components, and seamless audio playback.

Key Features

  • 🎧 Audio Playback - HTML5 Audio with session sync, progress tracking, and chapter navigation
  • 📚 Library Browser - Grid view with cover art, progress badges, and zoom controls
  • 🔍 Filter & Search - Filter by genre, author, or narrator; search across your library
  • 🎨 Windows 11 Design - Mica effect, Fluent UI components, system accent color matching
  • 🌓 Theme Support - Light, Dark, and System themes with automatic accent color detection
  • ⏯️ Now Playing Bar - Frosted glass playback bar with chapter selector, volume, and speed controls
  • 📖 Audiobook Details - Rich detail modal with cover art, metadata, chapters, and description
  • 💾 Persistent Settings - Volume and playback speed saved across restarts

(back to top)

Built With

Tauri React TypeScript Fluent UI Rust

(back to top)

Getting Started

To get a local copy up and running, follow these steps.

Prerequisites

Installation

  1. Clone the repo
    git clone https://github.com/beecho01/Booklight.git
    cd Booklight
  2. Install frontend dependencies
    npm install
  3. Run in development mode
    npm run tauri dev
  4. Build for production
    npm run tauri build

(back to top)

Usage

  1. Connect to your server - Open Settings and enter your Audiobookshelf server URL
  2. Authenticate - Log in with your username/password or an API token
  3. Browse your library - View your audiobooks in a responsive grid with cover art
  4. Start listening - Click the play button on any book card to begin playback
  5. Control playback - Use the Now Playing bar for play/pause, skip, volume, and chapter navigation
  6. Filter your library - Use the filter menu to narrow by genre, author, or narrator
  7. View details - Click any book card to see full metadata, chapters, and description

(back to top)

Roadmap

  • Library browsing with grid view and zoom
  • Audio playback with session sync
  • Now Playing bar with chapter selector
  • Audiobook detail modal
  • Library filtering (genre, author, narrator)
  • System accent colour matching
  • Persistent volume and playback speed
  • Dark/Light/System theme support
  • Listening progress display with percentage rings
  • Continue playback from last position
  • Search functionality
  • Collections and playlists
  • Sync listening progress across devices
  • Podcast support
  • Mini-player (detached floating window)
  • Sleep timer
  • Bookmarks management

See the open issues for a full list of proposed features and known issues.

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

(back to top)

License

Distributed under the MIT License. See LICENSE for more information.

(back to top)

Acknowledgments

(back to top)

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages