https://github.com/asmeurer/catimg

Print an image of a cat to the iTerm2 terminal
https://github.com/asmeurer/catimg

cat catimg image imgur iterm2

Last synced: 6 days ago
JSON representation

Print an image of a cat to the iTerm2 terminal

• Host: GitHub
• URL: https://github.com/asmeurer/catimg
• Owner: asmeurer
• License: mit
• Created: 2015-07-14T02:10:52.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2017-02-07T18:31:15.000Z (almost 8 years ago)
• Last Synced: 2024-12-08T16:11:36.458Z (18 days ago)
• Topics: cat, catimg, image, imgur, iterm2
• Language: Python
• Size: 550 KB
• Stars: 15
• Watchers: 3
• Forks: 0
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        
# catimg

Print an image of a cat from Imgur to iTerm2.

![](example.png)

Uses iTerm2's [proprietary escape codes](https://iterm2.com/images.html) and

Imgur to display an image of a cat in your terminal.

**NOTE**: I do not own the images that you see, nor have I any control over

them. You will see some image that is tagged as "cat" on Imgur. That could be

anything. I do filter out images that are tagged NSFW, but there are no

guarantees that you won't see something you wish you hadn't. Use at your own

risk.

**SECOND NOTE**: This requires iTerm2 2.9 or later. You can download it

[here](https://www.iterm2.com/downloads.html).

# Installation

catimg depends on [requests](http://docs.python-requests.org/en/latest/),

[imgurpython](https://github.com/Imgur/imgurpython),

[iterm2-tools](https://github.com/asmeurer/iterm2-tools) and

[iTerm2](https://iterm2.com/).  It depends on Python 3 (it will not work in

Python 2).

The easiest way to install it is with pip

    pip install catimg

or conda

    conda install -c conda-forge catimg

# License

MIT