mirror of https://github.com/guillaumemeyer/watermarks-remover.git synced 2026-08-22 13:11:57 +02:00

Files

T

275a087a07 feat: audio/video AI/C2PA metadata stripping (MP4/MOV, WAV, MP3) (#139 )

The file-cleaners layer covered 15 formats -- all image, document, or
text -- and zero audio/video. That gap gets more expensive every month:
Sora, Veo, ElevenLabs, and Suno all embed provenance through the same
mechanisms image generators do, just in different containers.

New av_meta.py adds inspect/clean for:
- MP4/MOV/M4A/M4V: top-level C2PA (jumb/c2pa box) and XMP (uuid box)
  detection/stripping reuse inspect_isobmff()/strip_isobmff() from
  image_meta.py unchanged -- that's exactly the mechanism the C2PA spec
  defines for ISOBMFF-family containers, already proven for AVIF/HEIC.
  moov/udta (where generator/tool tags live) is handled separately since
  it's MP4-specific.
- WAV: RIFF LIST INFO chunk + embedded id3 chunk.
- MP3: ID3v2 frames, per-frame for v2.3/v2.4, whole-tag fallback for
  v2.2 (3-byte frame IDs are detected but not decomposed, so a partial
  rewrite is never attempted there).

Every box/chunk/frame is either kept byte-identical or dropped whole --
nothing does a partial in-place rewrite of a payload, so a container can
never come out semantically mangled. Default strip_all_metadata=True
matches this project's existing default (privacy-first: drop everything,
--keep-non-ai-metadata narrows to only AI-flagged content), same as the
image cleaners.

Wired through the full dispatch stack so the feature isn't a half
integration: format_dispatch.py (new "av" Kind), inspect_file.py /
clean_file.py (--as av), audit_lib.py (so audit_dir.py's CI/SARIF path
and the pre-commit hooks from #135 both cover audio/video too), and
server.py (HTTP /inspect and /clean).

Closes #134

Co-authored-by: Guillaume Meyer (The Opinionated Man) <1385518+guillaumemeyer@users.noreply.github.com>

2026-08-18 07:47:43 -07:00

3.5 KiB

Raw Permalink Blame History

Contributing to watermarks-remover

Thanks for helping keep the skill accurate and the cleaners reliable. The project is a small Python skill (skills/remove-ai-marks/) plus tests — focused PRs land fastest.

Who can do what

Action	Who
Open issues	Anyone
Suggest a release	Anyone (use the Release suggestion issue template)
Open pull requests	Anyone (fork the repo)
Approve and merge pull requests	Maintainer only (`@guillaumemeyer`)

main is protected. A change needs a pull request, a passing CI check (test), and an approving review from the code owner before merge. Only the maintainer can give that approval. Direct pushes to main are blocked for non-admins.

To suggest a release without a code change: open a Release suggestion issue.

Prerequisites

Python 3.10+ (stdlib only for the skill scripts; optional rewrite backends use HTTP to local Ollama / OpenAI-compatible endpoints)
From the repo root: python3 -m pytest -q should pass before you open a PR
Optional for manual file checks: c2patool, exiftool (PDF)

Layout

Path	Role
`skills/remove-ai-marks/SKILL.md`	Agent skill entry (workflow, ethics) — remote client over HTTP
`skills/remove-ai-marks/references/`	Vendors, mark classes, matrix, ethics
`service/scripts/`	Layer A/B hooks + image/container cleaners + `server.py` HTTP service
`service/Dockerfile*`	Container images (core + optional backends)
`compose.yaml`	Local full-stack bring-up
`tests/`	Pytest suite and fixtures
`.github/workflows/ci.yml`	CI job `test`
`.github/workflows/release-images.yml`	GHCR image publishing on `v*` tags

Layers (what to change where)

Layer A (Unicode / format controls) — deterministic scripts under service/scripts/ (text_unicode.py, clean_text.py, inspect_text.py). Prefer tests with fixtures in tests/fixtures/.
Layer B (statistical rewrite) — guidance in SKILL.md plus optional rewrite_text.py (print-prompt default; ollama / openai-compatible). No bundled model. Keep ethics-aware.
Files (C2PA / EXIF / XMP / props) — image_meta.py (PNG/JPEG/AVIF/HEIC/...), container_meta.py (SVG/PDF/DOCX/ODT/HTML/MD), av_meta.py (MP4/MOV/WAV/MP3), unified inspect_file.py / clean_file.py. Preserve document body / pixels / waveform; strip provenance metadata only.

Checklist for a change

Behaviour matches SKILL.md / references/removal-matrix.md when relevant
Unit tests updated or added under tests/
python3 -m pytest -q passes
Docs updated (README and/or skill references) if user-facing behaviour changes
No drive-by refactors unrelated to the fix or feature

PR expectations

Stay focused and match existing style (stdlib-first scripts, clear CLI flags)
Do not commit secrets, private user files, or large binary fixtures unless needed and redacted
Respect references/ethics.md: this tool is for content the user owns

Questions? Open an issue describing the input type (text / image / document) and which layer failed or is missing.

Community

Code of Conduct — expected behaviour in the project
Security policy — how to report vulnerabilities privately
Bug report and feature request templates

3.5 KiB Raw Permalink Blame History