Skip to content
Projects

munitkala/tapewake has 26 GitHub stars and 2 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-16 00:41 UTC. Last push 2026-11-08.

How these counts are measured

Measured star growth

in 24h
0
in 7 days
Update delayed
in 15 days
Update delayed
in 1 month
Update delayed

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

About

Restore old VHS and home videos on your own PC: QTGMC deinterlacing, AI upscaling, face and sound restoration. Free and open source, for Windows and MacOS.

Machine Learning

README.md

Original

tapewake

Local video restoration. Free and open source (MIT licence).

MIT licence Windows 10/11 and macOS 15+ NVIDIA GPU 8 GB or Apple Silicon 16 GB Version 0.2

tapewake restores old VHS and home videos on your own computer: it deinterlaces the tape, upscales it with AI, restores faces carefully, cleans up the sound, and gives you the restored film plus a before-and-after comparison. Videos that are already progressive, such as DVD rips, are restored without deinterlacing. Nothing is uploaded anywhere.

Before and after: a 1938 street scene, soft and interlaced on the left, sharper on the right

Latest update (November 2026)

Version 0.2.1 is out for Windows. What's new:

  • AMD and Intel graphics cards work now, not just NVIDIA. Upscaling runs on the card through DirectML. Face restoration still runs on the processor on those cards, so I'd turn it off for long videos for now.
  • First Windows release since 0.1.5, so the heat pause and the computer info in Settings from 0.2.0 are on Windows too.

The full list is in the changelog.

What it does

  • Restores home-video tapes (interlaced NTSC, 4:3) with settings proven on a full two-hour VHS tape: QTGMC deinterlacing, Real-ESRGAN upscaling to 1280×960 at 59.94 fps, face restoration that keeps likeness, gentle grain, and sound restoration.
  • Restores videos that are already progressive (DVD and Blu-ray rips, digital video) without deinterlacing, at their own frame rate and twice their size. It checks each video and picks the right mode.
  • Checks your settings before it starts, and explains any setting that can't work for that video.
  • Works piece by piece and can be paused and resumed at any time; finished parts are kept and checked. A restoration started by mistake can be stopped and deleted (three clicks, the original is never touched).
  • When a restoration finishes, it shows you the file and tidies up its working files.
  • Shows each restoration live, with a player that plays the finished parts next to the original (side by side, wipe, or hold-to-compare) and a filmstrip.
  • Pauses by itself if the computer gets too hot, and carries on once it has cooled down. A restoration you pause yourself stays paused.
  • Shows the computer it's running on (processor, graphics, memory, free space and how hot it is) under Settings → Performance.
The app's player showing the original and the restored video side by side Wipe view: a slider splits one frame between original and restored
Progress window with each step's bar and the time left A finished restoration with all steps complete and a button to open the video
The guided tour highlighting one part of the app with a short explanation Lab tab listing the engine commands the app runs for a job

Windows or Mac

tapewake runs on both. The app and the restoration engine are the same; what's needed and how it's set up differ.

Windows Mac
Computer Windows 10 (2004 or later) or 11, 64-bit Apple Silicon (M1 or later), macOS 15 or later
Graphics NVIDIA card with 8 GB or more; AMD and Intel cards with DirectX 12 work too (upscaling only, see README-windows.md) Built into the chip; 16 GB of memory or more
Not supported Graphics without DirectX 12 Intel Macs, Macs with 8 GB
Tested on A two-hour VHS tape Short clips
Read this README-windows.md README-macOS.md
Setting it up BUILDING.md BUILDING-macOS.md

Both need about 50 GB of free disk space per hour of tape while restoring, and patience: a restoration takes many times the length of the video. There's no installer to download yet, and the app doesn't install its tools for you yet, so for now it's for people comfortable setting things up by hand.

Status

Version 0.2.1. tapewake has two tested modes and picks the one that fits each video:

  • Home-video tape: interlaced NTSC tapes (29.97 fps). Deinterlaced to one frame per field (59.94 fps), then restored at 1280×960.
  • Progressive video: videos whose frames are already whole pictures, such as DVD and Blu-ray rips and digital video. No deinterlacing, the frame rate stays the same, and the picture is restored at twice its size. Face and sound restoration start off.

In both, you can switch Face restoration and Audio on or off. The other settings and presets (including Animation) don't change the restoration yet: tapewake says so and won't start until they're back at the tested values. Interlaced videos that aren't NTSC (for example PAL at 25 fps) can't be restored yet.

Progressive mode is new in 0.1.4 and has been tested on a short film clip with face restoration off; with face restoration on it hasn't been tested yet. Animated films can be restored in this mode, but they get the general upscaler and the light film grain meant for camera footage, which shows as a faint speckle on flat colours. A mode made for animation is planned.

The Mac version is new and has only restored short clips so far; see README-macOS.md for what hasn't been tested on a Mac yet.

What changed in each update is in CHANGELOG.md.

Releases

Windows and Mac share one codebase on main: the restoration engine, the interface and the tested settings are the same on both, so a fix to them reaches both. What's specific to each lives in its own files (README-windows.md and BUILDING.md, README-macOS.md, BUILDING-macOS.md and scripts/setup-macos.sh).

Each platform is released on its own, once it has been tested on that platform, with a tag of its own:

Platform Latest release Get it
Windows 0.2.1 git checkout windows-v0.2.1
Mac 0.2.0 git checkout macos-v0.2.0

main can be ahead of a platform's latest release with changes that haven't been tested on it yet. The changelog says which platforms each version was released for.

Disk space

About 50 GB per hour of tape at the peak, so about 100 GB for a two-hour tape. The working files can go on another drive. Most of them are deleted as the restoration goes; once it's finished, Free up space (or Finish in the prompt that appears) deletes the rest (about 30 GB per hour of tape), leaving only the restored video (about 17.5 GB per hour). See engine/README.md.

