Animated pipes terminal screensaver
Clone or download
livibetter Travis: move script phase to scripts/travis-script.sh
Also added -h check and rearranged the order.
Latest commit 581792d Apr 19, 2018

README.rst

pipes.sh

Animated pipes terminal screensaver.
i/pipes.png

Screenshot of pipes.sh, click to watch a screencast on YouTube.

Requirements

  • Bash 4+ since version 1.0.0.
  • ncurses for tput
    • >= 6.1 (2018-01-27) for 24-bit colors and TERM=*-direct.

Installation

If you want to install, you can run:

$ make install

By default, it installs to /usr/local; for user home, you can run:

$ make PREFIX=$HOME/.local install

Or any PREFIX you prefer.

The Makefile also provides uninstall target.

If you are a Homebrew user, you can install via:

$ brew install pipes-sh

Options

See pipes.sh(6) for a full list of options.

-t [#]: pipe types

-t # Characters Screenshots
-t 0 ┃┏ ┓┛━┓ ┗┃┛┗ ┏━
i/pipes.t0.png
-t 1 │╭ ╮╯─╮ ╰│╯╰ ╭─
i/pipes.t1.png
-t 2 │┌ ┐┘─┐ └│┘└ ┌─
i/pipes.t2.png
-t 3 ║╔ ╗╝═╗ ╚║╝╚ ╔═
i/pipes.t3.png
-t 4 |+ ++-+ +|++ +-
i/pipes.t4.png
-t 5 |/ \/-\ \|/\ /-
i/pipes.t5.png
-t 6 .. .... .... ..
i/pipes.t6.png
-t 7 .o oo.o o.oo o.
i/pipes.t7.png
-t 8
-\ /\|/ /-\/ \|
(railway)
i/pipes.t8.png
-t 9
╿┍ ┑┚╼┒ ┕╽┙┖ ┎╾
(knobby)
i/pipes.t9.png

-t c[16 chars]: custom pipe

For example, -t cMAYFORCEBWITHYOU.

i/pipes.tc.png

Controls

Press any key to exit the program, except the following Shift + Key:

Keys Actions
P / O Increase/decrease probability of straight pipes
F / D Increase/decrease frame rate
B Toggle bold effect
C Toggle no colors
K Toggle keeping pipe color and type when crossing edges

History

(Read full history in pipes.sh(6))

pipes.sh was originally created by Matthew Simpson and posted to the Arch Linux Forums in early 2010. It was also later posted to Gist released in the public domain.

In 2015, the MIT License was added and the Pipeseroni collective was formed to maintain pipes.sh.

Reporting an Issue

Contribution

Feel free to fork and/or create pull request following the guideline. If you're contributing, remember your changes will be released under the MIT license.

Copyright

pipes.sh is licensed under the MIT License.