cli + tui to publish to leaflet (wip) & manage tasks, notes & watch/read lists 🍃
desertthunder.dev
charm
leaflet
readability
golang
1---
2title: Media Overview
3sidebar_label: Overview
4description: Manage reading lists and watch queues from the CLI.
5sidebar_position: 1
6---
7
8# Media Tracking Overview
9
10Noteleaf keeps book, movie, and TV data next to your tasks and notes so you do not need a separate “watch list” app.
11All media commands hang off a single entry point:
12
13```sh
14noteleaf media <book|movie|tv> <subcommand>
15```
16
17- **Books** pull metadata from the Open Library API.
18- **Movies/TV** scrape Rotten Tomatoes search results to capture critic scores and canonical titles.
19- 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).
20
21## Lifecycle Statuses
22
23| Type | Statuses | Notes |
24| ------ | ------------------------------------------ | ------------------------------------------------------------------------------------------------- |
25| Books | `queued`, `reading`, `finished`, `removed` | Progress updates automatically bump status (0% → `queued`, 1-99% → `reading`, 100% → `finished`). |
26| Movies | `queued`, `watched`, `removed` | Marking as watched stores the completion timestamp. |
27| TV | `queued`, `watching`, `watched`, `removed` | Watching/watched commands also record the last watched time. |
28
29Statuses control list filtering and show up beside each item in the TUI.
30
31## Metadata That Gets Saved
32
33- **Books**: title, authors, Open Library notes (editions, publishers, subjects), started/finished timestamps, progress percentage.
34- **Movies**: release year when available, Rotten Tomatoes critic score details inside the notes field, watched timestamp.
35- **TV**: show title plus critic score details, optional season/episode numbers, last watched timestamp.
36
37You can safely edit the generated markdown/notes in your favorite editor—the records keep pointing to the updated files.
38
39## Interactive vs Static Workflows
40
41All `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:
42
43- `j/k` or arrow keys move between entries.
44- `/` starts search across titles, authors, and metadata.
45- `v` opens a focused preview.
46- `?` shows all shortcuts.
47
48If you prefer scripts, combine the static lists with tools like `rg` or `jq`.
49
50## Storage Layout
51
52Media 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.
53Use `noteleaf status` to see the exact paths for your database, data directory, and configuration file.