docker-terminal-screenshot

Pre-built Docker image with terminal-screenshot CLI for automated terminal screenshot generation.

⚠️ Default shell is Fish (see help for Bash users.)

What's Included

• Base image: purefish/docker-fish ;
• Fish shell and Bash ;
• Chromium with fonts (Noto, Noto-emoji) ;
• Node.js (as provided by alpine image);
• Yarn 1.22.22 ;
• Puppeteer 21.10.0 ;
• terminal-screenshot CLI (globally available)

Usage

Standalone

# screenshot `ls -lah` output
docker run \
   --rm \
   --volume $(pwd):/home/nemo \
   purefish/terminal-screenshot:latest \
      'ls -lah | terminal-screenshot --output foo.png'

As a multi-stage builds

Pull purefish/terminal-screenshot image as a stage, then copy what you need for screenshot generation (see usage on pure project):

FROM purefish/terminal-screenshot:latest
USER nemo
# screenshot `ls -lah` output
RUN ls -lah | terminal-screenshot --output foo.png

Default command

terminal-screenshot --help

Default entrypoint

Is fish -c, see help for Bash users, you can override it using --entrypoint argument:

docker run \
   --rm \
   --volume $(pwd):/home/nemo \
   --entrypoint /bin/bash \
   purefish/terminal-screenshot:latest \
      -c 'ls -lah | terminal-screenshot --output bar.png';

Tag

Default, latest, you can specify another based on fish version:

docker pull purefish/terminal-screenshot:fish-<tag>

Development

Build

make build

Test

make test # show versions

Push to Docker Hub

docker login
make push

MIT License