# ponchio/untrunc

Restore a damaged (truncated) mp4, m4v, mov, 3gp video. Provided you have a similar not broken video.

Repository: https://github.com/ponchio/untrunc
Canonical: https://ross.abutalabs.com/products/ponchio-untrunc
Language: C++
License: GPL-2.0
License Family: copyleft
Last push: 2024-05-23T15:46:17+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 4857, "days_push": 832, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1947, forks 258 (observed 2026-08-28T04:05:57.924559+00:00)

## What it is
Untrunc is a command-line tool written in C++ that repairs damaged (truncated) MP4, M4V, MOV, 3GP video files and M4A audio files. It works by using an intact reference file from the same camera or app to reconstruct the broken file's metadata and recover playable content.

## Use cases
- repair a truncated mp4 video recorded on my phone
- fix a corrupted mov file from my camera
- recover a broken 3gp video that won't play
- restore a cut-off m4v recording
- fix a damaged m4a audio file
- untrunc a video whose metadata was lost mid-recording

## When to choose
- you have a working reference video from the same device or app
- your video is truncated mid-recording and unplayable
- you're comfortable using the command line and building from source

## When to avoid
- you have no intact reference file from the same source
- the video is corrupted in ways other than truncation
- you need a GUI-based repair tool
- you need a maintained tool with broad codec support beyond Libav 12

## Facets
- artifact type: cli-tool
- maturity: maintenance
- function: video-processing, cli, developer-tools
- domain: media, files
- platform: cli, cross-platform
- tags: video-repair, truncated-mp4, file-recovery, libav, data-recovery, video, command-line, linux, macos

## Member repositories
- ponchio/untrunc (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:57.924559+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:07:07.954859+00:00, confidence not recorded.
  - readme: https://github.com/ponchio/untrunc (fetched 2026-08-28T04:05:57.924559+00:00, sha 00f83ee0579f)
- Data as of 2026-08-30T08:39:29.467469+00:00.