{"id":14128598,"url":"https://github.com/jonhoo/superimposer","last_synced_at":"2025-07-14T20:38:26.584Z","repository":{"id":57472344,"uuid":"246144538","full_name":"jonhoo/superimposer","owner":"jonhoo","description":null,"archived":false,"fork":false,"pushed_at":"2023-05-21T00:56:15.000Z","size":16,"stargazers_count":85,"open_issues_count":0,"forks_count":5,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-07-08T22:05:07.614Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jonhoo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2020-03-09T21:20:47.000Z","updated_at":"2024-03-06T18:03:10.000Z","dependencies_parsed_at":"2022-08-30T17:02:03.696Z","dependency_job_id":"fd833535-c5a2-450a-84a4-5eac2f519ed4","html_url":"https://github.com/jonhoo/superimposer","commit_stats":{"total_commits":14,"total_committers":1,"mean_commits":14.0,"dds":0.0,"last_synced_commit":"f6de39f2284cd59722bc21aa069e6096605fbb8b"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/jonhoo/superimposer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonhoo%2Fsuperimposer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonhoo%2Fsuperimposer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonhoo%2Fsuperimposer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonhoo%2Fsuperimposer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jonhoo","download_url":"https://codeload.github.com/jonhoo/superimposer/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonhoo%2Fsuperimposer/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265344887,"owners_count":23750570,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-15T16:01:53.695Z","updated_at":"2025-07-14T20:38:26.522Z","avatar_url":"https://github.com/jonhoo.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# Superimposer — combine presentation videos with slides\n\n**You have**: pdf slides and a video of you talking about them.\n\n**You want**: a video of your slides with you in the corner.\n\n**You need**: superimposer.\n\nSo, you presented something, and now have a recording of it, that's\nawesome! But the slides are hard to read, or got cropped out somehow,\nand you want to fix that. Fear not, superimposer has you covered! Just\ntell it what slide to display when, point it at your slides and your\nvideo, and it will generate a new video for you with the slides front\nand center, and your video tucked away nicely in a corner.\n\nTo get up and running, you first need the video file for your\npresentation (let's say it's `presentation.mp4`) and a PDF file with\nyour slides (let's say it's `slides.pdf`). Then, create a file called\n`transitions.txt` and write:\n\n```\n00:00 1\n```\n\nYou probably get the gist here. Play through your presentation, and\nevery time you change slides, write down a new line with the current\ntimestamp (the `O` hotkey in `mpv` is handy here) and the desired slide\nnumber. When you're done, run:\n\n```console\n$ superimposer presentation.mp4 slides.pdf superimposed.mp4\n```\n\nThis will eventually kick off `ffmpeg`, which will take a while to\nencode your video. When it's done, `superimposed.mp4` should have what\nyou want!\n\nSuperimposer takes a bunch of handy command-line arguments to tweak the\noutput. Run `superimposer --help` to see them. If you're using H.264,\nyou may want to consider also giving:\n\n```console\n-- -tune stillimage\n```\n\nIf you are significantly resizing the camera video, you may want to\n[change the scaling algorithm](https://superuser.com/a/375726/77846)\nwith:\n\n```console\n-- -sws_flags lanczos\n```\n\n## Requirements\n\n - `ffmpeg` and `ffprobe` (usually installed with [`ffmpeg`](https://ffmpeg.org/))\n - `pdftoppm` (part of [Poppler](https://poppler.freedesktop.org/))\n\n## Normalizing audio\n\nIf your audio is sad, try [`ffmpeg-normalizer`] with something like:\n\n```console\n$ ffmpeg-normalize superimposed.mp4 -o superimposed-normalized.mp4 -c:a aac\n```\n\n## Hardware acceleration\n\nYou can pass additional parameters to the ffmpeg encoder by placing them\nafter `--` in the argument list to `superimposer`. You'll probably want\nto read up on [hardware acceleration in ffmpeg], and maybe the [ffmpeg\nVAAPI encoding docs].\n\n## Examples\n\nHere are some examples of what the resulting video looks like:\n\n[![Demystifying unsafe code](https://img.youtube.com/vi/QAz-maaH0KM/sddefault.jpg)](https://www.youtube.com/watch?v=QAz-maaH0KM)\n[![Considering Rust](https://img.youtube.com/vi/DnT-LUQgc7s/sddefault.jpg)](https://www.youtube.com/watch?v=DnT-LUQgc7s)\n\n  [hardware acceleration in ffmpeg]: https://trac.ffmpeg.org/wiki/HWAccelIntro\n  [ffmpeg VAAPI encoding docs]: https://trac.ffmpeg.org/wiki/Hardware/VAAPI#Encoding\n  [`ffmpeg-normalizer`]: https://github.com/slhck/ffmpeg-normalize\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjonhoo%2Fsuperimposer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjonhoo%2Fsuperimposer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjonhoo%2Fsuperimposer/lists"}