# ABCC Media — Documentation Index

This folder contains documentation for the **ABCC Media Server** — a self-hosted
24/7 Christian TV playout system for the Arabic Bible Christian Church.

## What This Project Does

- Downloads sermon videos from YouTube and the church WordPress site
- Generates a continuous HLS live stream (`live/stream.m3u8`) from a schedule
- Serves VOD content via a Roku channel feed (`roku/feeds/primary-feed.json`)
- Provides an admin dashboard at `/admin/`

## Docs

### Current Implementation

| File | Description |
|------|-------------|
| `overview.md` | How it works — non-technical overview diagram |
| `project.md` | Project overview and component map |
| `admin.md` | Admin UI guide and maintenance tasks |
| `setup.md` | Installation and dependency setup |
| `schedule.md` | `playlists.json` and `schedule.json` format reference |
| `live-flow.md` | Live stream system flowchart (Mermaid) |
| `sync-flow.md` | VOD sync pipeline flowchart (Mermaid) |
| `server.md` | HTTP endpoints and storage layout |

### Design Proposals 

| File | Description |
|------|-------------|
| `architecture.md` | Cloud/Azure system architecture |
| `technical.md` | Technical design notes |
| `encoding-pipeline-design.md` | Multi-bitrate HLS encoding pipeline |
| `hls-playlist-generator-design.md` | Channel playlist generator algorithm |
| `admin-api-spec.md` | REST admin API specification |
| `roku-channel-proposal.md` | Channel feature proposal |
| `roku-channel-technical-design.md` | Roku app architecture |
| `roku-developer-setup.md` | Roku SDK developer environment setup |

---
*Updated March 2026.*