Skip to content


Subversion checkout URL

You can clone with
Download ZIP
A Ruby port of Kevin Lange's nyancat CLI
Branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.

Ruby port of Nyancat CLI

A Ruby port of the original nyancat CLI by Kevin Lange. Currently only supports xterm 256-color compatible terminals, likely doesn't work on Windows and lacks any finese or optimisation.

$ gem install nyancat
$ nyancat

For options, see --help

$ nyancat --help
Usage: nyancat [options]
-s, --silent                     Don't play audio
-f, --flavour FLAVOUR            Available flavours: original
-n, --notime                     Don't show the time nyaned
-l, --listen [PORT]              Run telnet server on PORT (default 21)
-t, --timeout SECONDS            Timeout after SECONDS


Very basic audio support is provided by using mpg123. You'll need mpg123 installed and in your $PATH for audio to work.

Telnet server

If run with -l or --listen and an optional port argument, a simple socket server will be started. The server will render a loop of the 'original' animation to connected clients using ANSI escaped text until any input from the client is received, upon which the connection is closed. The server does not currently implement the telnet protocol and simply spews ANSI text to the client. A proper telnet implementation is planned for the future.

Clients can connect to the server with a telnet client, though only xterm 256-color compatible terminals are supported.

$ telnet 23

Licenses, References, etc.

The original source of the Nyancat animation is prguitarman.

Original video: Original Song:

The code provided here is provided under the terms of the NCSA license.

Something went wrong with that request. Please try again.