https://github.com/tycrek/asciiquarium-stream

A headless setup for streaming asciiquarium to Twitch.
https://github.com/tycrek/asciiquarium-stream

asciiquarium headless streaming twitch

Last synced: about 2 months ago
JSON representation

A headless setup for streaming asciiquarium to Twitch.

• Host: GitHub
• URL: https://github.com/tycrek/asciiquarium-stream
• Owner: tycrek
• Created: 2021-09-07T01:53:40.000Z (over 3 years ago)
• Default Branch: master
• Last Pushed: 2023-11-13T01:30:22.000Z (about 1 year ago)
• Last Synced: 2024-05-30T02:15:19.638Z (8 months ago)
• Topics: asciiquarium, headless, streaming, twitch
• Language: Shell
• Homepage: https://www.twitch.tv/asciiquarium
• Size: 27.3 KB
• Stars: 2
• Watchers: 3
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        


  

# asciiquarium-stream




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



## Usage

1. Clone this repo

2. Add your Twitch [stream key](https://www.twitch.tv/broadcast/dashboard/streamkey) to `compose.yaml`

3. Optionally, you may [set a server](https://github.com/tycrek/asciiquarium-stream/blob/master/stream.sh#L32) 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](https://www.x.org/releases/X11R7.6/doc/man/man1/Xvfb.1.xhtml)

- a **terminal** is emulated with [xterm](https://invisible-island.net/xterm/)

- a **live stream** is handled by [ffmpeg](https://ffmpeg.org/)

- finally, [**asciiquarium**](https://robobunny.com/projects/asciiquarium/html/) is the star of the show

If you're interested in the original (but outdated) Reddit post, [visit the wiki](https://github.com/tycrek/asciiquarium-stream/wiki/Old-Reddit-Post).

### 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)](https://askubuntu.com/questions/453109/add-fake-display-when-no-monitor-is-plugged-in/1111898#1111898)

- [Using FFMPEG to stream to Twitch.tv with desktop audio? (unix.stackexchange.com)](https://unix.stackexchange.com/questions/87107/using-ffmpeg-to-stream-to-twitch-tv-with-desktop-audio/195302#195302)

- [How do I list connected displays using the command line? (askubuntu.com)](https://askubuntu.com/questions/121014/how-do-i-list-connected-displays-using-the-command-line/121019#121019)

- [Live Video Transmuxing/Transcoding: FFmpeg vs TwitchTranscoder, Part I (blog.twitch.tv)](https://blog.twitch.tv/en/2017/10/10/live-video-transmuxing-transcoding-f-fmpeg-vs-twitch-transcoder-part-i-489c1c125f28/)

- [How To Stream To Twitch From The Command Line On Linux (addictivetips.com)](https://www.addictivetips.com/ubuntu-linux-tips/stream-to-twitch-command-line-linux/)