Find a file
Pablo Lezaeta 64078c5943 First Draft of ponysay-tool manualpage
Signed-off-by: Pablo Lezaeta <prflr88@gmail.com>
2013-05-13 00:15:48 -04:00
balloons add $X$ for $\$ crossing $/$ 2013-04-23 08:13:12 +02:00
completion everything needed for -F except for the logic itself 2013-04-01 20:35:12 +02:00
dev Added Desktop ponies Template, needed clean.. Really need clean 2013-05-05 06:05:48 -04: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 First Draft of ponysay-tool manualpage 2013-05-13 00:15:48 -04:00
ponies Added Mantishy 2013-05-05 05:56:54 -04:00
ponyquotes Added Mantishy 2013-05-05 05:56:54 -04: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-04-23 08:13:12 +02:00
ttyponies Added Mantishy 2013-05-05 05:56:54 -04:00
.gitignore update gitignore 2013-04-12 03:24:33 +02:00
CHANGELOG Added Mantishy 2013-05-05 05:56:54 -04:00
CONTRIBUTING soft f 2013-04-04 02:33:02 +02:00
COPYING minor rewording 2013-04-02 09:17:07 +02: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
LICENSE relicensing to gnu gpl 3+ 2013-04-01 16:52:28 +02:00
ponysay.pdf build pdf 2013-04-05 14:28:18 +02:00
README.md Fix issue #159 on develop 2013-05-09 17:18:36 -04:00
setup.py alternative 1 for issue #155, support for python<3.2 2013-04-06 20:35:31 +02: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. 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

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) with this font

A: We use blocks for printing the ponies, if the blocks are misalignated or you not use a real monospaced font with aligned blocks try another monospaced font like 'fixed [misc]' or '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.