Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/posva/catimg

🦦 Insanely fast image printing in your terminal
https://github.com/posva/catimg

c catimg fun imagemagick shell terminal

Last synced: 20 days ago
JSON representation

🦦 Insanely fast image printing in your terminal

Host: GitHub
URL: https://github.com/posva/catimg
Owner: posva
License: mit
Created: 2013-05-26T22:01:55.000Z (over 11 years ago)
Default Branch: master
Last Pushed: 2022-12-22T07:49:01.000Z (almost 2 years ago)
Last Synced: 2024-04-14T10:15:35.237Z (7 months ago)
Topics: c, catimg, fun, imagemagick, shell, terminal
Language: C
Homepage: http://posva.net/shell/retro/bash/2013/05/27/catimg
Size: 199 KB
Stars: 1,327
Watchers: 19
Forks: 57
Open Issues: 12
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- Funding: .github/funding.yml
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md

Awesome Lists containing this project

awesome-rainmana - posva/catimg - 🦦 Insanely fast image printing in your terminal (C)
awesome-linux-ricing - catimg

README

# Catimg

Renders images in the terminal.

![mewtwo](https://cloud.githubusercontent.com/assets/664177/10267523/f81296de-6a97-11e5-99d0-d2124bd6a9e3.png)

`catimg` is a little program written in C with no dependencies that prints images in terminal.
It supports JPEG, PNG and GIF formats. This program was originally a script that
did the same by using ImageMagick `convert`.

## Installation

Homebrew

```sh
brew install catimg
```

Arch Linux

```sh
yaourt -S catimg
```

Fedora 25 and later

```sh
dnf -y install catimg
```

## Building

```sh
cmake .
make install
```

## Script Dependencies

In order to use the script you need:

- ImageMagick 6.6.0-4 2012-08-17 Q16 (Not tested with earlier versions)
- shell with 256 colors support ( **change the** `#!/usr/bin/env bash` **by
yours**). In OS X you just have to update the bash version using
[Homebrew](http://brew.sh/) (or any other method).

## Examples

![pikachu gif](https://cloud.githubusercontent.com/assets/664177/10122393/6846151e-6518-11e5-9a21-9be0c0765267.gif)

## High Resolution vs Low Resolution

By using unicode characters catimg will try to display pictures in higher resolution. You can force the resolution with the `-r` option.

![cats](https://cloud.githubusercontent.com/assets/664177/10267481/da74d106-6a96-11e5-937d-efd452e53170.png)
![catslow](https://cloud.githubusercontent.com/assets/664177/10267494/07464a48-6a97-11e5-813e-0645f56b4c4f.png)

## Differences between Script and C version

Script version is **way more** accurate concerning colors but **considerably**
slower.

## Contributing

I'm open to any contributions that helps `catimg`! If you find bugs, please
create an issue or do a pull request :smile:.

## License

[MIT](http://opensource.org/licenses/MIT)