Installation

• Docker
• Docker Compose
• APT (Ubuntu, Debian)
• RPM (CentOS, RHEL)
• AUR (Arch Linux)
• Homebrew (macOS, Linux)
• Kubernetes
• Manual Installation
• Local Build

Docker

Run one of the below command as root or a member of the docker group:

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 --detach --port=22:22 --port=23:23 ghcr.io/gabe565/ascii-movie serve

Docker Compose

First you will need a docker-compose.yaml file, such as the one included in this repo. Run the below commands as root or a member of the docker group:

sudo docker compose up -d

APT (Ubuntu, Debian)

1. If you don't have it already, install the ca-certificates package

   sudo apt install ca-certificates

2. Add gabe565 apt repository

   echo 'deb [trusted=yes] https://apt.gabe565.com /' | sudo tee /etc/apt/sources.list.d/gabe565.list

3. Update apt repositories

   sudo apt update

4. Install ASCII Movie

   sudo apt install ascii-movie

RPM (CentOS, RHEL)

1. If you don't have it already, install the ca-certificates package

   sudo yum install ca-certificates

2. Add gabe565 rpm repository to /etc/yum.repos.d/gabe565.repo

   [gabe565]
   name=gabe565
   baseurl=https://rpm.gabe565.com
   enabled=1
   gpgcheck=0

3. Install ASCII Movie

   sudo yum install ascii-movie

AUR (Arch Linux)

Install ascii-movie-bin with your AUR helper of choice.

Homebrew (macOS, Linux)

Install ASCII Movie from gabe565/homebrew-tap:

brew install gabe565/tap/ascii-movie

Kubernetes

A Helm chart is available to make Kubernetes simplify deployment to Kubernetes.

helm install ascii-movie oci://ghcr.io/gabe565/charts/ascii-movie

For more information, see charts.gabe565.com or Artifact Hub.

Manual Installation

Download and run the latest release binary for your system and architecture.

Local Build

# Compile the app
go install github.com/gabe565/ascii-movie@latest

# Run the app in your terminal
ascii-movie play

# Or run it as a server
ascii-movie serve

# Now, run `ssh localhost` or `telnet localhost` to watch the movie!