Skip to content

About

macOS app for DV and Digital8 recording-date extraction, timestamp overlays, and viewing copies using DVRescue and FFmpeg.

Topics

Resources

Contributing

Security policy

Stars

1 star

Watchers

1 watching

Forks

Repository files navigation

DVMetaDataBurnIn

A free, open-source macOS application for preserving the recording context of legacy DV and Digital8 video. It brings DV recording-date extraction, timestamp presentation, batch processing, and verification into one workflow using DVRescue and FFmpeg.

Recommended established release: v1.0.6 (published as beta) · Train demonstration: original and processed videos · Preservation roadmap

Active experimental development: maintenance/1.0.7 · Preview 2 download and corresponding source · tests and known limitations. Preview 2 includes the output-safety and field-signaling fixes, traceable source-built tools, and OFL fonts. Stable application source remains v1.0.6 on main.

Current maintenance source restores the original UAV OSD Mono, UAV OSD Sans Mono and VCR OSD Mono fonts. This correction is not in the unchanged preview 2 download; build from the maintenance branch to use it.

The train demonstration includes the complete supplied DV AVI, the owner's timestamped MP4, and separately identified maintenance-generated comparisons. Downloadable hashes, measured stream properties, genuine before/after frames, and reproduction commands make the results inspectable.

What it does

  • Processes existing DV AVI files individually or in batches, with a folder queue.
  • Extracts embedded camcorder recording date/time through DVRescue.
  • Burns date/time into viewing copies or creates an MKV with switchable ASS subtitles.
  • Offers DV stream-copy MOV derivatives, H.264 viewing copies, and deinterlacing settings.
  • Provides a macOS interface around the processing tools, which are bundled with the app.

Keep the original capture as the reference. A DV-copy MOV is a derivative; it is not automatically a verified preservation master. A timestamp overlay makes selected information visible but does not preserve every original metadata field. MP4 and H.264 MKV exports are lossy viewing copies. See the measured distinctions and limitations.

Direct tape capture is planned, not available in this application. DV/Digital8 and later HDV capture have separate hardware, software, and acceptance prerequisites in the roadmap.

Platform and maintenance status

The stable 1.0.6 package contains an Intel/Apple Silicon app executable, but bundled FFmpeg and DVRescue are Intel-only. The 1.0.7 preview package is Intel-only throughout. The project/package minimum is macOS 12; native build evidence is Intel macOS 14 with Xcode 15.4. Apple Silicon operation and translation of the bundled tools remain unvalidated; an arm64 app slice alone does not establish compatibility.

The separate 1.0.7 maintenance preview improves subtitle-tail timing, temporary workspace isolation, batch error handling, and cancellation cleanup. Maintenance remains experimental. Its 1.0.7 application changes remain on maintenance for owner testing; main retains the stable 1.0.6 application code plus the shared documentation, licensing, videos, and roadmap. No maintenance code is approved for stable integration yet. GUI, player, and Apple Silicon acceptance are still open. The published train videos retain their original preview 1 provenance; fresh preview 2 CLI checks are recorded separately.

Maintenance status and remaining acceptance separates historical synthetic tests/native builds from current real-footage measurements. GUI queues/Stop, player rendering, subjective audio and motion quality, and Apple Silicon acceptance remain open. File selection and progress reporting still need further work. Preview 2 includes atomic final publication and H.264 field signaling fixes. Publication currently requires a destination filesystem supporting hard links (APFS/HFS+); unsupported filesystems fail safely.

Use and build

Choose the application ZIP from the linked release’s Assets, rather than GitHub’s automatically generated source archives. Extract it and move DVMetaDataBurnIn.app to Applications. Bundled FFmpeg and DVRescue require no separate installation. For Preview 2, download SHA256SUMS.txt and verify the ZIP with shasum -a 256 against its entry; the manifest and dependency source archive are available on the same release. Historical packages do not all have application checksums.

Download and extract the application, select a DV AVI file or folder, choose the output and timestamp settings, and run processing into a separate destination. The maintenance preview is ad-hoc signed rather than notarized. Use macOS's normal app-opening controls for software you trust.

Open DVMetaDataBurnIn.xcodeproj in full Xcode and build the DVMetaDataBurnIn scheme. For a command-line development build, select your installed full Xcode for that command; Command Line Tools alone cannot build the app:

DEVELOPER_DIR="/path/to/Xcode.app/Contents/Developer" xcodebuild -project DVMetaDataBurnIn.xcodeproj -scheme DVMetaDataBurnIn -configuration Debug -derivedDataPath .build/DerivedData CODE_SIGNING_ALLOWED=NO build

See contribution guidelines, security reporting, development notes and developer test scenarios. On the maintenance branch, run the automated tests with zsh Resources/scripts/dev/test_all.zsh; this runner is not present on main. VS Code and Xcode can use the same checkout; no separate project architecture is needed.

The optional real-footage verifier accepts explicit file paths and existing FFmpeg/ffprobe/DVRescue tools. It does not download videos or add them to default tests. Instructions and hash-pinned downloads are in the train demonstration.

Report a successful test or discrepancy using the community validation guide. The verified project status summarizes evidence, platform limits and open acceptance checks.

Screenshots

The bundled choices are UAV OSD Mono, UAV OSD Sans Mono and VCR OSD Mono.

Main application window

Alternate view · Font picker · Font examples

Credits and licenses

  • DVRescue: embedded DV metadata analysis; by MIPoPS and MediaArea contributors.
  • FFmpeg: decoding, filtering, encoding, and container handling.
  • UAV OSD Mono and UAV OSD Sans Mono: Nicholas Kruse, used and redistributed with express permission. VCR OSD Mono: Riciery Leal (MrManet). See the bundled notices.

The application uses the MIT License. See third-party licenses and source materials. Historical FFmpeg source delivery remains open in #194; Preview 2 supplies source for its different replacement executable.

About

macOS app for DV and Digital8 recording-date extraction, timestamp overlays, and viewing copies using DVRescue and FFmpeg.

Topics

Resources

Contributing

Security policy

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages