Skip to content

ssethhyy/Chapter

Repository files navigation

Chapter Icon

📖 Chapter - Material 3 Expressive Audiobook Player

Chapter is a modern, elegant audiobook player for Android, built with Jetpack Compose and Material 3 Expressive. It focuses on a clean user experience, dynamic theming based on book artwork, and robust multi-file support.

🎨 Features

  • Dynamic Theming: The player's palette automatically adapts to the current book's artwork, creating an immersive listening experience.
  • Multi-File Support: Seamlessly plays audiobooks split across multiple files, treating them as a single cohesive unit with unified progress and chapter tracking.
  • Smart Persistence: Automatically saves your playback position and bookmarks to a Room database, resuming exactly where you left off.
  • Intuitive Gestures:
    • Play/Pause: Single tap to toggle, long-press to quickly change playback speed.
    • Sleep Timer: Single tap to set a custom timer, long-press to quickly add 15 minutes.
  • Library Management: Automatic scanning of local storage to find and organize your audiobooks.
  • Shared Transitions: Beautiful, fluid animations when navigating between the library and the player.
  • Customizable Typography: Tailored reading/listening experience with adjustable text styles.

📸 Screenshots

🏠 Home Screen

Screenshot of the Home Screen

🎶 Now Playing Pill - See what you're listening to in a modern Now Playing pill

Screenshot of the Now Playing Pill on the Home Screen

📘 Continue Reading - Continue where you left off

Screenshot of the Continue Reading Section on the Home Screen

📚 Library Screen - View all of your books in one place

Screenshot of the Library Screen

🎵 Now Playing Screen - See what you're listening to in a full-screen layout

Screenshot of the Now Playing Screen

🔖 Chapters - Find and skip to specific chapters in your book (only some books supported)

Screenshot of the Chapters Section on the Now Playing Screen

⚙️ Settings - Customize your experience with various options

Screenshot of the Settings Screen

🖌️ Material You vs Adaptive Colors - Choose for the app to adapt to your device's color scheme or adapt to the currently playing Audiobook

Screenshot of the Material You vs Adaptive Colors Section on the Now Playing Screen

🛠️ Built With

  • Jetpack Compose - Modern toolkit for building native UI.
  • Material 3 Expressive - The latest evolution of Material Design.
  • Media3 (ExoPlayer) - High-performance media playback engine.
  • Room - SQLite object mapping library for data persistence.
  • Coil - Image loading library for Android backed by Kotlin Coroutines.
  • Palette - Extracting prominent colors from images for dynamic theming.
  • Navigation Compose - Navigation component for Compose.

🚀 Getting Started

  1. Clone the repository.
  2. Open the project in Android Studio (Ladybug or newer recommended).
  3. Sync Gradle and run the app on an emulator or physical device.

✏️️ Contributing

Contribute to the project by forking the repository and creating a new branch with your own changes. If you would like to submit this, please create a pull request to the Chapter repository with a detailed description of your changes.

Help is much appreciated! ❤️

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

About

A Material 3 Expressive Audiobook Player for Android

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages