ShelfPlayer is a sleek and modern Audiobookshelf client, specifically designed for audiobooks, podcasts and iOS, as well as iPadOS. Due to its design, snappy interface and deep integration it feels right at home on any supported device.
Things to implement before i would consider ShelfPlayer feature complete:
Library | Audiobook | Player | Podcast |
---|---|---|---|
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
Pre built binaries
Grab the latest Release and install it using your favorite tool like SideStore.
Please not that the pre build binaries lack Siri and Widget support because these features either require a paid developer account or cannot be reliably implemented in a way that works with tools like SideStore. For further information see https://github.com/rasmuslos/ShelfPlayer/issues/20 & https://github.com/rasmuslos/ShelfPlayer/issues/4
Stripping app extensions is highly recommended, they will not work as intended.
Build the app yourself
Configuration
directory copy the Debug.xcconfig.template
file and rename it to Debug.xcconfig
DEVELOPMENT_TEAM
to your apple developer team id and BUNDLE_ID_PREFIX
to a prefix of your likingENABLE_ALL_FEATURES
compilation condition. Otherwise the app will crash. If you do not intent on developing the app also remove the DEBUG flag
Please not that the DEBUG
configuration is used by default for all builds except archiving and profiling. You have to edit Release.xcconfig
to update their parameters.
ShelfPlayer is licensed under the Mozilla Public License Version 2. Additionally the "Common Clause" applies. This means that you can modify ShelfPlayer, as well as contribute to it, but you are not allowed to distribute the application in binary form. Compiling for your own personal use is not covered by the commons clause and therefore fine. Additionally, prebuilt binaries are available on GitHub for side loading using popular tools like SideStore, etc.
Contributions are welcome, just fork the repository, and open a pull request with your changes. If you want to contribute translations you have to edit Localizable.xcstrings
in the iOS
directory, as well as Localizable.xcstrings
located at ShelfPlayerKit/Sources/SPBase/Resources
using Xcode. If you want to add a new language add it in the project settings
Please note that collections are not supported right now. ShelfPlayer is not endorsed by nor associated with Audiobookshelf