Repository navigation
feat(video): blur faces in a copy of a video for sharing - #699
Merged
Merged
Conversation
A person can ask for a copy of a video with every face, the unnamed ones or chosen ones blurred. ffmpeg draws a blur over each face track's boxes over time, as a heavy background step (blur_faces) that respects quiet hours; the copy is kept as an attachment beside the asset, and an owner can have visitors play it instead of the original (members keep the original; a missing copy is never replaced by the faces). API, MCP tools and a one-click button in the People tab with the job's progress. Off until asked. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01QFUNzy1QZy5HhKAyJxTAYJ
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Requested by Adeel · project thread
Description
Before: a video's faces could be pixelated only in still pictures; sharing a video meant sharing everyone's face in it.
After: from a video's People tab (one button, with the job's progress), the API or MCP, a person can ask for a copy with faces blurred: every face, only the unnamed ones, or the tracks they pick. ffmpeg blurs each face track's boxes over time as a heavy background step (
blur_faces) that respects quiet hours. The copy is kept as an attachment beside the asset, "Faces blurred", and the original is never changed.An owner can then have visitors (public pages, embeds, share links, IIIF and podcast feeds) play the copy instead of the original. Members keep the original. If the copy is missing, visitors get a 404 rather than the faces. All of this is off until someone asks.
Motivation and Context
Personal feature plan: share videos without exposing people's faces.
Types of changes
!in the title)Checklist:
make hookschecks it on commit).docs/accordingly.changelog.d/blur-faces.md, per build(release): changelog fragments in changelog.d/ instead of one Unreleased section #581.Done questions (AGENTS.md)
POST/GET /resources/{rid}/blur-faces,PUT .../blur-faces/visitors; MCPget_face_blur,blur_faces,set_face_blur_for_visitors.make openapi).Local CI:
pytest tests/api/test_face_blur.py tests/api/test_jobs.py tests/api/test_mcp.py tests/api/test_photo_map.py tests/api/test_iiif.py(51 passed), ruff, mypy, jestface-blur.test.ts+__tests__/recording*(167 passed),tsc --noEmit,ci/check_requirements.py,ci/validate_threat_model.pyall clean; OpenAPI regenerated with no drift.Generated by Claude Code