https://github.com/LouisDuboscq/Jukebox

Android library that helps you focusing on your audio UI and manages independently media player under the hood
https://github.com/LouisDuboscq/Jukebox

android-library jetpack-compose mediaplayer

Last synced: 3 months ago
JSON representation

Android library that helps you focusing on your audio UI and manages independently media player under the hood

• Host: GitHub
• URL: https://github.com/LouisDuboscq/Jukebox
• Owner: LouisDuboscq
• Created: 2022-12-09T12:57:13.000Z (about 2 years ago)
• Default Branch: main
• Last Pushed: 2023-02-11T20:55:16.000Z (almost 2 years ago)
• Last Synced: 2024-08-01T19:39:43.404Z (6 months ago)
• Topics: android-library, jetpack-compose, mediaplayer
• Language: Kotlin
• Homepage:
• Size: 4.47 MB
• Stars: 57
• Watchers: 1
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• awesome-list - LouisDuboscq/Jukebox - Android library that helps you focusing on your audio UI and manages independently media player under the hood (Kotlin)

README

        
# What is Jukebox

A lighweight android library that helps you focusing on your audio UI and manages independently 

media player under the hood.

It’s built on top of jetpack compose and media player.

The focus is on flexibility to change loading, error and audio views.

# Setup

## Gradle dependencies

``` 

maven { url 'https://jitpack.io' }

```

```

implementation("com.github.LouisDuboscq:Jukebox:0.5")

```

# What can I do with Jukebox

## Launch the Jukebox composable with the minimal parameters and get ready to use slider and audio player.

![jukebox simple](assets/jukebox_simple.png)

![slider](assets/slider.png)

## Customize audio view : 

![jukebox custom](assets/jukebox_custom.png)

 

![circular and actions](assets/circular_and_actions.png)

![custom_style](assets/custom_style.png)

## Customize loading view : 

![loading](assets/loading.png)

## Customize error view :

![custom_error](assets/custom_error.png)

![error_404](assets/error_404.png)

## Call play and pause, the commands understood by Jukebox

![commands](assets/commands.png)

## Set play when ready

By default, Jukebox does not play your audio when the media player has finished preparing it.

You can force him to play when it's ready :

```

Jukebox(

    uri = uri,

    playWhenReady = true,

    commands = commands.receiveAsFlow()

)

```

## Sample 

[There's a sample to show you how to use Jukebox:](examples/src/main/java/com/lduboscq/jukeboxe/examples/JukeboxSample.kt)

![sample](assets/sample.mov)