Skip to content

Seebass22/terminal-toys

Repository files navigation

terminal-toys

A collection of terminal screensavers

screenshot

Screensavers

3d pipes

pipes3d.mp4

bouncy balls

balls.mp4

splits

splits.mp4

falling sand

pixel_sand2.mp4

game of life

life.mp4

tunnel

tunnel.mp4

Installation

Install Rust if you don't have it yet: https://rustup.rs/

cargo install terminal-toys

Usage

List all screensavers by running terminal-toys without arguments (or with --help, -h or help)

$ terminal-toys -h
Usage: terminal-toys <COMMAND>

Commands:
  balls    Bouncy balls!
  pipes3d  3d pipe screensaver
  splits   Lines that split after a while
  life     Game of life
  sand     Falling sand
  help     Print this message or the help of the given subcommand(s)

Options:
  -h, --help     Print help
  -V, --version  Print version

Each screensaver has its' own --help/-h

$ terminal-toys balls -h
Bouncy balls!

Usage: terminal-toys balls [OPTIONS]

Options:
  -m, --marker <TYPE>      Marker type (Braille, Dot, Bar, Block, HalfBlock) [default: Braille]
  -n, --max-balls <BALLS>  Number of balls to spawn [default: 50]
  -h, --help               Print help

If your terminal font does not support braille characters, try using -m HalfBlock