Cloudflare Workers audio streaming engine — Opus edge streaming + YouTube import via CF Containers
  • Python 33.4%
  • TypeScript 31.6%
  • Swift 25.8%
  • Shell 8.7%
  • Dockerfile 0.5%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Peter b15b6488f3 feat: batch import tool, retry logic, tsv format
- batch-import.py: stdin/file, auto-retry, tab-separated
- import-zoe-unplugged.sh: retry wrapper
- zoe-unplugged-tracks.txt: 14 tracks ready
- tracks-example.txt: format docs
- README: batch import usage
2026-07-13 14:13:22 +02:00
.github/workflows ci: use dependency-groups (uv 0.5+), sync --group dev 2026-07-13 14:03:31 +02:00
container feat(import): auto-detect YouTube metadata — URL-only import 2026-07-13 09:44:47 +02:00
.gitignore feat: vaked-audio-edge — Opus streaming + YouTube import on CF 2026-07-13 09:11:00 +02:00
audio-edge.swift refactor: upgrade to py3.12, modern python features, secure tempfile 2026-07-13 10:42:16 +02:00
batch-import.py feat: batch import tool, retry logic, tsv format 2026-07-13 14:13:22 +02:00
cli.py refactor: upgrade to py3.12, modern python features, secure tempfile 2026-07-13 10:42:16 +02:00
import-zoe-unplugged.sh feat: batch import tool, retry logic, tsv format 2026-07-13 14:13:22 +02:00
package.json feat: vaked-audio-edge — Opus streaming + YouTube import on CF 2026-07-13 09:11:00 +02:00
pyproject.toml ci: use dependency-groups (uv 0.5+), sync --group dev 2026-07-13 14:03:31 +02:00
README.md feat: batch import tool, retry logic, tsv format 2026-07-13 14:13:22 +02:00
tracks-example.txt feat: batch import tool, retry logic, tsv format 2026-07-13 14:13:22 +02:00
upload-audio.sh feat: vaked-audio-edge — Opus streaming + YouTube import on CF 2026-07-13 09:11:00 +02:00
worker.ts feat(import): auto-detect YouTube metadata — URL-only import 2026-07-13 09:44:47 +02:00
wrangler.toml feat: vaked-audio-edge — Opus streaming + YouTube import on CF 2026-07-13 09:11:00 +02:00
ZOE-UNPLUGGED-STATUS.md feat: batch import tool, retry logic, tsv format 2026-07-13 14:13:22 +02:00
zoe-unplugged-tracks.txt feat: batch import tool, retry logic, tsv format 2026-07-13 14:13:22 +02:00

vaked-audio-edge

CI Python

Cloudflare edge audio streaming + YouTube import — Python CLI + macOS menu bar app.

Features

  • CLI: Stream, play, list tracks from edge worker
  • macOS app: Menu bar controls, auto-start LaunchAgent
  • Import: YouTube → Opus via CF Container (no local bandwidth)
  • Stack: Cloudflare Workers, R2 storage, Container for yt-dlp + ffmpeg

Usage

# CLI (uv run / standalone)
audio list                      # List tracks
audio play <slug>               # Stream track
audio play                      # Interactive picker
audio import <youtube-url>      # Import from YouTube
audio status                    # Worker health

# Batch import (easiest way)
python3 batch-import.py tracks.txt              # From file
python3 batch-import.py tracks.txt --artist Zoé  # Set defaults
cat urls.txt | python3 batch-import.py          # From stdin

# Format: URL [TAB] title [TAB] artist [TAB] album
# See tracks-example.txt for format details

# macOS app
open AudioEdge.app              # Menu bar player

Configuration

export AUDIO_HOST=https://audio.vaked.dev    # Edge worker URL (default)
export MPV_PATH=/opt/homebrew/bin/mpv        # macOS app mpv path (fallback)

Development

git clone https://github.com/peterlodri-sec/vaked-audio-edge.git
cd vaked-audio-edge

# Lint + format
uv run --with ruff ruff check cli.py
uv run --with ruff ruff format cli.py

# Build macOS app
swiftc audio-edge.swift -o AudioEdge.app/Contents/MacOS/AudioEdge

Architecture

┌─────────────────┐
│   CF Worker     │  TypeScript + Hono
│   worker.ts     │  /tracks, /stream/:slug, /import
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│   R2 Storage    │  Opus audio files
│   bucket/       │  metadata.json
└─────────────────┘
         │
         ▼
┌─────────────────┐
│  CF Container   │  yt-dlp + ffmpeg
│  /import POST   │  YouTube → Opus (on-demand)
└─────────────────┘

License

MIT