Find a file
Mattias Andrée 02d7b039f0 update manual accordingly
Signed-off-by: Mattias Andrée <maandree@operamail.com>
2013-05-22 23:21:35 -04:00
balloons add $X$ for $\$ crossing $/$ 2013-05-22 23:21:34 -04:00
completion everything needed for -F except for the logic itself 2013-04-01 20:35:12 +02:00
dev Too flashy 2013-04-11 15:24:55 -03:00
extraponies Adde Milky Mare in a way that is suitable for Work 2013-04-18 02:39:58 -03:00
extrattyponies Adde Milky Mare in a way that is suitable for Work 2013-04-18 02:39:58 -03:00
manuals update manual accordingly 2013-05-22 23:21:35 -04:00
ponies Using Desktop Ponies devel Blueblood now, Added BruceMane 2013-04-22 16:56:21 -03:00
ponyquotes fix quote word misplacement 2013-05-17 11:50:52 +02:00
share the alternate name for the pony that look like RD in they flashback on S03E12 2013-04-04 06:58:19 -03:00
src add $X$ for $\$ crossing $/$ 2013-05-22 23:21:34 -04:00
ttyponies Using Desktop Ponies devel Blueblood now, Added BruceMane 2013-04-22 16:56:21 -03:00
.gitignore update gitignore 2013-04-12 03:24:33 +02:00
CHANGELOG Using Desktop Ponies devel Blueblood now, Added BruceMane 2013-04-22 16:56:21 -03:00
CONTRIBUTING Correct some mistakes, reword certain phrases 2013-05-17 17:59:07 +03:00
COPYING Correct some mistakes, reword certain phrases 2013-05-17 17:59:07 +03:00
CREDITS crediting gtmanfred (zsh-completion author) 2012-08-25 20:13:53 +02:00
dependency-test.sh remove zip dependency by replacing it with the zipfile module which is included in python 2013-04-03 21:50:13 +02:00
extrapony-wishlist scootaloo pizza 2013-04-07 03:53:33 +02:00
LICENCE Correct some mistakes, reword certain phrases 2013-05-17 17:59:07 +03:00
ponysay.pdf build pdf 2013-04-05 14:28:18 +02:00
README.md Correct some mistakes, reword certain phrases 2013-05-17 17:59:07 +03:00
setup.py Whoops. Fix an overlooked mistake regarding the filename. 2013-05-21 16:36:35 +03:00

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. Superuser permissions might be required in order 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 installing only the completely free ponies is desired, --freedom=strict should be used instead of --freedom=partial. For additional information, an extensive manual in PDF is provided.

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!~"

Consult info ponysay, man 6 ponysay or ponysay -h for additional information. A Spanish manual is also available: man -L es 6 ponysay.

Arch Linux

The package is in the official repositories as community/ponysay. A Git version is also present, named ponysay-git in AUR.

Chakra

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

Gentoo Linux

There is a package for Gentoo, to make installation and updating simple. 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 on this PPA here.

Print a pony fortune upon terminal startup

This requires the fortune utility to be installed. It can install be from the distribution's repositories (might be named fortune-mod). Alternatively, one can 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

Afterwards, every time you open a terminal a pony should give you a fortune.

Pony quotes

Running ponysay -q will print a random pony saying one of its quotes from My Little Pony: Friendship is Magic. The pony can be specified: ponysay -q pinkie. Just as with -f, -q can be used multiple times to specify a set of ponies from which a single one will be selected randomly.

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

Ponies in TTY (Unix 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

Runtime dependencies

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

python>=3: ponysay is written in Python 3.

Package building dependencies

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

texinfo: Used for building the 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 of the current state of the art has to offer in the manual.

Q: The output looks like a mess in (xfce4-terminal/mate-terminal/xterm/[...]) with (this) font!

A: We use blocks for printing the ponies, if the blocks are misaligned, or if you do not use a truly monospaced font with aligned blocks try another monospaced font, such as 'Fixed [...]' or 'Liberation Mono.'

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

A: Ask and we'll add!

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

A: The pony files are in fact mostly a bunch of selected browser ponies, converted using util-say, Other are taken from desktop ponies, and the others are created specifically for ponysay.

The PDF manual should answer most of your questions.