art

README

ART

Personal CLI tool for logging books, movies, TV shows, and games. Mostly made for myself.

Named after my favorite character from the Murderbot Diaries.

Features

• Log and list books, movies, TV shows, and games with ratings and reviews
• Search and fetch metadata from external APIs:
  • TMDB for movies and TV shows
  • OpenLibrary for books
  • RAWG for games
• Works without internet — falls back to manual entry
• Interactive terminal forms via Charm
• Star ratings (1–5) with optional review comments
• JSON output (--json) for all list commands
• Pager support via $PAGER (falls back to /usr/bin/less)
• Logs stored in a single TOML file

Install

Requires Go 1.26+.

make install

By default installs to /usr/local/bin. Override with PREFIX:

make install PREFIX=~/.local

Usage

art [command]

Commands

Command	Description
books add	Log a book
books list	List logged books
books check	Find entries missing details
movies add	Log a movie
movies list	List logged movies
movies check	Find entries missing details
tv add	Log a TV show season
tv list	List logged TV shows
tv check	Find entries missing details
games add	Log a game
games list	List logged games
games check	Find entries missing details
init	Set up config (API keys, paths)
config	Display current configuration
edit	Open logs file in $EDITOR

Global flags

• --debug — Debug output
• --json — Output in JSON
• --config <path> — Custom config file path

Command aliases

• books / book
• movies / movie / film / films
• tv / shows / show
• games / game

Configuration

Run art init to create the config file at ~/.config/art/config.toml:

tmdb-api-key = "your_tmdb_key"
rawg-api-key = "your_rawg_key"
logs = "/path/to/logs.toml"

The TMDB API key is required for movies and TV shows. The RAWG API key is optional but needed for game metadata. OpenLibrary requires no API key.

TODO

• Traveled: Travel
  • add
  • list
  • import
  • Work without internet
  • Entries missing details
• Dry-run command: --dry-run, -n
• Use $PAGER when listing more items that fit on screen
  • Fallback is /usr/bin/less