b9725a61a4
Signed-off-by: Mattias Andrée <maandree@operamail.com> |
||
---|---|---|
balloons | ||
completion | ||
dev | ||
extraponies | ||
extrattyponies | ||
manuals | ||
ponies | ||
ponyquotes | ||
share | ||
src | ||
ttyponies | ||
.gitignore | ||
CHANGELOG | ||
CONTRIBUTING | ||
COPYING | ||
CREDITS | ||
dependency-test.sh | ||
extrapony-wishlist | ||
LICENSE | ||
ponysay.pdf | ||
README.md | ||
setup.py |
ponysay
— cowsay reimplemention for ponies.
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.