/Anime4K-GUI

GUI application for Anime4K shaders which allows to save upscaled video to disk

Primary LanguageGo

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

  • Anime upscaling using the Anime4K shaders.
  • Saving upscaled videos to disk rather than real-time preview.
  • User-friendly graphical interface for easy operation; no command-line usage is required.
  • HDR compatibility
  • Support for most popular video encoders: H.264, H.265, AV1 (CPU based or GPU accelerated)
  • Hardware acceleration with NVIDIA (CUDA + NVENC), AMD (OpenCL + AMF).
  • Compatibility with multiple audio and subtitles streams
  • Support for various video formats: MP4, AVI, and MKV (both input and output).
  • Quick and hassle-free installation.

System Requirements

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

  • Windows 10 or later, 64-bit (While the application may function on older versions, it is neither tested nor officially supported).
  • A powerful GPU such as a GTX 970/AMD equivalent, or newer models. For older hardware, the application will still function, but upscaling may require significantly more time.
  • Knowledge about various Anime4K shaders modes - please read documentation. This will allow you to get better results of upscaling.

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

  • Ethan for most of the required FFMPEG knowledge and research.
  • bloc97 for Anime4K shaders.
  • AllenDang for Giu framework.
  • BtbN for automated FFMPEG builds.
  • OpenAI for ChatGPT, which was helpful in creating this README :)

Contribute

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

Screenshot