Files
shotdeck/README.md
T
Claude Fable 5 3fb9b504f4 feat(capture): choose what to capture — area, window, browser page or screen
Capture is now a decision, not a hidden setting. The popover shows a four-way scope control with the target named under it (800 x 600 on Display 1, the frontmost window, the front browser window, the whole display), and the window header carries the same choice beside the verbs. Picking Window or Browser hides Redline, dims the screen, names the app under the pointer and highlights its window; a click captures exactly that window, Escape cancels, and the desktop highlights the whole screen. New Session is one click: the current captures stay in their own folder, a fresh session opens, and the area picker comes straight up with the saved area pre-selected — Return keeps it, a drag replaces it. Settings is consolidated into one door (the popover gear, plus Cmd-,): what to capture, saved area, shortcut, ask-on-new-session, sending, session age limit, and a new Updates group with automatic install (on by default; installs only when nothing is unsent). The footer filler and the extra-actions menu are gone.
2026-11-01 11:47:58 +04:00

98 lines
4.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Redline
A macOS menu-bar app that captures a remembered screen region, builds a one-screenshot-per-page PDF, AirDrops it to an iPad for markup, then watches for the annotated file to come back.
## What Capture takes
Four scopes, chosen in the popover (or the window's capture menu) and kept with the session:
- **Area** — the saved rectangle. `Choose Area…` picks a new one at any time.
- **Window** — the window under the pointer. Redline hides itself, dims the screen, names
the app under the cursor and highlights its window; click to capture it, Escape cancels.
- **Browser** — the front browser window (Safari, Chrome, Edge, Brave, Arc, Firefox,
Vivaldi, Opera).
- **Screen** — the whole display your saved area is on.
Window and Browser capture a single window, so nothing overlapping it ends up in the shot.
## Hotkeys
- **⌥⇧1** — pick a new region, then capture it.
- **⌥⇧2** — capture the remembered region instantly (no picker).
## Where things live
Two surfaces, two jobs:
- **Menu-bar popover** — only the current session: its review details on one line, its
pages, then Capture, Send, New Session, Open Redline, and one status line when
something happened. Nothing else, so it never scrolls.
- **Redline window** (Open Redline) — the workspace: every session in a sidebar grouped
by day, the selected session's pages in the middle, and its review details, PDF facts
and session facts in the inspector. History, text entry and file facts live here
because they need room and a window that stays open.
- **Settings** — one door: the gear in the popover header, or ⌘,. Capture, sending,
- sessions and updates all live there.
- **Updates are automatic.** A downloaded update installs the next time nothing is
- waiting to be sent; turn it off in Settings › Updates.
## Sessions
Every review is a session. Captures go into the open session; "New Session" closes it
and keeps it in the sidebar, named and dated, whether or not it was sent.
- **New Session** keeps the current captures in their own folder, starts a fresh
- session, and immediately asks where to capture (Return keeps the saved area, a drag
- picks a new one). Turn that question off in Settings › Capture.
- **Nothing is deleted by default.** A session is kept until you delete it.
- **Settings > Sessions > Delete after** sets an age limit (7 days … 1 year). Sessions
older than the limit are removed on the next launch and by **Clean up now**.
Only Redline's own saved screenshots are removed; a PDF that was already sent stays
in the folder it was sent to.
- **Review details** (inspector) record what is being reviewed: lane/environment, the
deployed build, the commit, the reviewer (pre-filled with this Mac's user) and a free
note. A new session inherits the previous session's details, and past sessions show
them read-only.
## Files and PDF metadata
The PDF is named
```
Redline-<yyyyMMdd-HHmm>-<LANE>-<SHORTID>.pdf (lane recorded)
Redline-<yyyyMMdd-HHmm>-<SHORTID>.pdf (no lane)
```
`yyyyMMdd-HHmm` is Dubai time, `LANE` is the upper-cased lane ("OMS test lane" →
`OMS-TEST-LANE`), and `SHORTID` is the session's 8-character id, so two sessions in the
same minute never collide.
Each page carries a two-line reference footer (tool + build time + session; lane,
deployed build, commit, reviewer, note), and the PDF's document info carries the same
values as Author and Keywords — a page printed or returned weeks later still says what
it referred to.
## Screen Recording permission
On first launch macOS asks once for Screen Recording. Grant it at **System Settings > Privacy & Security > Screen Recording**. You never have to do this again as long as the app is not re-signed with a different identity.
The grant is bound to the bundle identifier `ai.flowmaster.shotdeck` plus the code signature. Changing either one forces a fresh prompt.
## Build
```bash
swift build && swift test
./scripts/build-app.sh # signed .app for daily use
./scripts/install-local.sh # install it into /Applications and relaunch
```
## Verification scripts
```bash
./scripts/render-panels.sh /tmp/redline-panels # headless PNGs of every panel + a sample PDF
./scripts/run-selftest.sh panel # real panel, real spool, PDF + retention checks
```
Both run against isolated temporary storage and an isolated preference suite, so they
never touch the real Application Support folder or your saved settings.