cli + tui to publish to leaflet (wip) & manage tasks, notes & watch/read lists 🍃
desertthunder.dev
charm
leaflet
readability
golang
1---
2title: TV Shows
3sidebar_label: TV Shows
4description: Track long-form series with simple queue management.
5sidebar_position: 4
6---
7
8# TV Shows
9
10TV commands live under `noteleaf media tv`. Like movies, they use Rotten Tomatoes search so you can trust the spelling and canonical links.
11
12## Add Shows
13
14```sh
15noteleaf media tv add "Breaking Bad"
16```
17
18- Inline mode shows up to five matches and asks you to choose.
19- `-i/--interactive` is wired up for the future list selector.
20
21Every new show starts as `queued`.
22
23## List the Queue
24
25```sh
26noteleaf media tv list # queued shows
27noteleaf media tv list --watching # in-progress series
28noteleaf media tv list --watched # finished shows
29noteleaf media tv list --all # everything
30```
31
32Output includes the ID, title, optional season/episode numbers (once those fields are set), status, critic-score snippet, and timestamps.
33
34## Update Status
35
36Use semantic verbs instead of editing the status manually:
37
38```sh
39noteleaf media tv watching 8 # Moved to “currently watching”
40noteleaf media tv watched 8 # Mark completed
41noteleaf media tv remove 8 # Drop from the queue entirely
42```
43
44Each transition records `last_watched` so you know when you left off. Future releases will expose explicit season/episode commands; until then store quick reminders in a linked note:
45
46```markdown
47### TV checklist
48- TV #8 — resume Season 3 Episode 5
49- TV #15 — waiting for new season announcement
50```
51
52## Organization Tips
53
54- Use `noteleaf media tv list --watching | fzf` to pick tonight’s episode.
55- Pipe `--all` into `rg "HBO"` to filter on the metadata snippet that contains the network/URL.
56- Include `TV #ID` references in your weekly review note so you can jump back with a single ID lookup.
57
58## What Gets Stored
59
60- Rotten Tomatoes critic info plus canonical URL (inside the Notes column).
61- Optional season/episode integers for future episode tracking (already part of the schema).
62- Added timestamps and “last watched” timestamps.
63
64Because shows can last months, keeping the queue short (just what you plan to watch soon) makes the `list` output far easier to scan.