ponysay/README.md
Mattias Andrée 2d0d087cbb the develop branch is not stabil
Signed-off-by: Mattias Andrée <maandree@operamail.com>
2013-04-03 21:35:25 +02:00

4.9 KiB

ponysay — cowsay reimplemention for ponies.

Derp

Today your terminal, tomorrow the world!

Installation on GNU/Linux (or other Unix implementations)

Download or clone the project. In the terminal, cd into the ponysay directory and ./setup.py --freedom=partial install or python3 setup.py --freedom=partial install. You may need to be super user to run ./setup.py --freedom=partial install without --private, on most systems this can be achieved by running sudo ./setup.py --freedom=partial install. If you only want completely free ponies install use --freedom=strict instead of --freedom=partial. For more information we have provided you with an extensive manual in PDF.

In order to use ponysay, run:

ponysay "I am just the cutest pony!"

Or if you have a specific pony in your mind:

ponysay -f pinkie "Partay!~"

Run info ponysay, man 6 ponysay or ponysay -h for more information. A Spanish manual is available: man -L es 6 ponysay.

Arch Linux

The package is in the official repositories as community/ponysay, there is also a git version named ponysay-git in AUR.

Chakra

A git version of the package is available as ponysay-git in CCR, alongside a stable package as ponysay.

Gentoo Linux

There is a package for Gentoo, to make installation and keeping it up to date easy. You can find it in this overlay. The package is named games-misc/ponysay.

Debian GNU/Linux and Ubuntu

The DEB file can be found in this PPA here.

Pony fortune on terminal startup

This requires that you have the fortune utility installed. You can install it from your repositories (may be named fortune-mod) or just fetch the source code from here.

You can try this script or ponypipe to ponify fortunes.

Edit your ~/.bashrc and add this to the end of the file

fortune | ponysay

Now every time you open a terminal a pony should give your fortune

Pony quotes

Running ponysay --q will give you a random pony saying one it its quote from MLP:FiM, or you can specify the pony: ponysay -q pinkie. Just as with -f, -q can be used multiple time to to sepecify a set of ponies from which one will be selected randomly.

When running ponysay -l or ponysay -L the ponies which have quotes will be printed bold or bright (depending on terminal).

Ponies in TTY (Linux VT)

If you have a custom colour palette edit your ~/.bashrc and add

if [ "$TERM" = "linux" ]; then
    function ponysay
    {
        exec ponysay "$@"
        #RESET PALETTE HERE
    }
fi

Read the PDF or info manual for more information.

Installation on Microsoft™ Windows®

¯\_(ツ)_/¯

Dependencies

Required runtime dependencies

coreutils: stty in coreutils used to determine size of the terminal

python>=3: written in python 3

Package building dependencies

zip: used to create one executable with all sources

gzip: used for compressing manuals (suppressable with ./configure --without-info-compression --without-man-compression)

texinfo: used for building info manual (suppressable with ./configure --without-info)

python>=3: the installation process is written in python 3

Run ./dependency-test.sh if things are not working for you.

FAQ

Q: The output looks like a mess in (TTY/PuTTY/other)!

A: Unfortunately we cannot make it perfect, see issue 1. But we have done a lot, read more about how to get the best the current state of the art has to offer in the manual.

Q: You are missing (my-favourite-pony)!

A: Ask and we'll add!

Q: The outpus look weird on my (xfce4-terminal/mate-terminal/xterm) whit this font

A: We use block for print the ponies, if the block are desalignated or you not use a real monospaced font with aligned blocks try another different and mopnospace font like 'Liberation Mono'.

Q: Which programs do you use to generate the pony files?

A: The pony files are actually mostly a bunch of selected browser ponies, converted using util-say, Other are taken from desktop ponies, and finally another are created specificaly for ponysay.

The PDF manual should answer most of your questions.