Griot Studio — automated African folktale videos for YouTube: Nigerian narration, 3D folktale visuals, GitHub-to-YouTube publishing.
# Griot Studio
A professional YouTube automation suite for **African folktale** channels, built with Astro. Write a tale, and Griot Studio narrates it in a **free Nigerian voice**, illustrates it in a warm **3D animated folktale** look, writes the SEO, and publishes it to YouTube — one clean workspace to plan, produce, schedule, and track videos.
**Two ways to publish:**
- **From GitHub (hands-off):** drop a folktale script in `content/`, push, and GitHub Actions renders and uploads it to YouTube automatically. See PUBLISH-ON-GITHUB.md.
- **From the app / your Mac:** use the Auto Video and Bulk Studio pages, or the background `worker`.
The signature look and the recurring elder-griot narrator are described in CHARACTER-REFERENCE.md. The free Nigerian narration voice is set up in worker/SETUP-VOICE.md.
## What is inside
| Page | What it does |
| :-- | :-- |
| Dashboard | Channel stats, growth chart, traffic sources, top videos, activity feed, and a publishing queue |
| Analytics | Deep metrics, views trend, best publishing days, audience age, top countries, and a per video breakdown |
| Videos | Full content library with live status filtering, a play preview for every video, and an edit dialog for title, description, tags, and visibility |
| Automations | An autopilot engine: turn triggers into actions, build your own recipes, start from templates, and watch a live run log |
| Bulk Studio | Drop in a CSV or a batch of scripts and it renders a finished illustrated video for each one, each with a free natural voiceover baked in, plus a live queue, progress, save all, a CSV template, per row voice and music columns, and a Watch folder mode that turns any new CSV into videos automatically and saves them back |
| Schedule | A working monthly upload calendar, smart timing suggestions, and automation toggles |
| Auto Video | The guided pipeline: paste a script to auto fill the scenes or write one image prompt per scene, then choose the narration (generate a free natur …