What's where

Path What it is
ui/index.html The whole interface, one file (HTML/CSS/JS, no framework)
src-tauri/ The desktop app (Tauri 2, Rust): window, file picker, the bridge to the engine
engine/tapewake_engine/ The restoration engine (Python), the same on Windows and Mac
engine/tapewake_engine/thermal.py Pauses a restoration when the computer gets too hot, and resumes it once it's cool
engine/app_bridge.py How the app talks to the engine
engine/presets/vhs-tested.json Every setting of the tested tape preset
engine/stubs/ Two tiny placeholder modules some model code imports (see THIRD_PARTY.md)
scripts/clean-engine.mjs Run by every build: keeps Python cache files out of the installer
scripts/setup-macos.sh Sets up everything the engine needs on a Mac
assets/ Logo
screenshots/ The pictures in the READMEs (macos/ for the Mac ones)
CHANGELOG.md What changed in each update
THIRD_PARTY.md Everything tapewake uses that it didn't write, and the licences

The engine also runs without the app: python engine/tapewake_engine/run.py <job file>.

Example footage

The example clip is from Amateur films: Ivan Besse collection, Britton, South Dakota 1938–39 (Part X), Prelinger Archives, via the Internet Archive (archive.org/details/sIvanBes1938_10), public domain.

Credits

tapewake builds on these open-source projects. Thank you to their authors. Each keeps its own licence. None of them is part of this repository, and their authors are not involved with tapewake.

Project Used for Licence
FFmpeg Reading, cutting and encoding video and sound GPL-3.0 (build used)
VapourSynth and vs-jetpack (QTGMC, DFTTest) Deinterlacing and denoising LGPL-2.1 / MIT
VapourSynth plugins: mvtools (mvutensils), znedi3, dfttest2, bestsource, akarin, resize2, zsmooth, vszip Parts of QTGMC GPL / LGPL / MIT
Real-ESRGAN weights Upscaling BSD-3-Clause
CodeFormer Finding, aligning and checking faces; optional face model S-Lab License 1.0 (non-commercial)
DicFace Face restoration S-Lab License 1.0 (non-commercial)
KEEP Face restoration (alternative) S-Lab License 1.0 (non-commercial)
Demucs Separating voices from noise MIT
DeepFilterNet Cleaning up voices MIT / Apache-2.0
Resemble Enhance Enhancing voices MIT
PyTorch and torchvision (RAFT) Running the AI models BSD-3-Clause
OpenCV, NumPy, SciPy, psutil Image and signal processing, process control Apache-2.0 / BSD
NVIDIA TensorRT (optional, Windows) Faster upscaling NVIDIA licence
ONNX Runtime with DirectML (optional, Windows) Upscaling on AMD and Intel cards MIT / Microsoft DirectML licence
Tauri The desktop app MIT / Apache-2.0
IBM Plex, Big Shoulders Display, Poppins Fonts SIL Open Font License

The face models (CodeFormer, DicFace, KEEP) may only be used for non-commercial purposes, so tapewake will stay free while it uses them. The full list with versions is in THIRD_PARTY.md.

About this project

tapewake is a hobby project. I first started writing it to restore my parents' wedding video, and it grew into something anyone can use for their own tapes. Part of the development was done with the help of Claude, an AI assistant. It's looked after in my spare time, so replies to issues and pull requests may take a while.

All the code in this repository was written for tapewake and is mine to release under the MIT licence. Other projects are only used, never copied in, and they're credited above. That said, this is a hobby project and I'm not an expert programmer, so I may have missed something obvious. I have no intention of including anything that isn't mine. If you spot code here that comes from somewhere else, please let me know by opening an issue, and I'll make sure it's credited and licensed properly, or remove it.

Before you use it

Please read this before restoring anything you care about.

  • No warranty. tapewake is free software provided "as is" (see LICENSE). You use it at your own risk. The authors aren't responsible for lost or damaged footage, damage to your computer, or anything else that happens from using it.
  • Keep your originals. tapewake never changes the source file, but always keep your original tapes and a copy of every file you restore.
  • Try a short clip first. A restoration takes hours or days, and the result depends on the video: tapewake adds sharpening and a light film grain, and animated films and progressive videos are newer and less tested than tapes (see Status). Restore a minute or two and check it before starting a whole film.
  • Restored footage is not the original. The AI upscaling and face restoration add detail that was never on the tape. Faces in particular can end up looking slightly different from the real person. Don't use restored footage as evidence or as an exact record of what happened, and say that it's been restored when you share it.
  • Only restore footage you have the right to use, and respect the privacy of the people in it. tapewake works entirely on your computer and doesn't upload anything.
  • Other people's licences apply. tapewake uses separately installed programs and AI models, each under its own licence (see THIRD_PARTY.md). You're responsible for following them. In particular the face models are non-commercial only: you can't use tapewake's face restoration for paid work, such as a restoration service, without permission from their authors.
  • It works your computer hard. A restoration keeps the graphics processor at full load for hours or days. Make sure your computer is well cooled, and don't leave it running somewhere a hot computer could be a problem. tapewake pauses if it gets too hot, but that's a safety net, not a reason to run it somewhere hot.
  • No affiliation. Names of other projects and products belong to their owners. Their authors don't endorse tapewake.
  • This section isn't legal advice. If you're unsure whether your use is allowed, ask someone qualified.

Contributing

Bug reports and pull requests are welcome, see CONTRIBUTING.md. Security problems: SECURITY.md.

Licence

MIT (see LICENSE). This covers tapewake's own files only, not the projects listed under Credits.