Logging a viewing

“Log a viewing” in the header — reachable from every page — opens a quick two-step dialog without leaving where you are. Step one is finding the movie: type a title and, with an OMDb key set, search and pick the exact result before going any further, so the right title is locked in before anything else. Step two is everything else — date, start/end time, medium, and venue — with a “Back” to return to step one without losing what you’ve already filled in. Logging closes the dialog; you stay wherever you opened it from.

The /log page itself offers two other ways in, for cases the header dialog doesn’t cover.

Manually

Fill in the title, when you watched it, the medium, and optionally a venue. Both are picked from a list — the ones you’ve already added or logged with — or added right there via “Add medium”/“Add venue” (see the Venues page for what a venue captures). Cinema is always on the list, even before you’ve added anything: it’s the default for a viewing with no medium recorded at all. With an OMDb key set, the app looks up the title on save and fills in the poster, director, actors, genre, and ratings automatically.

If you’d rather pick the exact title yourself — a remake, a same-titled short, anything OMDb’s automatic lookup might guess wrong — use “Search OMDb” next to the Title field before saving. It opens a small popup to search OMDb and shows the same poster-and-year picker “Search OMDb” on a movie’s own details page uses (see “Fixing a wrong match” below); picking a candidate closes the popup, fills in Title, and that’s what gets attached when you log the viewing — no automatic lookup or later disambiguation needed.

From a Pathé booking email

This app doesn’t read emails. If you book cinema tickets through Pathé, log the booking with the command-line tool’s from-pathe-email command instead. It writes to the same calendar, so the viewing shows up here, booking number and all.

Editing and deleting

Once logged, a viewing can be edited or deleted from its own details page (click the title from the overview) — not from the overview row itself, which stays focused on browsing rather than doubling as an edit form.

Refreshing metadata

If a viewing was logged without OMDb enrichment (no key set at the time, or no confident match found), use “Refresh” on its details page, or “Refresh all metadata” on the overview to catch up every unmatched entry on the current page at once. If OMDb can’t confidently match a title — usually because of a typo, an alternate title, or too little to go on — you’ll see a picker with OMDb’s own search candidates (poster and year included) to choose the right one from, or you can continue without metadata and try again later.

Settings’ “More” list links to a Missing data page — every logged viewing missing an IMDb match, poster, director, actors, genre, or synopsis, filterable by which of those is missing. A gap there is usually the fastest way to spot a viewing worth refreshing.

Fixing a wrong match

“Refresh” only runs when a viewing has no metadata yet. If OMDb matched the wrong film entirely — a remake, a same-titled short, a typo that still happened to resolve to something — use “Search OMDb” on the details page instead. It’s available any time, defaults the search to the viewing’s current title, and lets you pick a different result from the same poster-and-year picker. Choosing one overwrites every OMDb-derived field (poster, director, actors, genre, ratings, synopsis), but never the viewing’s own logged title, venue, or watch time.