mirror of
https://github.com/k4yt3x/video2x.git
synced 2024-12-29 16:09:10 +00:00
211 lines
8.5 KiB
Markdown
211 lines
8.5 KiB
Markdown
# Video2X Lossless Video Enlarger
|
|
|
|
### Official Discussion Group (Telegram): https://t.me/video2x
|
|
|
|
## Prerequisites
|
|
|
|
Component names that are **bolded** are mandatory.
|
|
|
|
Component names that are *italicized* can be automatically downloaded and configured with the `video2x_setup.py` script.
|
|
|
|
1. Operating System: Windows
|
|
1. AMD GPU / Nvidia GPU
|
|
1. AMD GPU driver / Nvidia GPU driver / Nvidia CUDNN
|
|
1. [***FFMPEG***](https://ffmpeg.zeranoe.com/builds/)
|
|
1. [***waifu2x-caffe***](https://github.com/lltcggie/waifu2x-caffe/releases) / [**waifu2x-converter-cpp**](https://github.com/DeadSix27/waifu2x-converter-cpp/releases)
|
|
|
|
## Recent Changes
|
|
|
|
### 2.6.0 (March 9, 2019)
|
|
|
|
- Complete redesign of configuration file format. The configuration file is now much more flexible and easy to look at.
|
|
- Various modifications done to the rest of the program to adapt to the changes made in the configuration file. This eliminated some problems existed in the previous version.
|
|
|
|
### 2.5.0 (March 4, 2019)
|
|
|
|
- Added progress bar according to @ArmandBernard 's suggestion.
|
|
- Cache folders are now created under `'{}\\video2x'.format(tempfile.gettempdir())` by default, and the default key for cache folder location in configuration file has been changed to `video2x_cache_folder`. This makes it easier to manage cache folders.
|
|
- Cache folders are now more likely to be deleted successfully even if the program crashes. This is made possible with more try-catch blocks.
|
|
- Updated FFMPEG stream migration grammar according to @cr08 's suggestions. All streams (including attachment streams) will now be copied over to the new video.
|
|
- A lot of minor upgrades and adjustments.
|
|
|
|
### 2.4.3 (February 26, 2019)
|
|
|
|
- Fixed the bug where ffmpeg arguments (hwaccel) are not passed on to ffmpeg.
|
|
|
|
### 2.4.2 (February 26, 2019)
|
|
|
|
- Added the function to detect insufficient GPU memory.
|
|
- Added the function to create temporary folders automatically.
|
|
- Fixed configuration file path error.
|
|
|
|
## Description
|
|
|
|
Video2X is an automation software based on waifu2x image enlarging engine. It extracts frames from a video, enlarge it by a number of times without losing any details or quality, keeping lines smooth and edges sharp.
|
|
|
|
For short: **Video2X enlarges your video without losing details**
|
|
|
|
Watch for the sharper edges in this screenshot around the shadows:
|
|
|
|
|
|
|
|
**You can also watch the YouTube video Demo: https://www.youtube.com/watch?v=PG94iPoeoZk**
|
|
|
|
Clip is from trailer of animated movie "千と千尋の神隠し". Copyright belongs to "株式会社スタジオジブリ (STUDIO GHIBLI INC.)". Will delete immediately if use of clip is in violation of copyright.
|
|
|
|
## Screenshot
|
|
|
|
|
|
## Installation
|
|
|
|
### Prerequisites
|
|
|
|
- **Python 3**
|
|
Download: https://www.python.org/downloads/windows/
|
|
- **FFMPEG Windows Build**
|
|
Download: https://ffmpeg.org/download.html
|
|
- **waifu2x-caffe for Windows**
|
|
Download: https://github.com/lltcggie/waifu2x-caffe/releases
|
|
- **waifu2x-converter-cpp**
|
|
Download: https://github.com/DeadSix27/waifu2x-converter-cpp/releases
|
|
|
|
### Install Dependencies
|
|
|
|
First, clone the video2x repository.
|
|
|
|
```bash
|
|
$ git clone https://github.com/K4YT3X/video2x.git
|
|
$ cd video2x/bin
|
|
```
|
|
|
|
Then you may run the `video2x_setup.py` script to install and configure the depencies automatically. This script is designed and tested on Windows 10.
|
|
|
|
This script will install `ffmpeg`, `waifu2x-caffe` to `%LOCALAPPDATA%\\video2x` and all python libraries.
|
|
|
|
```bash
|
|
$ python video2x_setup.py
|
|
```
|
|
|
|
Alternatively, you can also install the dependencies manually. Please refer to the prerequisites section to see what's needed.
|
|
|
|
Then you'll need to install python dependencies before start using video2x. Install simply by executing the following command.
|
|
|
|
```bash
|
|
$ pip install -r requirements.txt
|
|
```
|
|
|
|
## [Step-By-Step Tutorial](https://github.com/K4YT3X/video2x/wiki/Step-By-Step-Tutorial) (Nvidia GPUs)
|
|
|
|
For those who want a detailed walk-through of how to use `Video2X`, you can head to the [Step-By-Step Tutorial](https://github.com/K4YT3X/video2x/wiki/Step-By-Step-Tutorial) wiki page. It includes almost every step you need to perform in order to enlarge your first video. This tutorial currently only includes instructions for Nvidia GPUs, since AMD GPUs (OpenCL) requires installation of `waifu2x-converter-cpp` which cannot be installed automatically with Python at the moment due to its 7z compression format.
|
|
|
|
## [Waifu2X Drivers](https://github.com/K4YT3X/video2x/wiki/Waifu2X-Drivers)
|
|
|
|
Go to the [Waifu2X Drivers](https://github.com/K4YT3X/video2x/wiki/Waifu2X-Drivers) wiki page if you want to see a detailed description on the different types of `waifu2x` drivers implemented by `Video2X`. This wiki page contains detailed difference between different drivers, and how to download and set each of them up for `Video2X`.
|
|
|
|
## Quick Start
|
|
|
|
**Note that all command line arguments/options overwrite configuration file settings.**
|
|
|
|
### Sample Videos
|
|
|
|
If you can't find a video clip to begin with, or if you want to see a before-after comparison, we have prepared some sample clips for you. The quick start guide down below will also be based on the name of the sample clips.
|
|
|
|
|
|
|
|
- [Sample Video Original (240P) 1.7MB](https://files.flexio.org/Resources/Videos/sample_input.mp4)
|
|
- [Sample Video Upscaled (1080P) 4.8MB](https://files.flexio.org/Resources/Videos/sample_output.mp4)
|
|
|
|
Clip is from anime "さくら荘のペットな彼女". Copyright belongs to "株式会社アニプレックス (Aniplex Inc.)". Will delete immediately if use of clip is in violation of copyright.
|
|
|
|
### Nvidia CUDA (waifu2x-caffe)
|
|
|
|
Enlarge the video to 1920x1080 using CUDA. You may also use the `-r/--ratio` option.
|
|
|
|
```bash
|
|
$ python video2x.py -i sample_input.mp4 -o sample_output.mp4 -m gpu --width=1920 --height=1080
|
|
```
|
|
|
|
### Nvidia CNDNN
|
|
|
|
Enlarge the video to 1920x1080 using CUDNN. You may also use the `-r/--ratio` option.
|
|
|
|
```bash
|
|
$ python video2x.py -i sample_input.mp4 -o sample_output.mp4 -m cudnn --width=1920 --height=1080
|
|
```
|
|
|
|
### AMD or Nvidia (waifu2x-converter-cpp OpenCL)
|
|
|
|
Enlarge the video by 2 times using OpenCL. Note that `waifu2x-converter-cpp` doesn't support width and height. You'll also have to explicitly specify that the driver to be used is `waifu2x_converter`.
|
|
|
|
```bash
|
|
$ python video2x.py -i sample_input.mp4 -o sample_output.mp4 -m gpu -r 2 -d waifu2x_converter
|
|
```
|
|
|
|
Corresponding sample configuration is shown below. Note that the `waifu2x_path` is different from the configuration for `waifu2x-caffe`. Instead of the binary path, folder containing extracted `waifu2x-converter-cpp.exe` should be specified.
|
|
|
|
### CPU
|
|
|
|
Enlarge the video to 1920x1080 using the CPU. You may also use the `-r/--ratio` option. This is potentially much slower than using a GPU. The configuration file for this method is similar to the previous methods.
|
|
|
|
```bash
|
|
$ python video2x.py -i sample_input.mp4 -o sample_output.mp4 -m cpu --width=1920 --height=1080
|
|
```
|
|
|
|
# Full Usage
|
|
|
|
## General Options
|
|
|
|
### -h, --help
|
|
show this help message and exit
|
|
|
|
## File Input and Output
|
|
|
|
### -i INPUT, --input INPUT
|
|
Specify source video file/directory
|
|
|
|
### -o OUTPUT, --output OUTPUT
|
|
Specify output video file/directory
|
|
|
|
## Upscaler Options
|
|
|
|
### -m {cpu,gpu,cudnn}, --method {cpu,gpu,cudnn}
|
|
Specify upscaling method
|
|
|
|
### -d {waifu2x_caffe,waifu2x_converter}, --driver {waifu2x_caffe,waifu2x_converter}
|
|
Waifu2x driver
|
|
|
|
### -y {upconv_7_anime_style_art_rgb,upconv_7_photo,anime_style_art_rgb,photo,anime_style_art_y}, --model_type {upconv_7_anime_style_art_rgb,upconv_7_photo,anime_style_art_rgb,photo,anime_style_art_y}
|
|
Specify model to use
|
|
|
|
### -t THREADS, --threads THREADS
|
|
Specify number of threads to use for upscaling
|
|
|
|
### -c CONFIG, --config CONFIG
|
|
Manually specify config file
|
|
|
|
### --width WIDTH
|
|
Output video width
|
|
|
|
### --height HEIGHT
|
|
Output video height
|
|
|
|
### -r RATIO, --ratio RATIO
|
|
Scaling ratio
|
|
|
|
## License
|
|
|
|
Licensed under the GNU General Public License Version 3 (GNU GPL v3)
|
|
https://www.gnu.org/licenses/gpl-3.0.txt
|
|
|
|
|
|
|
|
(C) 2018-2019 K4YT3X
|
|
|
|
|
|
## Credits
|
|
|
|
This project relies on the following software and projects.
|
|
|
|
- [FFMPEG]('https://www.ffmpeg.org/')
|
|
- [waifu2x-caffe](https://github.com/lltcggie/waifu2x-caffe)
|
|
- [waifu2x-converter-cpp](https://github.com/DeadSix27/waifu2x-converter-cpp) |