video2x

A machine learning-based video super resolution and frame interpolation framework. Est. Hack the Valley II, 2018.

19,827 stars C++ Markdown Skills API Spec #anime4k#frame-interpolation#machine-learning#neural-networks
AI Prompts & Specs

Repository: k4yt3x/video2x


Stars: 19492

README.md

<p align="center">
<img src="https://github.com/user-attachments/assets/5cd63373-e806-474f-94ec-6e04963bf90f"
alt="Video2X: A machine learning-based video super resolution and frame interpolation framework."/>
</br>
<img src="https://img.shields.io/github/v/release/k4yt3x/video2x?style=flat-square"/>
<img src="https://img.shields.io/github/downloads/k4yt3x/video2x/total?style=flat-square"/>
<img src="https://img.shields.io/github/license/k4yt3x/video2x?style=flat-square"/>
<img src="https://img.shields.io/github/sponsors/k4yt3x?style=flat-square&link=https%3A%2F%2Fgithub.com%2Fsponsors%2Fk4yt3x"/>
<img src="https://img.shields.io/badge/dynamic/json?color=%23e85b46&label=Patreon&query=data.attributes.patron_count&suffix=%20patrons&url=https%3A%2F%2Fwww.patreon.com%2Fapi%2Fcampaigns%2F4507807&style=flat-square"/>
</p>

๐ŸŒŸ Version 6.0.0

Video2X 6.0.0 highlights:

- Complete rewrite of the Video2X project in C/C++.
- Faster and more efficient architecture.
- Cross-platform support for Windows and Linux.
- Vastly improved output quality.
- New GUI and installer for easy setup on Windows.

<details>
<summary>Click to see more details</summary>

Version 6.0.0 is a complete rewrite of this project in C/C++. It:

- genuinely works this time, with much less hassle compared to the 5.0.0 beta;
- is blazing fast, thanks to the new optimized pipeline and the efficiency of C/C++;
- is cross-platform, available now for both Windows and Linux;
- offers significantly better output quality with Anime4K v4, Real-ESRGAN, Real-CUGAN, and RIFE;
- supports two modes: filtering (upscaling) and frame interpolation;
- supports Anime4K v4 and all custom MPV-compatible GLSL shaders;
- supports Real-ESRGAN, Real-CUGAN, and RIFE (all models) via ncnn and Vulkan;
- requires zero additional disk space during processing, just space for the final output.

</details>

!6.4.0-screenshot

๐Ÿ–ฅ๏ธ Hardware Requirements

Your system must meet the minimum hardware requirements below to run Video2X.

- CPU
- The precompiled binaries require CPUs with AVX2 support.
- Intel: Haswell (Q2 2013) or newer
- AMD: Excavator (Q2 2015) or newer
- GPU
- The GPU must support Vulkan.
- NVIDIA: Kepler (GTX 600 series, Q2 2012) or newer
- AMD: GCN 1.0 (Radeon HD 7000 series, Q1 2012) or newer
- Intel: HD Graphics 4000 (Q2 2012) or newer

๐ŸชŸ Install on Windows

Download the Latest Windows Installer Executable (6.4.0)

You can download the latest Windows release on the releases page. For basic GUI usage, refer to the documentation. If you're unable to download directly from GitHub, try the mirror site. The GUI currently supports the following languages:

- English (United States)
- ็ฎ€ไฝ“ไธญๆ–‡๏ผˆไธญๅ›ฝ๏ผ‰
- ๆ—ฅๆœฌ่ชž๏ผˆๆ—ฅๆœฌ๏ผ‰
- Portuguรชs (Portugal)
- Franรงais (France)
- Deutsch (Deutschland)

๐Ÿง Install on Linux

Video2X packages are available for the Linux distros listed below. A universal AppImage is also available for other distros. If you'd like to build it from source code, refer to the PKGBUILD file for a general overview of the required dependencies and commands.

