mikigal / Anime4K-GUI

GUI application for Anime4K shaders which allows to save upscaled video to disk
75 stars 6 forks source link
anime anime-upscaling anime4k cnn computer-graphics convolutional-neural-networks denoising-algorithms esrgan ffmpeg mpv neural-networks real-esrgan super-resolution upsampling upscaling video video-processing

Anime4K-GUI

This application is designed to enhance the resolution of anime videos using the Anime4K shaders by bloc97, with the ability to save the upscaled version to disk. It offers a straightforward and user-friendly graphical interface, eliminating the need for command-line interactions. Under the hood, the application leverages the power of FFMPEG to handle video processing seamlessly.

Unlike the original Anime4K project, this application allows you to save the enhanced anime as higher-quality video files rather than real-time preview.

Table of Contents

Features

System Requirements

Before installing and running the application, ensure that your system meets the following requirements:

Currently, NVIDIA graphics cards should be most stable as most tests were did with it.
Intel GPUs are not supported
If you have compatibility problems please create an issue with application logs and your computer's specification.

In the future we plan to add support for Linux and macOS (Intel and Apple Silicon).

Usage

Follow these steps to use the Anime4K-GUI:

  1. Download the Latest Release

    • Visit the Releases section on the GitHub repository.
    • Download the latest release zip file.
    • Unzip the downloaded archive and start the application.
  2. Add Your Anime

    • Drag and drop your input videos into the application's window.
  3. Select Upscaling Settings

    • Target settings: Output file resolution - keep in mind to select a resolution with an aspect ratio corresponding with input files. Keep in mind that some 4:3 anime may be saved in a 16:9 ratio with included black bars.
    • Shaders mode: Shaders used for upscaling. Each has some positive and negative effects and should be used in different cases.
      Please read Anime4K documentation before use.
    • Compression level: Compression level of the output file. If you don't care about the output file size, always keep this setting to Low.
      Higher level will cause worse quality
    • Encoder: Encoder used for encoding output file. If you have low-end graphics card CPU-based encoders may be faster.
      AV1 is best pick as it provides the best quality.
      AV1 with GPU acceleration is compatible only RTX4000/RX 6500XT and newer GPUs Even CPU-based is as fast as H264 with GPU acceleration
    • Output format: Format for the output file - MP4 has best support on most devices.
    • Compatibility mode: check it only if you have compatibility issues.
    • Debug mode: show more detailed logs, useful for troubleshooting and debugging
  4. Upscale the Video

    • Click the "Start" button to begin the upscaling process.
    • Be patient. You can check speed and current time progress per file in bottom corner.
    • Output files will be saved in the input file's directory with "_upscaled" suffix in the name.

Troubleshooting

If you encounter issues while using the application, please consult the Issues section on the GitHub repository to check for solutions or report problems.
To get more detailed logs run application with --debug parameter or enable Debug Mode in settings.
Firstly try using CPU-based encoding. For some reason GPU acceleration may not work correctly with your graphics card. Due to limited access to hardware, most tests were done with NVIDIA graphics cards; compatibility with other GPUs may be worse. If you have compatibility problems with your GPU, please create an issue with application logs and your computer's specifications.
Issues regarding low output quality will be instantly closed. Problems like that are related to the original Anime4K shaders - I can recommend trying other shaders mode settings.

FFMPEG Distribution

Due to GitHub maximum file limit I can not provide FFMPEG's binaries in this repository. If you want to compile project by yourself you have to download FFMPEG build here and put ffmpeg.exe and ffprobe.exe into resources/ffmpeg directory

Limitations

  1. If your input file contains subtitles streams you must use MKV as output format due to other formats limitations
  2. HDR videos are supported only with AV1 output codec

Special Thanks

Contribute

Contributions are welcome! If you'd like to improve the application or report issues, please create a Pull Request.

Screenshot