# Lissen - Clean Audiobookshelf Player
[![Build Lissen App](https://github.com/GrakovNe/lissen-android/actions/workflows/build_app.yml/badge.svg)](https://github.com/GrakovNe/lissen-android/actions/workflows/build_app.yml)

<p align="center"> 
  <a href="https://play.google.com/store/apps/details?id=org.grakovne.lissen"><img src="https://upload.wikimedia.org/wikipedia/commons/7/78/Google_Play_Store_badge_EN.svg" alt="Get it on Google Play" height="60"></a>&nbsp;&nbsp;&nbsp;<!--
  --><a href="https://f-droid.org/packages/org.grakovne.lissen"><img src="https://upload.wikimedia.org/wikipedia/commons/a/a3/Get_it_on_F-Droid_%28material_design%29.svg" alt="Get it on F-Droid" height="60"></a>
</p>

### Features

  * Beautiful Interface: Intuitive design that makes browsing and listening to your audiobooks easy and enjoyable.
  * Cloud Sync: Automatically syncs your audiobook progress across devices, keeping everything up to date no matter where you are.
  * Streaming Support: Stream your audiobooks directly from the cloud without needing to download them first.
  * Offline Listening: Download audiobooks to listen offline, ideal for those who want to access their collection without an internet connection.

### Screenshots

<p align="center">
  <img src="https://github.com/GrakovNe/lissen-android/raw/main/metadata/en-US/images/phoneScreenshots/2.png" alt="Screenshot 2" width="160">
  <img src="https://github.com/GrakovNe/lissen-android/raw/main/metadata/en-US/images/phoneScreenshots/3.png" alt="Screenshot 3" width="160">
  <img src="https://github.com/GrakovNe/lissen-android/raw/main/metadata/en-US/images/phoneScreenshots/4.png" alt="Screenshot 4" width="160">
  <img src="https://github.com/GrakovNe/lissen-android/raw/main/metadata/en-US/images/phoneScreenshots/5.png" alt="Screenshot 5" width="160">
  <img src="https://github.com/GrakovNe/lissen-android/raw/main/metadata/en-US/images/phoneScreenshots/6.png" alt="Screenshot 6" width="160">
</p>

### Disclaimer

Lissen is not a clone of the official Audiobookshelf app and does not aim to replicate all of its features. 
The goal of this project is to provide a minimalistic interface and a seamless experience for listening to audiobooks and podcasts.

If there’s a feature you feel is missing or would significantly improve your experience, feel free to open an issue and share your suggestion. 
While not every feature request will be implemented, all ideas are welcome and will be thoughtfully considered.

### Building

1. Clone the repository:
```
git clone https://github.com/grakovne/lissen.git
```

2. Setup the SDK into your local.properties file
```
nano local.properties
```

3. Open the project in Android Studio or build it manually
```
./gradlew assembleDebug # Debug Build
./gradlew assembleRelease # Release Build
```
5. Build and run the app on an Android device or emulator.

### Localization

Help us translate Lissen into more languages! We use [Weblate](https://hosted.weblate.org/engage/lissen/) to manage translations.

Current localization status:

<a href="https://hosted.weblate.org/engage/lissen/">
<img src="https://hosted.weblate.org/widget/lissen/android-app/multi-auto.svg" alt="Translation status" />
</a>

To contribute:
1. Visit the [Lissen translation project](https://hosted.weblate.org/engage/lissen/).
2. Sign up or log in to Weblate.
3. Start translating or reviewing existing translations for your preferred language.

### AI-Assisted Contributions

AI-assisted development is welcome in this project and can be very useful when applied thoughtfully.

However, any AI-generated changes that are not properly reviewed or tested will be discarded without hesitation.

AI is a great tool, but until it can reliably understand the code it produces and the consequences of its changes, all AI-generated contributions must remain under strict human review.

### Demo Environment

You can connect to a demo [Audiobookshelf](https://github.com/advplyr/audiobookshelf) instance through the Lissen app:

URL: [https://demo.lissenapp.org/](https://demo.lissenapp.org/)
```
Username: demo
Password: demo
```

This instance is contains only Public Domain audiobooks from [LibriVox](https://librivox.org/)

## License
Lissen is open-source and licensed under the MIT License. See the LICENSE file for more details.