sebastiancarlos/hacker-fables — explained in plain English
Analysis updated 2026-05-18
Read the novella online in HTML, EPUB, PDF, audiobook, or even man page form.
Study a working example of a single-source markdown publishing pipeline.
Adapt the pipeline to compile your own writing into multiple formats with synced audio.
| sebastiancarlos/hacker-fables | cvlab-kaist/cats-plusplus-project-page | shihanqu/video-pause-remover | |
|---|---|---|---|
| Stars | 8 | 8 | 8 |
| Language | HTML | HTML | HTML |
| Last pushed | — | 2022-10-20 | — |
| Maintenance | — | Dormant | — |
| Setup difficulty | hard | easy | moderate |
| Complexity | 3/5 | 1/5 | 3/5 |
| Audience | developer | developer | developer |
Figures from each repo's GitHub metadata at analysis time.
Full audio and video builds need a working Piper TTS install, Playwright with Chromium, and ffmpeg on your system.
Hacker Fables is a satirical cyberpunk novella, and this repository is both the text of that story and the custom publishing system built to produce it in many formats. If you just want to read the book, the README points you to a hosted website where you can read it online with a synchronized audiobook player, or download it as an EPUB, PDF, MP3 audiobook, MP4 audiobook video, and even as a Unix man page or GNU Info manual, both of which can be read straight from the terminal. What makes this repository interesting from a technical side is the pipeline that turns one single markdown source file into all of those different formats. The pipeline uses Pandoc with custom Lua filters to manipulate the document's structure rather than relying on fragile text replacement, then converts that into an EPUB using a separate library, and produces an automated audiobook by stripping out visual-only content, running the text through a text to speech engine inside Docker, and mapping the generated audio timing back onto the text so the web reader can highlight words as they are spoken. It even generates a video version of the audiobook by taking screenshots of the highlighted text and stitching them together with an audio and video processing tool. The pipeline itself has its own automated test suite. To compile the book yourself, you need Pandoc and a few other command line tools installed, along with Python managed through a tool called uv. A single build script then produces the core outputs, with separate flags to generate the narrated audio version and the video version, each of which needs its own additional setup such as a text to speech installation or a browser automation tool. The license is split: the publishing pipeline code is released under the MIT License, but the actual text of the novella and all of its compiled versions remain fully copyrighted by the author.
A satirical cyberpunk novella paired with a custom pipeline that compiles one markdown file into a book, audiobook, video, and even a man page.
Mainly HTML. The stack also includes Python, Pandoc, Docker.
The publishing pipeline code is free to use under MIT, but the novella's text and all its compiled versions are fully copyrighted and not open for reuse.
Setup difficulty is rated hard, with roughly 1h+ to a first successful run.
Mainly developer.
This repo across BitVibe Labs
Don't trust strangers blindly. Verify against the repo.