https://github.com/adamperkowski/kitget
Display and customize cat images in your terminal :3
https://github.com/adamperkowski/kitget
api cats cli fetcher kittens meme rust terminal
Last synced: about 2 months ago
JSON representation
Display and customize cat images in your terminal :3
- Host: GitHub
- URL: https://github.com/adamperkowski/kitget
- Owner: adamperkowski
- License: mit
- Created: 2025-04-12T12:12:37.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2025-04-12T13:36:13.000Z (about 2 months ago)
- Last Synced: 2025-04-12T13:44:14.048Z (about 2 months ago)
- Topics: api, cats, cli, fetcher, kittens, meme, rust, terminal
- Language: Rust
- Homepage:
- Size: 16.6 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# kitget
Display and customize cat images in your terminal :smirk_cat:
## Usage
| | |
|:----------------------------------|:----------------------------------|
|  |  |
|  |  |
### Fastfetch integration
You can use kitget directly with Fastfetch:
```bash
kitget --square | fastfetch --file-raw -
```
This might not work on terminals supporting images. Example Bash function (to use in your `~/.bashrc`) for Kitty:
```bash
ff() {
stamp="$(date +%s)"
kitget --square -o "/tmp/kitget-$stamp"
clear
fastfetch --kitty "/tmp/kitget-$stamp" "$@"
rm -f "/tmp/kitget-$stamp"
}
```
## Installation
Arch Linux
[kitget](https://aur.archlinux.org/packages/kitget) is available in the AUR.
It can be installed using an AUR helper (e.g. paru):
```bash
paru -S kitget
```
Cargo
For all systems supported by Rust, you can install kitget using Cargo:
```bash
cargo install kitget
```
Keep in mind that crates installed with `cargo install` have to be manually upgraded and may not be included in `$PATH` by default.
## Thanks to
- [Kevin Balicot](https://buymeacoffee.com/kevinbalicot) for the [Cat as a service API][cataas] (go give him money)
- [Sebaguardian](https://github.com/Sebaguardian) for mental support
[cataas]: https://cataas.com