asteroid/docs

Asteroid Radio - Documentation Index

• Welcome to Asteroid Radio Documentation
• Quick Start
• Documentation Structure
  • Core Documentation
    • Project Overview
    • Installation Guide
    • Docker Streaming Setup
  • Development & Integration
    • Development Guide
    • Interface Reference
• Current System Status
  • What's Working Now
  • Stream URLs (when running)
• Getting Started
  • New Users
  • Developers
  • System Administrators
• Support & Community
  • Getting Help
  • Contributing
• About Asteroid Music
• Technical Architecture

Welcome to Asteroid Radio Documentation

Asteroid Radio is a modern internet radio platform designed for developers and music enthusiasts who want to run their own radio stations streaming Asteroid Music - the perfect soundtrack for coding and hacking sessions.

Quick Start

For immediate setup, see:

1. Installation Guide - Get Asteroid Radio running
2. Docker Streaming Setup - Docker-based streaming infrastructure

Documentation Structure

Core Documentation

Project Overview

Complete overview of Asteroid Radio's architecture, technology stack, and vision. Start here to understand what Asteroid Radio is and how it works.

Installation Guide

Comprehensive installation instructions for multiple operating systems, including system requirements, dependencies, and production deployment considerations.

Docker Streaming Setup

Complete guide to the Docker-based streaming infrastructure using Icecast2 and Liquidsoap. Includes container configuration, management scripts, and troubleshooting.

Development & Integration

Development Guide

Development environment setup, contributing guidelines, coding standards, and debugging procedures for developers working on Asteroid Radio.

Interface Reference

Documentation of all available interfaces including streaming endpoints, Icecast admin interface, Liquidsoap telnet control, and Docker management commands.

Current System Status

What's Working Now

• Docker Streaming Infrastructure: Icecast2 + Liquidsoap containers
• Three Quality Streams: 128kbps MP3, 96kbps AAC, 64kbps MP3
• Admin Interface: Icecast web admin at http://localhost:8000/admin/
• Telnet Control: Liquidsoap control via telnet localhost:1234
• Professional Features: Crossfading, normalization, metadata support

Stream URLs (when running)

• High Quality MP3: http://localhost:8000/asteroid.mp3 (128kbps)
• High Quality AAC: http://localhost:8000/asteroid.aac (96kbps)
• Low Quality MP3: http://localhost:8000/asteroid-low.mp3 (64kbps)

Getting Started

New Users

1. Read the Project Overview to understand Asteroid Radio
2. Follow the Installation Guide for your operating system
3. Set up streaming with the Docker Guide

Developers

1. Review the Development Guide for setup procedures
2. Check the Interface Reference for available controls
3. Join our IRC channel: #asteroid.music on irc.libera.chat

System Administrators

1. Follow the Installation Guide production deployment section
2. Review Docker Streaming Setup for container management
3. Monitor system resources and streaming performance

Support & Community

Getting Help

• Documentation: Start with the relevant guide above
• IRC Chat: Join #asteroid.music on irc.libera.chat
• Issues: Submit detailed bug reports with system information
• Logs: Check Docker container logs for troubleshooting

Contributing

• Review the Development Guide for contribution guidelines
• Follow coding standards and testing procedures
• Submit pull requests with clear descriptions

About Asteroid Music

Asteroid Radio streams Asteroid Music - a carefully curated genre designed for developers:

• Focus-Enhancing: Ambient, electronic, and instrumental tracks
• Coding-Optimized: Rhythms that complement programming flow
• Hacker Culture: Music that resonates with developer aesthetics
• Flow State: Tracks selected to maintain deep concentration

This isn't just background music - it's the soundtrack to the hacker lifestyle, designed by hackers for hackers who understand that the right music can elevate your code.

Technical Architecture

Asteroid Radio uses a modern, containerized architecture:

┌─────────────────────────────────────────────────────────────┐
│                    Asteroid Radio Platform                  │
├─────────────────────────────────────────────────────────────┤
│  Streaming Infrastructure (Docker)                         │
│  ├── Icecast2 (HTTP Streaming Server)                     │
│  ├── Liquidsoap (Audio Processing Pipeline)               │
│  └── Multiple Format Support (AAC, MP3)                   │
├─────────────────────────────────────────────────────────────┤
│  Control Interfaces                                        │
│  ├── Icecast Admin Web Interface                          │
│  ├── Liquidsoap Telnet Control                            │
│  └── Docker Container Management                          │
└─────────────────────────────────────────────────────────────┘

For detailed technical information, see the Project Overview.

—

Last Updated: 2025-10-03 Documentation Version: 1.0