tycrek / asciiquarium-stream

A headless setup for streaming asciiquarium to Twitch.

asciiquarium-stream

A headless setup for streaming asciiquarium to Twitch. Without a monitor.

Usage

1. Clone this repo
2. Add your Twitch stream key to compose.yaml
3. Optionally, you may set a server to use
4. Run docker compose up

How does this work?

It's a bit complicated to explain so I'll break down the main components:

• a fake monitor is created by xvfb
• a terminal is emulated with xterm
• a live stream is handled by ffmpeg
• finally, asciiquarium is the star of the show

If you're interested in the original (but outdated) Reddit post, visit the wiki.

Helpful resources

Below is a collection of links that helped me get this working the first time around.

• Add Fake Display when No Monitor is Plugged In (askubuntu.com)
• Using FFMPEG to stream to Twitch.tv with desktop audio? (unix.stackexchange.com)
• How do I list connected displays using the command line? (askubuntu.com)
• Live Video Transmuxing/Transcoding: FFmpeg vs TwitchTranscoder, Part I (blog.twitch.tv)
• How To Stream To Twitch From The Command Line On Linux (addictivetips.com)