mirror of
https://github.com/peterlodri-sec/vaked-audio-edge.git
synced 2026-11-22 00:20:08 +01:00
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%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
- 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 |
||
| .github/workflows | ||
| container | ||
| .gitignore | ||
| audio-edge.swift | ||
| batch-import.py | ||
| cli.py | ||
| import-zoe-unplugged.sh | ||
| package.json | ||
| pyproject.toml | ||
| README.md | ||
| tracks-example.txt | ||
| upload-audio.sh | ||
| worker.ts | ||
| wrangler.toml | ||
| ZOE-UNPLUGGED-STATUS.md | ||
| zoe-unplugged-tracks.txt | ||
vaked-audio-edge
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