Beatnik Controller

Beatnik Controller is a web-based remote control for your Beatnik Pi or Snapcast multi-room audio server. It allows you to easily manage and control audio streams from any device with a web browser. The application can also be compiled for Android and iOS and is available in the App- & Play Store.

Features

• Control volume for all connected clients.
• Manage client groups.
• View what's currently playing on each stream.
• Simple and intuitive user interface.

Prerequisites

To run Beatnik Controller, you will need:

• A running Snapcast server on your network. This application is compatible with the standard Snapcast server. For a detailed installation guide for a Raspberry Pi based setup, we recommend beatnik-pi.
• Docker and Docker Compose.

Installation & Usage

There are two ways to get Beatnik Controller running:

1. Run with Docker (Recommended): This is the easiest way to get started. It uses the pre-built Docker image from our registry and requires no local setup.
2. Build from Source: This is for developers who want to modify the code or contribute to the project.

Method 1: Run with Docker (Recommended)

This method uses Docker to run the application without needing to build it yourself.

1. Get the Code

Clone this repository to your local machine:

git clone https://github.com/byrdsandbytes/beatnik-controller.git
cd beatnik-controller

2. Configure the Beatnik Pi or Snapcast Server (Optional)

By default, the application will try to connect to a Snapcast server at beatnik-server.local. If your server is at a different address, you can configure it in the in-app settings once the application is running.

3. Run with Docker

You can run the application using Docker Compose:

docker compose up -d

This will pull the latest Docker image and start the application in the background.

4. Access the Application

Open your web browser and navigate to http://localhost:8181 or http://your-hostname.local:8181. You should now see the Beatnik Controller interface.

Method 2: Build from Source (for Developers)

This method is for developers who want to modify the code or contribute to the project.

1. Get the Code

Clone this repository to your local machine:

git clone https://github.com/byrdsandbytes/beatnik-controller.git
cd beatnik-controller

2. Configure the Beatnik Pi or Snapcast Server (Optional)

By default, the application will try to connect to a Snapcast server at beatnik-server.local. If your server is at a different address, you can edit src/environments/environment.ts and change snapcastServerUrl to your server's hostname or IP address.

3. Build and Run

You have two options for building and running the application locally:

Build with Docker

If you want to build the Docker image from the source code, you can use the provided docker-compose.build.yml file. This is useful for testing local changes in a containerized environment.

docker compose -f docker-compose.build.yml up -d --build

This command builds the image and runs it locally. The application will be available at http://localhost:8181.

Contributing

We welcome contributions! If you'd like to help improve Beatnik Controller, please see our CONTRIBUTING.md file for more information on how to get started. For details on the automated build pipeline, see BUILD_PIPELINE.md.

License

This project is licensed under the AGPL v3 License - see the LICENSE file for details.