Vito0912/abs_flutter

Buchable

[!IMPORTANT] I started working on Buchable 2, optimized for desktop, tablet, and mobile use. It will have a different design style than Buchable has now, but I did not find the design of Buchable appealing from the beginning. That is why I did not use it much, or at all, which caused the project to become stale. I have now built yaabsa [working title], which this time I built more with a design in mind I personally like. It is mainly a project for family and friends, but it is open source and free to use. It is currently in a very early development phase, with many views missing. iOS and macOS support will be added later, but other than for Buchable, will be added

STILL: Searching for a person that wants to do UI and UX for an "Buchable 2" which will this time be released for iOS free of charge without any PayWalls.
The basic structure for this app is already in place. If you are interested and motivated to help build a great abs app for all platforms with many features, please contact me at fito0912@duck.com.

Translation status

For Android, iOS*^1,2, macOS*^1,2, Windows, Linux, and Web*³

https://get.microsoft.com/images/en-us%20dark.svg Get it on Google Play

“Buch” (German for "book") + "able" = "Buchable"

Demo

To explore the app, you can either log in to your private server or use the official ABS demo server. The demo server is an nice way to experience the app, especially when testing the web version of Buchable.

Demo URL: https://audiobooks.dev/
Login Credentials:

• Username: demo
• Password: demo

Note: Demo user accounts are automatically deleted after 48 hours.

About

This is a third-party app for the Audiobookshelf server, designed to maintain a single codebase for multiple OS platforms.
The app is written in Dart and utilizes the Flutter framework.
While the current version may not include all the features of the first-party app, it is a work in progress with ongoing development.

*¹ iOS functionality requires additional work. Since I do not own a Mac, I cannot fully test it. However, I have only used libraries compatible with iOS.
*² The Audiobookshelf server must be accessible via SSL, so you need a domain with a valid SSL certificate.
*³ The web version requires the server to allow CORS.

Translation

For more details and to contribute, please refer to TRANSLATION.md.
All translations are managed through Weblate Hosted.

A big thank you to Weblate for providing their services!

Translation status

Preview

Download View

Platform Matrix

[!NOTE] iOS and macOS are supported in theory, but no builds are available!

Platform Matrix	Android	iOS	Windows	Linux	Web
Playing Audio	✅	✅	✅	✅	✅
Playing Podcasts	✅	✅	✅	✅	✅
Reading eBooks*5	🟨❌	🟨❌	🟨❌	🟨❌	🟨❌
Up-to-date Sync	✅	✅	✅	✅	✅
Advanced Player Controls*1	✅	✅	✅	✅	✅
Car Support*2	❌	❌	❌	❌	❌
Car Mode (Big Buttons for Car)	✅	✅	✅	✅	✅
No Extra Setup Needed	✅	❌*6	✅	✅	❌*3
Media Notifications	✅	✅	❌	✅	❌
Caching	✅	✅	✅	✅	✅
Offline Support	✅	✅	✅	✅	❌*5
Socket Support*5	❌	❌	❌	❌	❌

*¹ Chapter support, sleep timer, playback speed, custom skip time, and more
*² Android Auto and Apple CarPlay are not supported as standalone apps, but media controls are supported
*³ You need to allow CORS on the server so the web app can access it
*⁵ Very basic support included
*⁶ A secure SSL connection is needed.

iOS requires some additional setup to configure the necessary plugins. Unfortunately, I’m unable to test, build, or fix errors on iOS since I don’t have access to a Mac. However, I’ve only used packages and libraries that are compatible with Apple, so once the setup is complete, there shouldn't be any issues building the app for iOS.

As for Linux, the app hasn’t been tested on that platform yet.

Features

Currently worked on

🎙️ Widgets - Widgets!

Summary

🔀 Fast Account Switching - Switch between multiple Audiobookshelf accounts with different servers in just two clicks.
🚀 Advanced Caching - Caches items, libraries and more to save a ton of mobile data
📄 Pagination - Load more items when you reach the end of lists to save data.
📈 Does Not Rely on a Socket - Use the app even with an occasionally interrupted connection.
📅 Up-to-date Sync - The app stays synchronized with the server when connected to the internet.
🔁 Queue Support - Add multiple items to the queue and play them in order. Even works offline.
🔊 Advanced Player Controls - Skip chapters, set a sleep timer, adjust playback speed, and more.
📴 Offline Support - Listen to your audiobooks even when you're offline. Sync offline up to one year
🔎 Fast Search - Search for audiobooks. Preserves query while switching library or user.
📖 History - Track where you paused, skipped, and resumed.
📊 Stats - View your listening habits over the past 365 days, including total time, frequency, and recent activity.
HTML Support - Converts HTML in descriptions and makes links clickable.
🚀 Fast Loading - Option to enable fast loading that loads even the biggest libraries in a fraction of time.
🚗 Car Player Mode (Big Buttons) - Big buttons for easy control while driving.
⚙️ Many Settings - Customize the app to your liking. Head to Settings to learn more.
Tray Icon - Control the app from the tray icon. (Desktops)\

