Take your media back

What is Amps?

Amps is a Flask-based server that dynamically generates .m3u playlists, relays or transcodes media streams using FFmpeg, and provides fast configuration via a simple config.yaml file.

It is designed for developers and self-hosters who want a modular, flexible, and modern small-scale streaming system.

Features

• Dynamic M3U Playlists with metadata, logos, groups, and variant info.
• FFmpeg Engine for relaying (copy) or transcoding streams.
• Multi-protocol outputs: HLS, LL-HLS, DASH, RTSP, raw TS.
• yt-dlp integration for YouTube, Twitch, and other complex sources.
• REST API for live adding/removing streams.
• EPG / XMLTV generation and JSON guide API.
• Adaptive bitrate variants (SD/HD/low-bandwidth profiles).
• Region locking per stream with ISO country code filtering.
• Audio-only endpoints for radio and low-bandwidth playback.
• Token authentication for secure access.
• Dockerized for easy deployment.
• CLI tools (amps serve, amps list).
• Scheduled Streams using APScheduler.

Architecture Overview

Amps is composed of several key components:

• Flask Server – serves playlists, streams, and API endpoints.
• FFmpeg Wrapper – manages transcoding/relay processes.
• Configuration Loader – parses and validates config.yaml.
• CLI – entry points for serving and managing streams.

Setup & Installation

1. Requirements

• Python 3.7+
• FFmpeg installed
• Docker (optional)

2. Development Install

git clone <repository_url>
cd amps-project

python -m venv venv
source venv/bin/activate   # Windows: venv\Scripts\activate

pip install -r requirements.txt

python -m amps serve

3. Docker Deployment

docker build -t amps-server .

docker run -d -p 5000:5000 \
  --name amps \
  -v $(pwd)/config.yaml:/app/config.yaml \
  --restart unless-stopped \
  amps-server

Usage

Playlist Access

Open in VLC or browser:

http://<server_ip>:5000/playlist.m3u?token=<your_token>

cURL Example

curl -L "http://localhost:5000/playlist.m3u?token=changeme123"

Filtering

Playlist parameters:

• region=US
• group=Sports,News
• ids=1,5,8
• variants=false

License

Amps is licensed under the Apache License 2.0.