The Getaway is an interactive narrative‑driven archive that stores videos, screenshots, transcripts, and user‑generated notes from the “Getaway” series of events. Over the past year users have reported three major pain points:
| Pain Point | Impact | Desired Outcome | |------------|--------|-----------------| | Scattered content – assets are buried under generic folder names (e.g., “misc_2021”). | Users waste time locating relevant clips; drop‑off rate ↑ 18 % on deep‑dive sessions. | A semantic, tag‑driven archive that surfaces the right material instantly. | | No version history – when assets are re‑uploaded, older versions disappear. | Loss of provenance; legal/creative teams can’t audit changes. | Immutable versioning with clear diffs and roll‑back capability. | | Limited collaboration – comments are only plain text and cannot be attached to specific timestamps. | Teams cannot discuss exact moments; decisions take longer. | Rich, time‑coded annotations with threaded discussion and permission controls. |
The Archive Enhancer addresses all three issues while keeping the existing “Getaway” UI familiar to power users. missax190421alexisfawxarchivethegetaway better
All components follow the existing “Getaway” design system (rounded corners, dark‑mode support).
| Persona | Need | |---------|------| | Alex – Content Curator | Quickly find all footage of a specific character or location across seasons. | | Sam – Legal / Compliance Lead | Prove which version of a clip was used in a public release. | | Riley – Story‑Designer | Drop a note at 01:23:45 of a video to suggest a script tweak and discuss with the team. | | Jordan – New Intern | Get on‑boarding quickly; discover assets without learning cryptic folder structures. | Asset Detail Page
| Method | Endpoint | Description | Request Body | Response |
|--------|----------|-------------|--------------|----------|
| POST | /api/v1/assets | Upload new asset (file + optional manual tags) | multipart/form-data (file, tags[]) | asset_id, version_id |
| GET | /api/v1/assets/id | Get asset detail (tags, latest version) | – | Asset object |
| GET | /api/v1/assets/id/versions | List all versions | – | [AssetVersion] |
| POST | /api/v1/assets/id/versions/ver_id/restore | Restore selected version as latest | – | Updated Asset |
| POST | /api/v1/annotations | Create new annotation | asset_id, timestamp_ms, type, content, visibility, parent_id? | Annotation object |
| GET | /api/v1/annotations?asset_id=... | Fetch all annotations for an asset (optionally filter by visibility) | – | [Annotation] |
| GET | /api/v1/search | Global search with filters | Query params: q, type, tags, date_from, date_to, author | SearchResult (hits, facets) |
| POST | /api/v1/migration/run | Trigger migration (admin only) | source_path, dry_run:boolean | status, log_url |
All endpoints require an Authorization: Bearer <jwt> header. MediaInfo (free tool):
MediaInfo (free tool):
FFmpeg (command line):
ffmpeg -i yourfile.mp4 → shows detailed stream info.