Home

Awesome

ASCII Movie

<img src="./assets/icon.svg" alt="ascii-movie logo" width="92" align="right">

GitHub release (latest by date) Build Go Report Card Quality Gate Status

Stream the original Star Wars ASCII movie to command-line clients via SSH or Telnet.

Inspired by asciimation and the iconic towel.blinkenlights.nl, this Go rewrite introduces an interactive UI with both keyboard and mouse support.

Try It

Run one of these commands in a terminal to see it in action:

<div align="center"> <video src="https://user-images.githubusercontent.com/7717888/233742309-4eeace5e-9a7c-41c6-9fc5-21ea19728f77.mp4"></video> </div> <details> <summary>Also available on asciinema</summary> <p align="center"> <a href="https://asciinema.org/a/431278"><img src="https://asciinema.org/a/431278.svg"/></a> </p> </details>

Installation

See Installation.

Usage

The app can play a movie directly on your terminal with the play subcommand, or it can host SSH and Telnet servers with the serve subcommand.

See generated docs for command line usage information.

Docker (Suggested)

An image is available at ghcr.io/gabe565/ascii-movie.

Watch Locally

The following command will run a container that plays the movie directly in your terminal.

sudo docker run --rm -it ghcr.io/gabe565/ascii-movie play

Serve Movie over Telnet and SSH

The following command will run a Telnet server on port 23 and an SSH server on port 2222.

sudo docker run --port=22:22 --port=23:23 ghcr.io/gabe565/ascii-movie serve

Other

See Usage.