Skip to content

Commit

Permalink
Updated README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
Andrea Bondavalli authored and Andrea Bondavalli committed Aug 17, 2024
1 parent 33a2b25 commit b7b626c
Showing 1 changed file with 52 additions and 14 deletions.
66 changes: 52 additions & 14 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,23 +1,61 @@
# AES67 Player for Android
# AES67 Player

The AES67 Player is an Android application used to play AES67 streams.
The AES67 Player application is an Android application that can be used to play to your AES67 streams.

The application is licensed under [GNU GPL](https://www.gnu.org/licenses/gpl-3.0.en.html).
# Introduction

The application can be built and installed on your device by using Android Studio.
You can also download the last released APK from:
Play your AES67 audio streams directly on your Android devices for testing, previewing or just for fun by using the AES67 Player and the AES67 Linux Daemon.

The application requires the AES67 Linux Daemon to work and playout streams.
The AES67 Linux Daemon is an open source Linux application and you can find it at: [AES67 Linux Daemon](https://github.com/bondagit/aes67-linux-daemon)

The AES67 Linux Daemon is an open source Linux application and you can find it at: https://github.com/bondagit/aes67-linux-daemon
Starting from version 2.0 the daemon is now able to capture and compress, using the AAC codec, AES67 sinks and serve them via HTTP Live Streaming supporting scalable audio distribution.

# How to setup the Daemon and use the AES67 Player
The Player is able to playback the live streams up to 6 channels each.

1. Install and configure the AES67 Linux daemon on a Linux host and attach it to your AES67 LAN.
2. Using the AES67 Linux daemon WebUI, in the Config tab, enable the Streamer feature.
3. Attach one or more AES67 Sources to your LAN.
The diagram below shows the various components and how they interact:
![Screenshot 2024-06-15 at 15 36 48](https://github.com/user-attachments/assets/8e2a8c58-c811-48c7-8954-4596331d862f)

# License

AES67 player is licensed under [GNU GPL](https://www.gnu.org/licenses/gpl-3.0.en.html).

# How to build and install the app

You can use Android Studio to build and install the application on your device.

You can also download and install a prebuilt APK for the lastest release from:
https://github.com/bondagit/aes67-player-android/releases/latest/download/app-release.apk


# Setup instruction

To use the Player follow these instructions:

1. Install and configure the AES67 Linux daemon v2.0 or above on a Linux host and attach it to your AES67 LAN, see [How to build and setup the daemon](https://github.com/bondagit/aes67-linux-daemon?tab=readme-ov-file#how-to-build-and-setup-the-daemon).
2. Using the AES67 Linux daemon WebUI, in the Config tab, check the daemon version and enable the Streamer feature.
See picture below:

<img width="790" alt="Daemon config" src="https://github.com/user-attachments/assets/9d2a6ae9-ab7d-4c2e-83dd-a323366465ac">.

3. Attach one or more AES67 or Dante Sources to your LAN. See [Compatible Device](https://github.com/bondagit/aes67-linux-daemon/blob/master/DEVICES.md)
4. Using the AES67 Linux daemon WebUI, in the Sinks tab, create one of more Sinks specifying the AES67 Sources discovered by the daemon.
See picture below:

<img width="597" alt="Daemon Sinks list" src="https://github.com/user-attachments/assets/8b8b5832-96a0-437c-b3df-ff233234f881">.

5. Open the AES67 Player application and enter the URL of the AES67 Linux daemon WebUI.
6. When the daemon appears in the daemon's list click on the go icon on the right side to connect to it.
7. On the Sinks page start or stop a Sink playback by using the play icon on the right.
8. Expand a Sink info by clicking on the expand icon on the left.

<img width="340" alt="Screenshot 2024-07-12 at 10 46 46" src="https://github.com/user-attachments/assets/77cd3023-69db-4c40-a221-b56c1655806b">

7. When the daemon appears in the daemon's list click on the go icon on the right side to connect to it. See picture below:

<img width="342" alt="Player Daemons list" src="https://github.com/user-attachments/assets/ee2bdb93-cb5f-4c23-9126-b0bf1d87a784">

8. On the Sinks page start or stop a Sink playback by using the play icon on the right. See picture below:

<img width="340" alt="Player Sinks list" src="https://github.com/user-attachments/assets/ae816d6b-2d00-49e1-8c77-98df1e140d4e">

9. Expand a Sink info by clicking on the expand icon on the left. See picture below:

<img width="344" alt="Player Sink expanded" src="https://github.com/user-attachments/assets/de0d2cb4-b1d9-47a7-a4c8-02ff32c55797">

0 comments on commit b7b626c

Please sign in to comment.