Additional to First-party App

The features listed below have been requested for the first-party app.
If no specific platform is mentioned, the feature is available on all platforms.

🚀 Fast Account Switching
📅 Up-to-date Sync
🔁 Queue Support
HTML Support
🚀 Advanced Caching
🚗 Car Player Mode (Big Buttons)
Tray Icon

Missing from First-party App

The features listed below are available in the first-party app but are not yet included in this app.
The goal is to eventually include all first-party features.

🚗 Car Support - Currently limited to media controls.
📖 Reading eBooks

Attribution

The following attributions highlight contributions that were essential to this project.
For a complete list of libraries used, please refer to the pubspec.yaml file.
The libraries mentioned below had a particularly significant impact on the development of the app.

Library	License	Publisher	Repository
openapi_generator (flutter)	BSD-3-Clause	devappliance.com	GitHub
OpenAPI Generator	Apache-2.0	-	GitHub
Riverpod	MIT	dash-overflow.net	GitHub
Freezed	MIT	dash-overflow.net	GitHub

Thanks to everybody contributing to Audiobookshelf to make this software so awesome. Thanks to everybody who contributed to Audiobookshelf-App to make this software so awesome. Many features of this app are based on the first-party app.

Images

Guided Login

The login screen allows users to easily toggle between https:// and http://.

This ensures that you can enter your server address correctly and avoid any connection issues.

Guided Login Screen

Rich Player

The player interface is packed with features designed to enhance your listening experience.

It includes a history tracker so you can easily resume from where you left off, speed control to adjust playback to your preference, and volume control for a seamless audio experience.

Additionally, the chapter view allows you to navigate through your audiobook easily, and the sleep timer can be reset simply by shaking your device.

Rich Player Interface

Listen Offline!

With offline listening, you can enjoy your audiobooks even when you’re off the grid, whether traveling, commuting, or in an area with limited connectivity.

The app provides clear indicators of what has been downloaded and what remains to be synced, ensuring you never lose track of your progress.

Once connected to the internet, your offline progress will automatically sync with the server.

Download View Downloaded Files View Download Button

Rich Settings

The settings section offers a comprehensive range of customization options, allowing you to tailor the app to your specific needs.

From enabling dark mode to setting download preferences, you have full control over your listening experience.

Jump to Settings

Settings Screen

History

The history feature keeps a detailed log of your listening activities, including when you paused, skipped, or resumed playback.

This makes it easy to track your progress and revisit previous sections of your audiobooks.

Listening History

Item View

The item view screen provides details about each audiobook.

Here you can access the book's description, which supports clickable HTML links, allowing for easy navigation to related content.

You can also view important metadata such as the current position, overall progress, remaining time, and more.

Additionally, the item view allows you to filter content by author, narrator, or genre, helping you find related titles quickly.

Book Item View

Detailed Stats View

The stats view gives you a detailed breakdown of your listening over time.

You can track how much time you've spent listening each day, view your progress over the last seven or thirty days, and analyze your overall listening trends.

Listening Stats Additional Listening Stats

Logs

Logs

Known Bugs

Sleep Timer

• If you select the sleep timer to stop at the end of the chapter, it will stop at the actual time. Skipping the chapter will not adjust the timer.

Limitations

Filters and search

• The search cannot be combined with filters or sorting. This is a limitation of the Audiobookshelf API.
• The search is limited to 25 results, because there is no pagination available. This is a limitation of the Audiobookshelf API.

Contributing

See CONTRIBUTING.md for more information.

Please sort the keys in the en.json file (and other edited) alphabetically before submitting a pull request.
You can use the following command to sort the keys:

dart pub global activate arb_utils

arb_utils generate-meta .\lib\l10n\intl_en.arb

arb_utils sort .\lib\l10n\intl_en.arb

Or for an IDE that supports running code from a README, you can use the following Dart code:

arb_utils generate-meta .\lib\l10n\intl_en.arb
arb_utils sort .\lib\l10n\intl_en.arb