Start with one file.

The MediaMeta guide. Find the controls, steps, and limits for the task you need to finish.

Installation & tools

The current test version is 0.2.0 / Build 82; public downloads are not available yet. The following installation notes apply to test packages from trusted sources. Intended for Macs with Apple silicon (M-series chips) running macOS 14 or later. Intel Macs are not supported. The minimum OS requirement does not mean every OS version has been tested.

Open the DMG, drag MediaMeta.app to Applications, then eject the disk image. Use trusted builds only. If macOS refuses to open it, do not disable protections, remove quarantine attributes, or bypass the warning.

The current test build bundles MediaInfoLib, ffprobe / ffmpeg, and AI / OCR models. No separate Python or media-tool installation is needed. Check tool status in Settings; advanced users can still explicitly configure trusted external tools.

Workspace & files

The media library is on the left, the player and persistent analysis pane in the middle, and Parameters / Check / Playback & sharing on the right. File / Compare / Batch parameter checks switch tasks; drag pane dividers to adjust the layout.

Click Add files or drop in files and folders, with multiple selection and recursive scanning. Search, filter, and sort the library; pause, cancel, or retry parsing. Removing a library entry does not delete its source file.

Each tab is an independent workspace: create, rename with a double-click, or close it. Templates are shared. Sessions restore and reparse files on restart. Unavailable files remain in the list and can be relinked; old check records are marked stale.

Independent Quick View windows

Open files in Quick View from Finder or the app and keep several independent windows. Each has its own playback and analysis session, with a file thumbnail, badge and name in the Dock; click a preview to return to its window. Temporary viewing does not add a file to a workspace; import it explicitly to add it to the library.

Return to a frame by number

The workbench and Quick View display video frame numbers and let you enter a number to seek. The index reads actual video sample timestamps rather than multiplying seconds by frame rate. When the index is available, it accommodates variable and fractional frame rates and trim offsets. Switching files or closing a window cancels an unneeded index.

Audio has no frame numbers. Incomplete or ambiguous timestamps, or a file exceeding the indexing limit, can make frame-number seeking unavailable; timecode and stepping remain available. An unavailable frame number does not establish file corruption.

Parameters & raw information

Select a file and start with Common in Parameters, then switch to All when needed. Browse container, video, audio, and subtitle groups; search parameters or open field explanations. Filenames and raw data are not translated.

Use More for raw JSON, a check reference, and other parameter actions. Confirm the export type and review filenames, tags, and raw fields before sharing.

Compare parameters or content

Add at least two local files in Compare and choose a baseline. Show differences only, adjust tolerances, or ignore fields. Codec aliases and units are normalized; resolve ambiguous track matches manually, and retain missing values as unknown.

Check picture and sound… asks whether selected content changed—not whether parameters match. Choose picture or sound, the range, and the mode, then run it explicitly using bundled FFmpeg. Save remote files locally first.

Decoded compares normalized decoded output; encoded is useful when only the container or index changed. Results apply to checked ranges, tracks, and modes. Different edits are not aligned automatically, and results do not rate visual quality, listening quality, or A/V synchronization.

Templates & batch parameter checks

In a parsed reference video’s Parameters → More, choose Use as check reference… to create a separate draft. Select matching fields, review values, tolerances, and track matching, then save before using it for checks.

In Batch parameter checks, choose a checklist and confirm whether to check the current file, selected files, or current tab. Review mismatches, review items, and unknowns first; expand passing items per file as needed. Edit, import, or export shared templates.

AI, OCR & moments to review

Switch between AI detection, OCR text recognition, and Markers & waveform below the player. Analysis stays alongside the picture and each tool retains its state, in the workspace or Finder Quick View.

Find frames with AI detection

  1. Select a local video or image. For video, choose a time range and sampling mode, select YOLO26 Nano or RF-DETR Nano, and start analysis. The models run locally without a cloud account.
  2. Boxes overlay COCO’s 80 categories, including people and vehicles. Video plays as analysis progresses and category timelines show matches. Select a timeline match or use Previous / Next to return to an actual matching frame.
  3. Filter classes, adjust confidence thresholds or draw a rectangular / polygonal ROI. Overlays, timelines, tracks and statistics update together; filtering does not reassociate detections or reassign track IDs. Match, detection and track counts are not unique person counts.
  4. Review the results in the player, set a range and export annotated frames or video with optional track IDs. Exports freeze the filters selected when they start. Results are review clues, not pass / fail judgments in a parameter checklist.

Review tracks without treating IDs as identity

Video analyses include a track list showing class, ID, first and last matches, observation count and state. Clicking a track seeks to its first actual matching frame under the current class, threshold and ROI filters. Cached results retain their original algorithm information and track IDs.

