Find a file
Mattias Andrée d74de40b06 Update Windows support documentation
Signed-off-by: Mattias Andrée <maandree@kth.se>
2016-07-06 17:02:33 +02:00
balloons Stupid permission and stupid btrfs snapshots 2014-06-10 01:35:58 -04:00
completion fix for zsh 2015-04-04 12:53:11 +02:00
dev Update copyright and copyleft year in the sourcecodes 2016-05-31 00:53:02 -04:00
extraponies Added magic olor 2015-06-06 01:49:32 -03:00
extras update lightweight-ponies 2015-07-08 17:26:47 +02:00
extrattyponies Added magic olor 2015-06-06 01:49:32 -03:00
manuals Update Windows support documentation 2016-07-06 17:02:33 +02:00
ponies Update copyright and copyleft year in the sourcecodes 2016-05-31 00:53:02 -04:00
ponyquotes Coco Pommel *cof* Miss Pommel name was changed in the serie, so I do it here too 2016-05-31 00:16:20 -04:00
share Stupid permission and stupid btrfs snapshots 2014-06-10 01:35:58 -04:00
src Update copyright and copyleft year in the sourcecodes 2016-05-31 00:53:02 -04:00
ttyponies Update copyright and copyleft year in the sourcecodes 2016-05-31 00:53:02 -04:00
.gitignore Stupid permission and stupid btrfs snapshots 2014-06-10 01:35:58 -04:00
CHANGELOG Coco Pommel *cof* Miss Pommel name was changed in the serie, so I do it here too 2016-05-31 00:16:20 -04:00
CONTRIBUTING Stupid permission and stupid btrfs snapshots 2014-06-10 01:35:58 -04:00
COPYING update copyright and copyleft years 2016-05-30 23:54:08 -04:00
CREDITS Stupid permission and stupid btrfs snapshots 2014-06-10 01:35:58 -04:00
dependency-test.sh Fix permision for executables... I think we need aome tool for those cases like this 2014-06-10 01:52:12 -04:00
LICENSE Stupid permission and stupid btrfs snapshots 2014-06-10 01:35:58 -04:00
ponysay.pdf Update copyright and copyleft year in the sourcecodes 2016-05-31 00:53:02 -04:00
README.md Update Windows support documentation 2016-07-06 17:02:33 +02:00
setup.py Updated setup.py (workaround for issue 229) 2015-12-06 22:50:05 +00: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. Spanish and Turkish manuals are also available: man -L es 6 ponysay and man -L tr 6 ponysay respectively.

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

Debian packages can be found here.

Ubuntu

There is a PPA available, specifically for ponysay, containing packages for all currently supported Ubuntu releases here.

OpenSuSe 13.2 or OpenSuSe Factory

The package is available in OpenSuSe 13.2 and Factory since 6th april 2014, if you want the individual rpm look here.

Mac OS X (OSX)

A ponysay Homebrew formula is available.

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®

¯\_(ツ)_/¯ Ponysay runs on Cygwin and GNU/NT (a.k.a. Ubuntu on Windows), however the Windows's Bash on Ubuntu on Windows terminal does support xterm-256color colours.

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.