Crazy Arms Radio Backend — 🤪 🦾 📻 👩‍💻

Crazy Arms Radio Backend is a flexible and fully featured Internet radio back-end written from the ground up.

It's specifically written after its author built a few fully decentralized online radio stations with varying types of scheduling and finding no existing product fit some common needs out of the box.

Read the documentation for Crazy Arms here.

Quickstart

1. Install Docker and docker-compose. On macOS, install Docker for Mac. On Debian/Ubuntu do the following:

   # Install Docker (Linux instructions only)
   curl -fsSL https://get.docker.com | sh
   
   # and docker-compose
   sudo curl \
       -L "https://github.com/docker/compose/releases/download/1.29.0/docker-compose-$(uname -s)-$(uname -m)" \
       -o /usr/local/bin/docker-compose
   sudo chmod +x /usr/local/bin/docker-compose
   
   # (If you're a non-root user)
   sudo adduser "$USER" docker
   # Log back in and out, to make sure you're in the docker group
   

2. Clone Crazy Arms,

   git clone https://github.com/dtcooper/crazyarms.git
   

3. Run the thing docker-compose wrapper script ./compose.sh to configure and pull Crazy Arms.

   cd crazyarms
   
   # This will ask you some basic questions. For local development domain
   # name should be the default of "localhost"
   ./compose.sh pull
   

   If you want to change any of these settings, edit the .env file in the project directory. (NOTE: A later release will have these containers built and downloadable from Docker Hub.)

   (For development only, to build containers from source, run ./compose.sh build instead of pull above. This may take a while.)

4. Start Crazy Arms

   ./compose.sh up -d
   

5. In your web browser, go to the domain name you chose, ie http://localhost/.

Digital Ocean Notes

• A 2gb + 2 CPU droplet or better is recommended if you're using Zoom, otherwise the cheapest one will do.

• haveged makes docker-compose run significantly faster:

  sudo apt-get install -y haveged
  

Apple M1 Chipset Notes (aarch64)

It works with the Docker for Mac Apple M1 preview! However, native aarch64 containers are not provided, so you'll need to build them from source (./compose.sh build instead of pull). The Zoom container will need to emulate amd64.

Liquidshop 1.0 Slide Deck

Here's a slide deck about Crazy Arms from the Liquidshop 1.0 conference giving a high level overview and some of the technical approaches taken.

License

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