Keryx¶
Turn a written post into a short narrated video and publish it to social platforms, on demand or on a schedule.
"KEH-riks" · /ˈkɛrɪks/ · from Greek κῆρυξ, "herald" · the content-marketing automation for phpboyscout.uk
Status: the pipeline works, the studio is still growing
The CLI runs the full reel pipeline (storyboard → VO + music → cards/cover →
assembled mp4, or all of it at once with reel make)
and composes social copy for each platform. Publishing adapters for nine platforms
are compiled in, though each platform decides for itself whether your app may post
publicly. The web studio is in active development. What is deliberately absent,
and what looks configurable but is not, is on
What Keryx does not do.
What Keryx does¶
It builds a 9:16 reel from a storyboard: text cards over generated or uploaded images, narration in a cloned voice, and a music bed matched to the theme. It publishes reels, and text or image posts about the same article, to Instagram, YouTube, TikTok, LinkedIn, Facebook, Threads, X, Bluesky and Mastodon. You run it from the CLI or the local web studio, and a GitLab scheduled pipeline runs it unattended. It is built on go-tool-base and ships as a single Go binary. It keeps no state of its own: your project's git repo owns the reels, the config and the schedule.
-
Never used Keryx? Render a real reel from nothing in about fifteen minutes, with no API keys and nothing to pay for.
-
Make a reel, compose social copy, post on demand, schedule unattended runs.
-
Every command, flag, configuration key and environment variable: what it defaults to, and what happens when it is wrong.
-
Why it works this way: the authoring loop, themes, pluggable providers, and what Keryx deliberately does not do.
-
Why Keryx, the name, status and roadmap.
-
Ways of working, the UI mockup, and how the pieces fit.
Further reading¶
Everything written about the estate, including the curated guides, is on the blog.
Ask phpbotscout
He answers questions about the projects over on the Discord, citing the docs where they already cover it, and offering to raise an issue where they don't. Bring a bug, an idea, or a questionable engineering decision.