http-catlog

Monitor logs and display cat images when HTTP errors are detected 🐱

Watch your logs and get adorable cat images from http.cat displayed right in your terminal whenever HTTP error status codes are detected.

Installation

Using Cargo

cargo install http-catlog

From source

git clone https://github.com/Justhiro55/catlog
cd catlog
cargo install --path .

Usage

Pipe mode

tail -f /var/log/nginx/access.log | catlog

File watch mode

catlog -f /var/log/app.log

Command execution mode

catlog -e "tail -f /var/log/app.log"

Options

catlog [OPTIONS]

• -f, --follow <FILE> - Follow a file (like tail -f)
• -e, --exec <COMMAND> - Execute a command and monitor its output
• --size <N> - Image width in terminal characters (default: 60)
• --no-image - Don't display images (text only)
• --all - Show cats for all status codes
• --status <CODES> - Comma-separated list of specific status codes
• -h, --help - Print help
• -V, --version - Print version

Examples

Monitor nginx access logs:

tail -f /var/log/nginx/access.log | catlog

Watch application logs:

catlog -f app.log

Monitor with specific status codes only:

echo "Error 404 Not Found" | catlog --status 404,503

Execute command and monitor:

catlog -e "docker logs -f mycontainer"

Text-only mode (no images):

tail -f /var/log/app.log | catlog --no-image

Show cats for all HTTP status codes:

catlog -f app.log --all

Terminal Compatibility

Image display has been tested on terminals like iTerm2 and Kitty, but has not been fully verified on other terminals. Image quality may vary depending on your terminal emulator's capabilities.

License

Licensed under either of MIT or Apache-2.0 at your option. See LICENSE for details.

Credits

Cat images are provided by https://http.cat.