desertthunder.dev / noteleaf
cli + tui to publish to leaflet (wip) & manage tasks, notes & watch/read lists 🍃
charm leaflet readability golang
fork atom
noteleaf / website / docs / media / overview.md
at main 2.9 kB view raw view code

Media Tracking Overview#

Noteleaf keeps book, movie, and TV data next to your tasks and notes so you do not need a separate “watch list” app. All media commands hang off a single entry point:

noteleaf media <book|movie|tv> <subcommand>
  • Books pull metadata from the Open Library API.
  • Movies/TV scrape Rotten Tomatoes search results to capture critic scores and canonical titles.
  • Everything is stored in the local SQLite database located in your data directory (~/.local/share/noteleaf on Linux, ~/Library/Application Support/noteleaf on macOS, %LOCALAPPDATA%\noteleaf on Windows).

Lifecycle Statuses#

Type Statuses Notes
Books queued, reading, finished, removed Progress updates automatically bump status (0% → queued, 1-99% → reading, 100% → finished).
Movies queued, watched, removed Marking as watched stores the completion timestamp.
TV queued, watching, watched, removed Watching/watched commands also record the last watched time.

Statuses control list filtering and show up beside each item in the TUI.

Metadata That Gets Saved#

  • Books: title, authors, Open Library notes (editions, publishers, subjects), started/finished timestamps, progress percentage.
  • Movies: release year when available, Rotten Tomatoes critic score details inside the notes field, watched timestamp.
  • TV: show title plus critic score details, optional season/episode numbers, last watched timestamp.

You can safely edit the generated markdown/notes in your favorite editor—the records keep pointing to the updated files.

Interactive vs Static Workflows#

All list commands default to a simple textual table. For books you can pass -i/--interactive to open the Bubble Tea list browser (TV and movie interactive selectors are planned). Inside the list view:

  • j/k or arrow keys move between entries.
  • / starts search across titles, authors, and metadata.
  • v opens a focused preview.
  • ? shows all shortcuts.

If you prefer scripts, combine the static lists with tools like rg or jq.

Storage Layout#

Media records live in the SQLite database (noteleaf.db). Binary assets are not downloaded; the metadata stores canonical URLs so you can jump back to the source at any time. Use noteleaf status to see the exact paths for your database, data directory, and configuration file.