- Arch Linux: AUR packages, maintained by @K4YT3X.
- aur/video2x
- aur/video2x-git
- aur/video2x-qt6
- aur/video2x-qt6-git
- Arch Linux (Chinese Mainland): archlinuxcn packages, maintained by @Integral-Tech.
- archlinuxcn/video2x
- archlinuxcn/video2x-git
- archlinuxcn/video2x-qt6
- archlinuxcn/video2x-qt6-git
- Other distros: Video2X-x86_64.AppImage on the releases page.

๐Ÿ“ฆ Container Image

Video2X container images are available on the GitHub Container Registry for easy deployment on Linux and macOS. If you already have Docker/Podman installed, only one command is needed to start upscaling a video. For more information on how to use Video2X's Docker image, please refer to the documentation.

๐Ÿ“” Google Colab

You can use Video2X on Google Colab for free if you don't have a powerful GPU of your own. You can borrow a powerful GPU (NVIDIA T4, L4, or A100) on Google's server for free for a maximum of 12 hours per session. Please use the free resource fairly and do not create sessions back-to-back and run upscaling 24/7. This might result in you getting banned. You can get Colab Pro/Pro+ if you'd like to use better GPUs and get longer runtimes. Usage instructions are embedded in the Colab Notebook.

๐Ÿ’ฌ Telegram Discussion Group

Join our Telegram discussion group to ask any questions you have about Video2X, chat directly with the developers, or discuss super resolution, frame interpolation technologies, or the future of Video2X in general.

๐Ÿ“– Documentation

Comprehensive documentation for Video2X is available at https://docs.video2x.org/. It offers detailed instructions on how to build, install, use, and develop with this program.

๐Ÿ“ฝ๏ธ Video Demos (Outdated)

!Spirited Away Demo\
_Upscale demo: Spirited Away's movie trailer_

- Spirited Away: YouTube | Bilibili
- 360P to 4K
- The original video's copyright belongs to ๆ ชๅผไผš็คพใ‚นใ‚ฟใ‚ธใ‚ชใ‚ธใƒ–ใƒช
- Bad Apple!!: YouTube | Bilibili
- 384P 30 FPS to 4K 120 FPS with waifu2x and DAIN
- The original video's copyright belongs to ใ‚ใซใ‚‰
- The Pet Girl of Sakurasou: YouTube | Bilibili
- 240P 29.97 to 1080P 60 FPS with waifu2x and DAIN
- The original video's copyright belongs to ASCII Media Works

Standard Test Clip

The following clip can be used to test if your setup works properly. This is also the standard clip used for running performance benchmarks.

- Standard Test Clip (240P) 4.54 MiB
- Real-CUGAN Upscaled Sample (1704P) 3.5 MiB
- Real-ESRGAN Upscaled Sample (1704P) 3.1 MiB
- waifu2x Upscaled Sample (1080P) 4.54 MiB
- Ground Truth (1080P) 22.2 MiB

The original clip came from the anime "ใ•ใใ‚‰่˜ใฎใƒšใƒƒใƒˆใชๅฝผๅฅณ."\
Copyright of this clip belongs to ๆ ชๅผไผš็คพใ‚ขใƒ‹ใƒ—ใƒฌใƒƒใ‚ฏใ‚น.

โš–๏ธ License

This project is licensed under GNU AGPL version 3.\
Copyright (C) 2018-2025 K4YT3X and contributors.

!AGPLv3

This project includes or depends on these following projects:

| Project | License |
| ------------------------------------------------------------------------------------- | --------------- |
| FFmpeg/FFmpeg | LGPLv2.1, GPLv2 |
| Tencent/ncnn | BSD 3-Clause |
| bloc97/Anime4K | MIT License |
| nihui/realcugan-ncnn-vulkan | MIT License |
| nihui/rife-ncnn-vulkan | MIT License |
| xinntao/Real-ESRGAN-ncnn-vulkan | MIT License |

More licensing information can be found in the NOTICE file.

๐ŸŒบ Special Thanks

Special thanks to the following individuals for their significant contributions to the project, listed in alphabetical order.

- @ArchieMeng
- @BrianPetkovsek
- @Integral-Tech
- @ddouglas87
- @lhanjian
- @nihui
- @sat3ll