New analyses use a native TrackTrack adaptation without an algorithm selector. It omits appearance re-identification, global motion compensation and track post-processing from the full upstream pipeline; it is not proof of upstream equivalence or superior quality. IDs apply only within one analysis, not to identity recognition, unique person counts or cross-video association.

Locate text and time watermarks with OCR

Choose text or time watermark recognition, set a range and region, then run OCR. Text results lead to their frames. For clock watermarks, confirm the clock region before extraction and jump checks; review adjacent frames and compare the displayed clock with elapsed video time. Suspected jumps can also come from edits, speed changes, clock correction, or recognition errors—not proof of tampering.

Keep context with markers and waveforms

Record notes, ranges, and moments to revisit on the timeline. Export frames or selected clips as needed. A waveform is not a loudness, listening-quality, or complete audio assessment.

Technical checks & coverage

The current file’s Check area distinguishes technical checks, picture and sound checks, and parameter checklists. Inspect MP4 indexing and fragmentation, timelines, or decoding, with actual coverage, unknowns, and failures—not a whole-file guarantee.

Timeline and decoding checks use a bounded range by default; explicitly select the whole file when needed. Tool requirements and unknowns stay visible. Use evidence to locate problems; do not merge parameter compliance, decoding completion, and playback into one “pass.”

Playback, transfer & editing

Playback & sharing organizes parameter advice for playback, transfer, and editing. Local playback observations are separate from device and browser hints. Recognizing a file, advancing a timeline, or reaching the end does not prove correct audio, smoothness, color, or compatibility throughout.

Transfer estimates apply to the current file, selected files, or tab, with AirDrop, Wi-Fi, and 5G / 4G options. Times use adjustable assumed speeds, not measured throughput; unready files are excluded explicitly. Verify editing advice with a small clip, including picture, sound, and synchronization.

Pre-sharing checks & data flow

Pre-sharing checks read parser-provided metadata and track structure, such as location, device information, and additional or hidden tracks. They do not scan picture, faces, voices, or filenames, remove information, or generate a safe copy. No findings do not establish anonymity.

Local parsing, comparison, checks, AI, and OCR do not require media uploads. Explicit online link checks send requests to your chosen target. Worker process isolation is not an operating-system permissions sandbox.

The app uses Sentry diagnostics, enabled by default for new installs when configured, while preserving an explicit opt-out. Disable them in Settings. Events may be sent to an external service when enabled; the app is not entirely network-free or telemetry-free.

Feedback is sent only when you initiate it. Confirmation explains content, optional contact information, system / hardware context, and US processing. Media, screenshots, logs, and files are not attached automatically. SDK acceptance is not confirmed cloud receipt.

Choose & export reports

Select an available report type in Check: technical checks, picture and sound checks, or a parameter checklist. In-page and toolbar copy / export use the same selection. Unrun, running, or cleared records are not reports.

Technical reports retain executed diagnostic evidence; content reports retain ranges, tracks, coverage, and validity; checklists retain files, requirements, reference names, and actual check times. Export parameter and comparison reports in their available formats; some reports can be read offline.

Copy parameter advice exports parameter advice only, not pre-sharing checks, actual playback, browser checks, or transfer estimates. Frames and clips are separate evidence exports; no single report replaces all checks.

Developer tools & automation

Copy technical JSON with versions, units, and original fractions, export AVC configuration, or export diagnostics containing only executed results. Faststart provides a command for a new output file rather than automatically changing media; review it before running.

Export CI commands, JUnit, and machine-check JSON from batch checklists, and machine regression JSON from comparisons. Prepare trusted CLI tools on a macOS runner; unknown rules are not passes.

Explicit link checks observe one bounded Range response from a public HTTP(S) address, without saved credentials or following redirects. They do not certify CORS, sustained throughput, or playback, and are not a DNS-rebinding-safe fetcher. Offline browser checks use a local file selected in the target browser without uploading it.

Language, appearance & shortcuts

App Settings support System, Simplified Chinese, and English without resetting files, playback, comparisons, or template drafts. Filenames, raw fields, saved templates, and historical results are not automatically translated; rerun checks for new-language results.

Website language and appearance are independent of the app. Controls retain browser preferences, chapters, and query parameters. Without JavaScript, complete Chinese and English pages remain available and appearance follows the system.

  • ⌘O Add media; ⌘T New tab; ⌘W Close tab; ⌘⇧T Reopen the most recently closed tab.
  • ⌘F Search parameters; ⌘⇧D Compare / check; ⌘⇧R Batch parameter checks.
  • ⌘Z Undo removal; ⌘⌫ Remove selected library entries without deleting disk files.