Merge pull request #434 from k4yt3x/black

Formatted code with Black and updated README

.github/ISSUE_TEMPLATE/bug-report.md

@@ -7,26 +7,20 @@ assignees: K4YT3X
 
 ---
 
-## Environment Information
+## Component Versions
 
-|Module|Version|
+Please at least fill in the release version and GUI or CLI version.
-|-|-|
+
-|`Video2X`||
+- **Video2X release version**:
-|`FFmpeg`||
+- **Upscaler version**:
-|`waifu2x-caffe`||
+- **GUI version**:
-|`waifu2x-converter-cpp`||
+- **CLI version**:
-|`waifu2x-ncnn-vulkan`||
 
 ## Symptom
 
-Briefly describe what's going on.
+In this section, briefly describe what's going on.
 
-## Screenshots or Error Messages
+## Error Log or Screenshots
 
-Please paste screenshots or error messages here.
+Please upload or paste the error log here. You may also include screenshots.
-Include as much details as you can, as this greatly helps debugging the problem.
+**It is highly recommended to include your error log.**
-
-Please paste your error message in the code block down below:
-
-```
-```

.github/ISSUE_TEMPLATE/feature_request.md

@@ -9,7 +9,7 @@ assignees: K4YT3X
 
 ## Description
 
-Briefly describe the feature you want to be added into `video2x`.
+Briefly describe the feature that you'd like Video2X to have.
 
 ## Sources
 

.github/workflows/codeql-analysis.yml

@@ -0,0 +1,54 @@
+name: "CodeQL"
+
+on:
+  push:
+    branches: [master, ]
+  pull_request:
+    # The branches below must be a subset of the branches above
+    branches: [master]
+  schedule:
+    - cron: '0 4 * * 5'
+
+jobs:
+  analyse:
+    name: Analyse
+    runs-on: ubuntu-latest
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v2
+      with:
+        # We must fetch at least the immediate parents so that if this is
+        # a pull request then we can checkout the head.
+        fetch-depth: 2
+
+    # If this run was triggered by a pull request event, then checkout
+    # the head of the pull request instead of the merge commit.
+    - run: git checkout HEAD^2
+      if: ${{ github.event_name == 'pull_request' }}
+
+    # Initializes the CodeQL tools for scanning.
+    - name: Initialize CodeQL
+      uses: github/codeql-action/init@v1
+      # Override language selection by uncommenting this and choosing your languages
+      # with:
+      #   languages: go, javascript, csharp, python, cpp, java
+
+    # Autobuild attempts to build any compiled languages  (C/C++, C#, or Java).
+    # If this step fails, then you should remove it and run the build manually (see below)
+    - name: Autobuild
+      uses: github/codeql-action/autobuild@v1
+
+    # ℹ️ Command-line programs to run using the OS shell.
+    # 📚 https://git.io/JvXDl
+
+    # ✏️ If the Autobuild fails above, remove it and uncomment the following three lines
+    #    and modify them (or add more) to build your code if your project
+    #    uses a compiled language
+
+    #- run: |
+    #   make bootstrap
+    #   make release
+
+    - name: Perform CodeQL Analysis
+      uses: github/codeql-action/analyze@v1

.github/workflows/nightly.yml

@@ -27,7 +27,7 @@ jobs:
         run: |
           python -m pip install -U pip
           pip install -U pyinstaller pywin32
-          pip install -U -r requirements-windows.txt
+          pip install -U -r requirements.txt
       - name: Build Video2X CLI
         run: |
           pyinstaller --noconfirm --log-level=WARN `

.gitignore

@@ -1,3 +1,6 @@
+# QtCreator
+video2x_gui.pyproject.user
+
 # PyCharm
 .idea/
 

Dockerfile

@@ -1,186 +1,31 @@
+# Name: Video2X Dockerfile
+# Creator: Danielle Douglas
+# Date Created: Unknown
+# Last Modified: January 14, 2020
+
+# Editor: Lhanjian
+# Last Modified: May 24, 2020
+
+# Editor: K4YT3X
+# Last Modified: June 13, 2020
+
+# using Ubuntu LTS 19.10
+# Ubuntu 20.x is incompatible with Nvidia libraries
 FROM ubuntu:19.10
-#FROM nvidia/cuda:10.1-cudnn7-devel-ubuntu18.04
-MAINTAINER Danielle Douglas <ddouglas87@gmail.com>
-MAINTAINER Lhanjian <lhjay1@foxmail.com>
-MAINTAINER K4YT3X <k4yt3x@k4yt3x.com>
 
-# Don't ask questions during image setup.
+# file mainainter labels
-ENV DEBIAN_FRONTEND noninteractive
+LABEL maintainer="Danielle Douglas <ddouglas87@gmail.com>"
-ENV NASM_VERSION 2.14
+LABEL maintainer="Lhanjian <lhjay1@foxmail.com>"
-ENV NVCODEC_VERSION 8.2.15.6
+LABEL maintainer="K4YT3X <k4yt3x@k4yt3x.com>"
-ENV PKG_CONFIG_PATH /usr/local/lib/pkgconfig
-ENV FFMPEG_VERSION 4.1.2
 
-# Install apt-fast, because we got gigs to download.
+# run installation
-RUN apt-get update && apt-get install -y apt-utils &&\
+RUN apt-get update \
-    apt-get install -y --no-install-recommends software-properties-common &&\
+    && apt-get install -y git-core \
-    add-apt-repository ppa:apt-fast/stable &&\
+    && git clone --recurse-submodules --progress https://github.com/k4yt3x/video2x.git /tmp/video2x/video2x \
-    add-apt-repository -y ppa:graphics-drivers/ppa &&\
+    && bash -e /tmp/video2x/video2x/src/video2x_setup_ubuntu.sh /
-    apt-get install -y --no-install-recommends apt-fast && apt-fast update
-
-
-## Install Video2X ##
-
-# Dependencies
-RUN apt-fast install -y --no-install-recommends git-core python3-pip python3-setuptools python3-wheel python3-psutil ffmpeg gcc g++ \
-    libc6-dev python3-dev libmagic-dev libmagic1 python3.8 nvidia-driver-440 nvidia-cuda-toolkit gnupg2 curl ca-certificates pkg-config \
-    autoconf libx264-dev libx265-dev libnuma-dev libvpx-dev libfdk-aac-dev libmp3lame-dev libopus-dev libass-dev libfreetype6-dev libgnutls28-dev \
-    libsdl2-dev libtool libva-dev libvdpau-dev libvorbis-dev libxcb1-dev libxcb-shm0-dev libxcb-xfixes0-dev texinfo wget yasm zlib1g-dev \
-    libass-dev libfreetype6-dev libsdl2-dev p11-kit libva-dev libvdpau-dev libvorbis-dev libxcb1-dev libxcb-shm0-dev libxcb-xfixes0-dev \
-    pkg-config texinfo wget zlib1g-dev libchromaprint-dev frei0r-plugins-dev gnutls-dev ladspa-sdk libcaca-dev libcdio-paranoia-dev libcodec2-dev \
-    libfontconfig1-dev libfreetype6-dev libfribidi-dev libgme-dev libgsm1-dev libjack-dev libmodplug-dev libmp3lame-dev libopencore-amrnb-dev \
-    libopencore-amrwb-dev libopenjp2-7-dev libopenmpt-dev libopus-dev libpulse-dev librsvg2-dev librubberband-dev librtmp-dev libshine-dev \
-    libsmbclient-dev libsnappy-dev libsoxr-dev libspeex-dev libssh-dev libtesseract-dev libtheora-dev libtwolame-dev libv4l-dev libvo-amrwbenc-dev \
-    libvorbis-dev libvpx-dev libwavpack-dev libwebp-dev libx264-dev libx265-dev libxvidcore-dev libxml2-dev libzmq3-dev libzvbi-dev liblilv-dev \
-    libopenal-dev opencl-dev libjack-dev libbluray-dev libfdk-aac-dev libmysofa-dev
-
-RUN curl -vfsSLO https://www.nasm.us/pub/nasm/releasebuilds/$NASM_VERSION/nasm-$NASM_VERSION.tar.bz2 \
-    && tar -xjf nasm-$NASM_VERSION.tar.bz2 \
-    && cd nasm-$NASM_VERSION \
-    && ./autogen.sh \
-    && ./configure \
-    && make -j$(nproc) \
-    && make install
-
-RUN git clone --recurse-submodules -b n$NVCODEC_VERSION --depth 1 https://git.videolan.org/git/ffmpeg/nv-codec-headers \
-    && cd nv-codec-headers \
-    && make install
-
-RUN curl -vfsSLO https://ffmpeg.org/releases/ffmpeg-$FFMPEG_VERSION.tar.bz2 \
-    && tar -xjf ffmpeg-$FFMPEG_VERSION.tar.bz2 \
-    && cd ffmpeg-$FFMPEG_VERSION \
-    && ./configure --enable-cuda-sdk --enable-cuvid --enable-nonfree --enable-libnpp --enable-nvenc \
-    --enable-gpl --enable-version3 \
-    --enable-small --enable-avisynth --enable-chromaprint \
-    --enable-frei0r --enable-gmp --enable-gnutls --enable-ladspa \
-    --enable-libass --enable-libcaca --enable-libcdio \
-    --enable-libcodec2 --enable-libfontconfig --enable-libfreetype \
-    --enable-libfribidi --enable-libgme --enable-libgsm --enable-libjack \
-    --enable-libmodplug --enable-libmp3lame --enable-libopencore-amrnb \
-    --enable-libopencore-amrwb --enable-libopencore-amrwb \
-    --enable-libopenjpeg --enable-libopenmpt --enable-libopus --enable-libpulse \
-    --enable-librsvg --enable-librubberband --enable-librtmp --enable-libshine \
-    --enable-libsnappy --enable-libsoxr --enable-libspeex \
-    --enable-libssh --enable-libtesseract --enable-libtheora \
-    --enable-libtwolame --enable-libv4l2 --enable-libvo-amrwbenc \
-    --enable-libvorbis --enable-libvpx --enable-libwavpack --enable-libwebp \
-    --enable-libx264 --enable-libx265 --enable-libxvid --enable-libxml2 \
-    --enable-libzmq --enable-libzvbi --enable-lv2 \
-    --enable-libmysofa \
-    --enable-openal --enable-opencl --enable-opengl --enable-libdrm \
-    --enable-libfdk-aac --enable-libbluray \
-    && make -j$(nproc) \
-    && make install
-
-# Install Nvidia Driver
-
-RUN curl -fsSL https://developer.download.nvidia.com/compute/cuda/repos/ubuntu1804/x86_64/7fa2af80.pub | apt-key add -
-
-RUN echo "deb https://developer.download.nvidia.com/compute/machine-learning/repos/ubuntu1804/x86_64 /" > /etc/apt/sources.list.d/nvidia-ml.list
-
-# Install Video2X
-RUN update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.7 1 && update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.8 2
-RUN  cd / && python3.8 -m pip install --upgrade pip &&\
-    git clone --recurse-submodules --progress https://github.com/k4yt3x/video2x.git --depth=1 &&\
-    python3.8 -m pip install avalon_framework colorama python-magic patool psutil pyqt5 pyunpack pyyaml requests tqdm
-
-# eg: docker build -t video2x . --build-arg driver=waifu2x_ncnn_vulkan
-ARG driver=all
-
-# Check if driver exists.
-SHELL ["/bin/bash", "-c"]
-RUN drivers=(all waifu2x_caffe waifu2x_converter waifu2x_ncnn_vulkan) &&\
-    case ${drivers[@]} in (*${driver,,}*) true ;; (*)\
-    echo "ERROR: Unrecognized driver." >&2 &&\
-    printf "%s " "Choices are: ${drivers[@]}" >&2 | printf "\n" >&2 &&\
-    exit 1 ;;\
-    esac
-
-RUN if [ "$driver" = "all" ] || [ "$driver" = "waifu2x_caffe" ] ; then \
-    # nagadomi/caffe prerequisites
-    apt-fast update &&\
-    apt-fast install -y --no-install-recommends build-essential cmake libboost-system-dev libboost-thread-dev libboost-filesystem-dev libboost-chrono-dev libboost-date-time-dev libboost-atomic-dev libboost-python-dev libprotobuf-dev protobuf-compiler libhdf5-dev liblmdb-dev libleveldb-dev libsnappy-dev libopencv-dev libatlas-base-dev python-numpy libgflags-dev libgoogle-glog-dev &&\
-    # nagadomi/waifu2x-caffee-ubuntu prerequisites
-    apt-fast install -y --no-install-recommends libboost-iostreams-dev;\
-    fi
-# build waifu2x-caffe && install caffe
-RUN if [ "$driver" = "all" ] || [ "$driver" = "waifu2x_caffe" ] ; then \
-    git clone --recurse-submodules --depth=1 --progress --recurse-submodules https://github.com/nagadomi/waifu2x-caffe-ubuntu.git &&\
-    cd waifu2x-caffe-ubuntu &&\
-    git clone --recurse-submodules --progress --depth=1 https://github.com/nagadomi/caffe.git;\
-    fi
-
-RUN if [ "$driver" = "all" ] || [ "$driver" = "waifu2x_caffe" ] ; then \
-    apt-fast install --no-install-recommends -y gcc-8 libcudnn7 libcudnn7-dev &&\
-    apt-get remove -y gcc g++ &&\
-    ln -s /usr/bin/gcc-8 /usr/bin/gcc && ln -s /usr/bin/g++-8 /usr/bin/g++ &&\
-    cd /waifu2x-caffe-ubuntu &&\
-    mkdir build &&\
-    cd build &&\
-    cmake .. -DCMAKE_INSTALL_PREFIX=/usr &&\
-    make -j$(nproc) install;\
-    fi
-
-RUN if [ "$driver" = "all" ] || [ "$driver" = "waifu2x_caffe" ] ; then \
-    # install waifu2x-caffe
-    cd /waifu2x-caffe-ubuntu/build &&\
-    cp waifu2x-caffe ../bin/ &&\
-    mv ../bin tempname &&\
-    mv tempname /video2x/ &&\
-    mv /video2x/tempname /video2x/waifu2x-caffe &&\
-    rm -rf ../waifu2x-caffe-ubuntu ;\
-    fi
-
-RUN if [ "$driver" = "all" ] || [ "$driver" = "waifu2x_ncnn_vulkan" ] ; then \
-    apt-fast install -y --no-install-recommends software-properties-common build-essential cmake libvulkan-dev glslang-tools libprotobuf-dev protobuf-compiler &&\
-    git clone --recurse-submodules --depth=1 --progress https://github.com/Tencent/ncnn.git &&\
-    cd ncnn &&\
-    mkdir -p build &&\
-    cd build &&\
-    cmake -DCMAKE_INSTALL_PREFIX=/usr -DNCNN_VULKAN=ON .. &&\
-    make -j$(nproc) install &&\
-    rm -rf ../../ncnn &&\
-    cd / &&\
-    # Compile waifu2x-ncnn-vulkan
-    git clone --recurse-submodules --depth=1 --progress https://github.com/nihui/waifu2x-ncnn-vulkan.git &&\
-    cd waifu2x-ncnn-vulkan &&\
-    mkdir -p build &&\
-    cd build &&\
-    cmake ../src &&\
-    make -j$(nproc) &&\
-    # Incall waifu2x-ncnn-vulkan
-    cd /waifu2x-ncnn-vulkan &&\
-    mkdir waifu2x-ncnn-vulkan &&\
-    mv models/models-cunet waifu2x-ncnn-vulkan/ &&\
-    mv build/waifu2x-ncnn-vulkan waifu2x-ncnn-vulkan/ &&\
-    mv waifu2x-ncnn-vulkan /video2x/ &&\
-    rm -rf ../waifu2x-ncnn-vulkan ;\
-    fi
-
-RUN if [ "$driver" = "all" ] || [ "$driver" = "waifu2x_converter" ] ;\
-    then \
-    # Prerequisits for waifu2x-converter-cpp
-    apt-fast install -y --no-install-recommends build-essential cmake libopencv-dev ocl-icd-opencl-dev &&\
-    # Compile & Install
-    git clone --recurse-submodules --depth=1 --progress https://github.com/DeadSix27/waifu2x-converter-cpp &&\
-    cd waifu2x-converter-cpp &&\
-    mkdir build &&\
-    cd build &&\
-    cmake .. &&\
-    make -j$(nproc) &&\
-    #ldconfig &&\
-    cp -r ../models_rgb ./&&\
-    cd / ;\
-    fi
-
-# Go!
-#COPY entrypoint.sh /
-#ENTRYPOINT ["/entrypoint.sh"]
 
 WORKDIR /host
-ENTRYPOINT ["/bin/bash"]
+ENTRYPOINT ["python3.8", "/video2x/src/video2x.py"]
 
 ENV NVIDIA_DRIVER_CAPABILITIES all
-# Docker image can ask questions now, if needed.
 ENV DEBIAN_FRONTEND teletype
-

README.md

@@ -8,32 +8,46 @@
 ![GitHub All Releases](https://img.shields.io/github/downloads/k4yt3x/video2x/total?style=flat-square)
 ![GitHub](https://img.shields.io/github/license/k4yt3x/video2x?style=flat-square)
 ![Platforms](https://img.shields.io/badge/Platforms-Windows%20%7C%20Linux%20%7C%20macOS-blue?style=flat-square)
-![Become A Patron!](https://img.shields.io/endpoint.svg?url=https%3A%2F%2Fshieldsio-patreon.herokuapp.com%2Fk4yt3x&style=flat-square)
+![Become A Patron!](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)
 
 <!--# Video2X Lossless Video Enlarger-->
 
 ### Official Discussion Group (Telegram): https://t.me/video2x
 
-## [Download Stable/Beta Builds](https://github.com/k4yt3x/video2x/releases) (Windows)
+A [Discord server](https://discord.gg/Pwf6Ht) is also available. Please note that most developers are only on Telegram. If you join the Discord server, the developers might not be able to see your questions and help you. It is mostly for user-user interactions and those who do not want to use Telegram.
+
+## [Download Stable/Beta Builds](https://github.com/k4yt3x/video2x/releases/latest) (Windows)
 
 - **`Full`**: full package comes pre-configured with **all** dependencies like `FFmpeg` and `waifu2x-caffe`.
 - **`Light`**: ligt package comes with only Video2X binaries and a template configuration file. The user will either have to run the setup script or install and configure dependencies themselves.
 
 Go to the **[Quick Start](#quick-start)** section for usages.
 
-### [Download From Mirror](https://files.k4yt3x.com/Projects/Video2X/)
+### [Download From Mirror](https://files.k4yt3x.com/Projects/Video2X/latest)
 
 In case you're unable to download the releases directly from GitHub, you can try downloading from the mirror site hosted by the author. Only releases will be updated in this directory, not nightly builds.
 
 ## [Download Nightly Builds](https://github.com/k4yt3x/video2x/actions) (Windows)
 
+**You need to be logged into GitHub to be able to download GitHub Actions artifacts.**
+
 Nightly builds are built automatically every time a new commit is pushed to the master branch. The lates nightly build is always up-to-date with the latest version of the code, but is less stable and may contain bugs. Nightly builds are handled by GitHub's integrated CI/CD tool, GitHub Actions.
 
 To download the latest nightly build, go to the [GitHub Actions](https://github.com/k4yt3x/video2x/actions) tab, enter the last run of workflow "Video2X Nightly Build, and download the artifacts generated from the run.
 
+## [Docker Image](https://hub.docker.com/r/k4yt3x/video2x)
+
+Video2X Docker images are available on Docker Hub for easy and rapid Video2X deployment on Linux and macOS. If you already have Docker installed, then 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 [documentations](https://github.com/K4YT3X/video2x/wiki/Docker).
+
+## [Google Colab](https://colab.research.google.com/drive/1xqeZvoJXaBBPP6UyVwErnhwrnth0br0u)
+
+You can use Video2X on [Google Colab](https://colab.research.google.com/) for free. Colab allows you too use a GPU on Google's Servers (Tesla K80, T4, P4, P100). Please bare in mind that Colab can only be provided for free if all users know that they shouldn't abuse it. A single free-tier tier session can last up to 12 hours. Please do not abuse the platform by creating sessions back-to-back and running upscaling 24/7. This might result in you getting banned.
+
+Here is an exmaple Notebook written by [@Felixkruemel](https://github.com/Felixkruemel): [Video2X_on_Colab.ipynb](https://colab.research.google.com/drive/1xqeZvoJXaBBPP6UyVwErnhwrnth0br0u). This file can be used in combination of the following modified configuration file: [@Felixkruemel's Video2X configuration for Google Colab](https://gist.githubusercontent.com/Felixkruemel/71e62de4bb38965ead2e0f4bae7ef4ee/raw/video2x.yaml).
+
 ## Introduction
 
-Video2X is a video/GIF/image upscaling software based on Waifu2X, Anime4K and SRMD written in Python 3. It upscales videos, GIFs and images, restoring details from low-resolution inputs. Video2X also accepts GIF input to video output and video input to GIF output.
+Video2X is a video/GIF/image upscaling software based on Waifu2X, Anime4K, SRMD and RealSR written in Python 3. It upscales videos, GIFs and images, restoring details from low-resolution inputs. Video2X also accepts GIF input to video output and video input to GIF output.
 
 Currently, Video2X supports the following drivers (implementations of algorithms).
 
@@ -41,6 +55,7 @@ Currently, Video2X supports the following drivers (implementations of algorithms
 - **Waifu2X Converter CPP**: CPP implementation of waifu2x based on OpenCL and OpenCV
 - **Waifu2X NCNN Vulkan**: NCNN implementation of waifu2x based on Vulkan API
 - **SRMD NCNN Vulkan**: NCNN implementation of SRMD based on Vulkan API
+- **RealSR NCNN Vulkan**: NCNN implementation of RealSR based on Vulkan API
 - **Anime4KCPP**: CPP implementation of Anime4K
 
 ### Video Upscaling
@@ -181,10 +196,10 @@ python video2x.py -d waifu2x_caffe -- --help
 
 ### Running Video2X (Docker)
 
-Video2X can be deployed via Docker.
+Video2X can be deployed via Docker. The following command upscales the video `sample_input.mp4` two times with Waifu2X NCNN Vulkan and outputs the upscaled video to `sample_output.mp4`. For more details on Video2X Docker image usages, please refer to the [documentations](https://github.com/K4YT3X/video2x/wiki/Docker).
 
 ```shell
-docker pull k4yt3x/video2x
+docker run --rm -it --gpus all -v /dev/dri:/dev/dri -v $PWD:/host k4yt3x/video2x:4.6.0 -d waifu2x_ncnn_vulkan -r 2 -i sample_input.mp4 -o sample_output.mp4
 ```
 
 ---
@@ -217,49 +232,6 @@ Are you interested in how the idea of Video2X was born? Do you want to know the
 
 ---
 
-# Full Usage
-
-## Video2X Options
-
-### -h, --help
-    show this help message and exit
-
-### -i INPUT, --input INPUT
-    source video file/directory
-
-### -o OUTPUT, --output OUTPUT
-    output video file/directory
-
-### -c CONFIG, --config CONFIG
-    video2x config file path
-
-### -v, --version
-    display version, lawful information and exit
-
-## Upscaling Options
-
-### -d DRIVER, --driver DRIVER
-    upscaling driver (default: waifu2x_caffe)
-
-Available options are:
-
-- waifu2x_caffe
-- waifu2x_converter_cpp
-- waifu2x_ncnn_vulkan
-- srmd_ncnn_vulkan
-- anime4kcpp
-
-### -r RATIO, --ratio RATIO
-    scaling ratio
-
-### -p PROCESSES, --processes PROCESSES
-    number of processes to use for upscaling (default: 1)
-
-### --preserve_frames
-    preserve extracted and upscaled frames (default: False)
-
----
-
 ## License
 
 Licensed under the GNU General Public License Version 3 (GNU GPL v3)
@@ -278,6 +250,7 @@ This project relies on the following software and projects.
 - [waifu2x-converter-cpp](https://github.com/DeadSix27/waifu2x-converter-cpp)
 - [waifu2x-ncnn-vulkan](https://github.com/nihui/waifu2x-ncnn-vulkan)
 - [srmd-ncnn-vulkan](https://github.com/nihui/srmd-ncnn-vulkan)
+- [realsr-ncnn-vulkan](https://github.com/nihui/realsr-ncnn-vulkan)
 - [Anime4K](https://github.com/bloc97/Anime4K)
 - [Anime4KCPP](https://github.com/TianZerL/Anime4KCPP)
 - [Gifski](https://github.com/ImageOptim/gifski)
@@ -286,10 +259,10 @@ This project relies on the following software and projects.
 
 Appreciations given to the following personnel who have contributed significantly to the project (specifically the technical perspective).
 
-- @BrianPetkovsek
+- [@BrianPetkovsek](https://github.com/BrianPetkovsek)
-- @SAT3LL
+- [@sat3ll](https://github.com/sat3ll)
-- @ddouglas87
+- [@ddouglas87](https://github.com/ddouglas87)
-- @lhanjian
+- [@lhanjian](https://github.com/lhanjian)
 
 ## Related Projects
 

src/README.md

@@ -0,0 +1,21 @@
+# Directory Listing
+
+- [**images**](images): image assets such as executable icons
+- [**locale**](locale): language locale files (.po, .mo)
+- [**pyinstaller**](pyinstaller): PyInstaller-specific files
+- [**wrappers**](wrappers): binary Python wrappers/bindings
+- [**bilogger.py**](bilogger.py): bidirectional logger
+- [**build.ps1**](build.ps1): release building script
+- [**exceptions.py**](exceptions.py): custom exceptions
+- [**image_cleaner.py**](image_cleaner.py): upscaled images cleaner
+- [**progress_monitor.py**](progress_monitor.py): upscaling progress monitor
+- [**requirements.txt**](requirements.txt): Python requirements for pip
+- [**upscaler.py**](upscaler.py): main upscaler class
+- [**video2x.pot**](video2x.pot): project i18n POT translation file
+- [**video2x.py**](video2x.py): command line interface
+- [**video2x.yaml**](video2x.yaml): configuration file
+- [**video2x_gui.py**](video2x_gui.py): graphical user interface
+- [**video2x_gui.pyproject**](video2x_gui.pyproject): QtCreator project file
+- [**video2x_gui.ui**](video2x_gui.ui): GUI UI file (defines GUI layout)
+- [**video2x_setup.py**](video2x_setup.py): automatic setup script for Windows
+- [**video2x_setup_ubuntu.sh**](video2x_setup_ubuntu.sh): automatic setup script for Ubuntu

src/bilogger.py

@@ -0,0 +1,45 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+Creator: Video2X Bidirectional Logger
+Author: K4YT3X
+Date Created: June 4, 2020
+Last Modified: December 13, 2020
+"""
+
+# built-in imports
+import io
+
+
+class BiLogger(io.TextIOWrapper):
+    """A bidirectional logger that both prints the output
+    and log all output to file.
+
+    Original code from: https://stackoverflow.com/a/14906787
+    """
+
+    def __init__(self, terminal: io.TextIOWrapper, log_file: io.BufferedRandom):
+        """initialize BiLogger
+
+        Args:
+            terminal (_io.TextIOWrapper): original terminal IO wrapper
+            logfile (_io.BufferedRandom): log file wrapper
+        """
+        self.terminal = terminal
+        self.log_file = log_file
+        self.fileno = self.log_file.fileno
+
+    def write(self, message: str):
+        """write message to original terminal output and log file
+
+        Args:
+            message (str): message to write
+        """
+        self.terminal.write(message)
+        self.terminal.flush()
+        self.log_file.write(message)
+        self.log_file.flush()
+
+    def flush(self):
+        """flush logger (for compability only)"""
+        pass

src/build.ps1

@@ -12,7 +12,7 @@ To start a PowerShell session with execution policy bypass
 powershell -ExecutionPolicy Bypass
 #>
 
-if ($args.count -ne 1){
+if ($args.count -ne 1) {
     Write-Host -ForegroundColor White "Usage:`n .\build.ps1 VIDEO2X_VERSION"
     Exit
 }
@@ -82,13 +82,13 @@ Copy-Item "dist\video2x.exe" -Destination "$($VIDEO2X_VERSION)\video2x-$($VIDEO2
 Copy-Item "dist\video2x_gui.exe" -Destination "$($VIDEO2X_VERSION)\video2x-$($VIDEO2X_VERSION)-win32-light\"
 Copy-Item "dist\video2x_setup.exe" -Destination "$($VIDEO2X_VERSION)\video2x-$($VIDEO2X_VERSION)-win32-light\"
 Copy-Item "video2x.yaml" -Destination "$($VIDEO2X_VERSION)\video2x-$($VIDEO2X_VERSION)-win32-light\"
-Copy-Item "requirements-windows.txt" -Destination "$($VIDEO2X_VERSION)\video2x-$($VIDEO2X_VERSION)-win32-light\"
+Copy-Item "requirements.txt" -Destination "$($VIDEO2X_VERSION)\video2x-$($VIDEO2X_VERSION)-win32-light\"
 
 # clean up temporary files
 Write-Host -ForegroundColor White "`nDeleting temporary files"
 $pathsToRemove = "__pycache__", "build", "dist", "*.spec"
 
-foreach ($path in $pathsToRemove){
+foreach ($path in $pathsToRemove) {
     Write-Host "Removing path: $($path)"
     Remove-Item -path $path -recurse
 }

src/generate_pot.ps1

@@ -0,0 +1,14 @@
+<#
+Name: Video2X Generate POT Script
+Creator: K4YT3X
+Date Created: September 12, 2020
+Last Modified: September 12, 2020
+
+Description: A PowerShell script that uses Python's pygettext
+script to generate the POT file for translations.
+
+To start a PowerShell session with execution policy bypass
+powershell -ExecutionPolicy Bypass
+#>
+
+python $env:LOCALAPPDATA\Programs\Python\Python38\Tools\i18n\pygettext.py -d video2x *.py wrappers\*.py

src/image_cleaner.py

@@ -22,7 +22,7 @@ import time
 
 
 class ImageCleaner(threading.Thread):
-    """ Video2X Image Cleaner
+    """Video2X Image Cleaner
 
     This class creates an object that keeps track of extracted
     frames that has already been upscaled and are not needed
@@ -40,8 +40,7 @@ class ImageCleaner(threading.Thread):
         self.running = False
 
     def run(self):
-        """ Run image cleaner
+        """Run image cleaner"""
-        """
         self.running = True
 
         while self.running:
@@ -49,13 +48,12 @@ class ImageCleaner(threading.Thread):
             time.sleep(1)
 
     def stop(self):
-        """ Stop the image cleaner
+        """Stop the image cleaner"""
-        """
         self.running = False
         self.join()
 
     def remove_upscaled_frames(self):
-        """ remove frames that have already been upscaled
+        """remove frames that have already been upscaled
 
         This method compares the files in the extracted frames
         directory with the upscaled frames directory, and removes

src/locale/zh_CN/LC_MESSAGES/zh_CN.po

@@ -5,8 +5,8 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: \n"
-"POT-Creation-Date: 2020-05-22 17:51-0400\n"
+"POT-Creation-Date: 2020-09-14 14:24-0400\n"
-"PO-Revision-Date: 2020-05-22 17:54-0400\n"
+"PO-Revision-Date: 2020-09-14 14:24-0400\n"
 "Last-Translator: \n"
 "Language-Team: \n"
 "Language: zh_CN\n"
@@ -14,230 +14,278 @@ msgstr ""
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
 "Generated-By: pygettext.py 1.5\n"
-"X-Generator: Poedit 2.3.1\n"
+"X-Generator: Poedit 2.4.1\n"
 "Plural-Forms: nplurals=1; plural=0;\n"
 
-#: progress_monitor.py:42
+#: progress_monitor.py:37
-msgid "Upscaling Progress"
+msgid "Processing: {} (pass {}/{})"
-msgstr "放大进度"
+msgstr "正在处理：{}（进度）"
 
-#: upscaler.py:110
+#: upscaler.py:149
 msgid "Specified or default cache directory is a file/link"
 msgstr "指定或默认的缓存目录是文件/链接"
 
-#: upscaler.py:116
+#: upscaler.py:155
 msgid "Creating cache directory {}"
 msgstr "创建缓存目录 {}"
 
-#: upscaler.py:119
+#: upscaler.py:158
 msgid "Unable to create {}"
 msgstr "无法创建 {}"
 
-#: upscaler.py:124
+#: upscaler.py:163
 msgid "Extracted frames are being saved to: {}"
 msgstr "提取的帧将被保存到：{}"
 
-#: upscaler.py:126
+#: upscaler.py:165
 msgid "Upscaled frames are being saved to: {}"
 msgstr "已放大的帧将被保存到：{}"
 
-#: upscaler.py:136
+#: upscaler.py:175
 msgid "Cleaning up cache directory: {}"
 msgstr "清理缓存目录：{}"
 
-#: upscaler.py:141
+#: upscaler.py:180
 msgid "Unable to delete: {}"
 msgstr "无法删除：{}"
 
-#: upscaler.py:147 upscaler.py:162 upscaler.py:173
+#: upscaler.py:186 upscaler.py:201 upscaler.py:212
 msgid "Input and output path type mismatch"
 msgstr "输入和输出路径类型不匹配"
 
-#: upscaler.py:148
+#: upscaler.py:187
 msgid "Input is multiple files but output is not directory"
 msgstr "输入是多个文件，但输出不是目录"
 
-#: upscaler.py:152
+#: upscaler.py:191
 msgid "Input path {} is neither a file nor a directory"
 msgstr "输入路径 {} 既不是文件也不是目录"
 
-#: upscaler.py:156 upscaler.py:178
+#: upscaler.py:195 upscaler.py:217
 msgid "Input directory and output directory cannot be the same"
 msgstr "输入目录和输出目录不能相同"
 
-#: upscaler.py:163
+#: upscaler.py:202
 msgid "Input is single file but output is directory"
 msgstr "所选的输入路径是单个文件，但输出路径是目录"
 
-#: upscaler.py:166
+#: upscaler.py:205
 msgid "No suffix found in output file path"
 msgstr "在输出文件路径中未找到后缀"
 
-#: upscaler.py:167
+#: upscaler.py:206
 msgid "Suffix must be specified"
 msgstr "必须指定文件后缀"
 
-#: upscaler.py:174
+#: upscaler.py:213
 msgid "Input is directory but output is existing single file"
 msgstr "输入是目录，但输出是现有的单个文件"
 
-#: upscaler.py:183
+#: upscaler.py:222
 msgid "Input path is neither a file nor a directory"
 msgstr "输入路径既不是文件也不是目录"
 
-#: upscaler.py:192
+#: upscaler.py:231
 msgid "FFmpeg or FFprobe cannot be found under the specified path"
 msgstr "在指定的路径下找不到 FFmpeg 或 FFprobe"
 
-#: upscaler.py:193 upscaler.py:203
+#: upscaler.py:232 upscaler.py:242
 msgid "Please check the configuration file settings"
 msgstr "请检查配置文件设置"
 
-#: upscaler.py:202
+#: upscaler.py:241
 msgid "Specified driver executable directory doesn't exist"
 msgstr "指定驱动的可执行文件不存在"
 
-#: upscaler.py:229
+#: upscaler.py:268
 msgid "Failed to parse driver argument: {}"
 msgstr "解析驱动程序参数失败：{}"
 
-#: upscaler.py:261
+#: upscaler.py:288
 msgid "Unrecognized driver: {}"
 msgstr "无法识别的驱动名称：{}"
 
-#: upscaler.py:301
+#: upscaler.py:328
 msgid "Starting progress monitor"
 msgstr "启动进度监视器"
 
-#: upscaler.py:306
+#: upscaler.py:333
 msgid "Starting upscaled image cleaner"
 msgstr "启动已放大图像清理程序"
 
-#: upscaler.py:315 upscaler.py:332
+#: upscaler.py:342 upscaler.py:359
 msgid "Killing progress monitor"
 msgstr "终结进度监视器"
 
-#: upscaler.py:318 upscaler.py:335
+#: upscaler.py:345 upscaler.py:362
 msgid "Killing upscaled image cleaner"
 msgstr "终结已放大图像清理程序"
 
-#: upscaler.py:339
+#: upscaler.py:366
 msgid "Terminating all processes"
 msgstr "正在终止所有进程"
 
-#: upscaler.py:346
+#: upscaler.py:373
 msgid "Main process waiting for subprocesses to exit"
 msgstr "主进程开始等待子进程结束"
 
-#: upscaler.py:365 upscaler.py:369
+#: upscaler.py:392 upscaler.py:396
 msgid "Subprocess {} exited with code {}"
 msgstr "子进程 {} 结束，返回码 {}"
 
-#: upscaler.py:375
+#: upscaler.py:402
 msgid "Stop signal received"
 msgstr "收到停止信号"
 
-#: upscaler.py:380
+#: upscaler.py:407
 msgid "Subprocess execution ran into an error"
 msgstr "子进程执行遇到错误"
 
-#: upscaler.py:410
+#: upscaler.py:437
 msgid "Loading files into processing queue"
 msgstr "正在将文件添加到处理队列中"
 
-#: upscaler.py:415
+#: upscaler.py:438
-msgid "Loading files from multiple paths"
-msgstr "正在从多个路径中导入文件"
-
-#: upscaler.py:416 upscaler.py:435 upscaler.py:442
 msgid "Input path(s): {}"
 msgstr "输入路径：{}"
 
-#: upscaler.py:434
+#: upscaler.py:484
-msgid "Loading single file"
+msgid "File MIME type: {}"
-msgstr "正在导入单个文件"
+msgstr "文件 MIME 类型：{}"
 
-#: upscaler.py:441
+#: upscaler.py:500
-msgid "Loading files from directory"
-msgstr "正在从文件夹中导入文件"
-
-#: upscaler.py:455
-msgid "Loaded files into processing queue"
-msgstr "文件已添加到处理队列"
-
-#: upscaler.py:458
-msgid "Input file: {}"
-msgstr "输入文件：{}"
-
-#: upscaler.py:485
-msgid "Starting to upscale image"
-msgstr "开始放大图像"
-
-#: upscaler.py:488 upscaler.py:550
-msgid "Upscaling completed"
-msgstr "放大完成"
-
-#: upscaler.py:502
-msgid "Reading video information"
-msgstr "读取视频信息"
-
-#: upscaler.py:516
-msgid "Aborting: No video stream found"
-msgstr "程序中止：文件中未找到视频流"
-
-#: upscaler.py:521
-msgid "Framerate: {}"
-msgstr "帧率：{}"
-
-#: upscaler.py:538
-msgid "Unsupported pixel format: {}"
-msgstr "不支持的像素格式：{}"
-
-#: upscaler.py:548
-msgid "Starting to upscale extracted frames"
-msgstr "开始对提取的帧进行放大"
-
-#: upscaler.py:555
 msgid "File {} ({}) neither an image nor a video"
 msgstr "文件 {} （{}） 既不是图片也不是视频"
 
-#: upscaler.py:556
+#: upscaler.py:501
 msgid "Skipping this file"
 msgstr "将跳过此文件"
 
-#: upscaler.py:566
+#: upscaler.py:526
+msgid "Loaded files into processing queue"
+msgstr "文件已添加到处理队列"
+
+#: upscaler.py:529
+msgid "Input file: {}"
+msgstr "输入文件：{}"
+
+#: upscaler.py:541
+msgid "Reading file information"
+msgstr "正在读取视频信息"
+
+#: upscaler.py:550
+msgid "Starting upscaling image"
+msgstr "开始放大图像"
+
+#: upscaler.py:561
+msgid "Starting upscaling video/GIF"
+msgstr "开始放大视频/GIF"
+
+#: upscaler.py:572
+msgid "Aborting: No video stream found"
+msgstr "程序中止：文件中未找到视频流"
+
+#: upscaler.py:581
+msgid "Getting total number of frames in the file"
+msgstr "正在获取文件中的总帧数"
+
+#: upscaler.py:592
+msgid "Calculating scaling parameters"
+msgstr "正在计算缩放参数"
+
+#: upscaler.py:656
+msgid "Framerate: {}"
+msgstr "帧率：{}"
+
+#: upscaler.py:657
+msgid "Width: {}"
+msgstr "宽：{}"
+
+#: upscaler.py:658
+msgid "Height: {}"
+msgstr "高：{}"
+
+#: upscaler.py:659
+msgid "Total number of frames: {}"
+msgstr "总帧数：{}"
+
+#: upscaler.py:660
+msgid "Output width: {}"
+msgstr "输出宽度：{}"
+
+#: upscaler.py:661
+msgid "Output height: {}"
+msgstr "输出高度：{}"
+
+#: upscaler.py:662
+msgid "Required scale ratio: {}"
+msgstr "需要的缩放比例：{}"
+
+#: upscaler.py:663
+msgid "Upscaling jobs queue: {}"
+msgstr "放大工作队列：{}"
+
+#: upscaler.py:680
+msgid "Unsupported pixel format: {}"
+msgstr "不支持的像素格式：{}"
+
+#: upscaler.py:684
+msgid "Starting to upscale extracted frames"
+msgstr "开始对提取的帧进行放大"
+
+#: upscaler.py:701
+msgid "Upscaling completed"
+msgstr "放大完成"
+
+#: upscaler.py:702
+msgid "Average processing speed: {} seconds per frame"
+msgstr "平均处理速度：{} 秒每帧"
+
+#: upscaler.py:705
+msgid "Lanczos downscaling frames"
+msgstr "正在使用 Lanczos 算法缩放图像"
+
+#: upscaler.py:710
+msgid "Downscaling"
+msgstr "正在缩放图像"
+
+#: upscaler.py:729
+msgid "Exporting image"
+msgstr "正在导出图像"
+
+#: upscaler.py:739
 msgid "Converting extracted frames into GIF image"
 msgstr "正在将提取的帧转换为 GIF"
 
-#: upscaler.py:570 upscaler.py:579
+#: upscaler.py:743 upscaler.py:752
 msgid "Conversion completed"
 msgstr "转换已完成"
 
-#: upscaler.py:575
+#: upscaler.py:748
 msgid "Converting extracted frames into video"
 msgstr "正在将提取的帧转换为视频"
 
-#: upscaler.py:583
+#: upscaler.py:756
 msgid "Migrating audio, subtitles and other streams to upscaled video"
 msgstr "正在将音频、字幕和其他流迁移到放大后的视频"
 
-#: upscaler.py:593
+#: upscaler.py:766
 msgid "Failed to migrate streams"
 msgstr "迁移流失败"
 
-#: upscaler.py:594
+#: upscaler.py:767
 msgid "Trying to output video without additional streams"
 msgstr "正在尝试输出不含其他流的视频"
 
-#: upscaler.py:610
+#: upscaler.py:783
 msgid "Output video file exists"
 msgstr "输出目标文件已存在"
 
-#: upscaler.py:614
+#: upscaler.py:787
 msgid "Created temporary directory to contain file"
 msgstr "为文件创建了临时目录"
 
-#: upscaler.py:617
+#: upscaler.py:790
 msgid "Writing intermediate file to: {}"
 msgstr "正在将中间视频文件写入至：{}"
 
@@ -265,66 +313,101 @@ msgstr "Video2X 选项"
 msgid "show this help message and exit"
 msgstr "显示此帮助消息并退出"
 
-#: video2x.py:110
+#: video2x.py:116
 msgid "source video file/directory"
 msgstr "源视频文件/目录"
 
-#: video2x.py:111
+#: video2x.py:117
 msgid "output video file/directory"
 msgstr "输出视频文件/目录"
 
-#: video2x.py:112
+#: video2x.py:119
-msgid "video2x config file path"
+msgid "Video2X config file path"
-msgstr "video2x 配置文件路径"
+msgstr "Video2X 配置文件路径"
 
-#: video2x.py:114
+#: video2x.py:121
+msgid "log file path"
+msgstr "日志文件路径"
+
+#: video2x.py:122
 msgid "display version, lawful information and exit"
 msgstr "显示版本和法律信息并退出"
 
-#: video2x.py:117
+#: video2x.py:125
 msgid "Upscaling Options"
 msgstr "视频放大选项"
 
-#: video2x.py:118
+#: video2x.py:126
-msgid "upscaling driver"
-msgstr "视频放大驱动"
-
-#: video2x.py:119
 msgid "scaling ratio"
 msgstr "缩放比"
 
-#: video2x.py:120
+#: video2x.py:127
+msgid "output width"
+msgstr "输出宽度"
+
+#: video2x.py:128
+msgid "output height"
+msgstr "输出高度"
+
+#: video2x.py:129
+msgid "upscaling driver"
+msgstr "视频放大驱动"
+
+#: video2x.py:130
 msgid "number of processes to use for upscaling"
 msgstr "并发进程数"
 
-#: video2x.py:121
+#: video2x.py:131
 msgid "preserve extracted and upscaled frames"
 msgstr "保留提取的和放大的帧"
 
-#: video2x.py:161
+#: video2x.py:171
 msgid "This file cannot be imported"
 msgstr "此文件无法被当作模块导入"
 
-#: video2x.py:236
+#: video2x.py:187
+msgid "Specify either scaling ratio or scaling resolution, not both"
+msgstr "您只能指定缩放比或输出分辨率两者之一"
+
+#: video2x.py:273
 msgid "Program completed, taking {} seconds"
 msgstr "程序执行完毕，总计花费 {} 秒"
 
-#: video2x.py:239
+#: video2x.py:277
 msgid "An exception has occurred"
 msgstr "发生了异常"
 
+#: video2x.py:292
+msgid "The error log file can be found at: {}"
+msgstr "错误日志已被保存到：{}"
+
+#~ msgid "disable logging"
+#~ msgstr "禁用日志"
+
+#~ msgid "Only one of scaling width and scaling height is specified"
+#~ msgstr "输出高度和宽度仅有其中一项被指定"
+
+#~ msgid "Redirecting console logs to {}"
+#~ msgstr "将控制台日志重定向到 {}"
+
+#~ msgid "Upscaling Progress"
+#~ msgstr "放大进度"
+
+#~ msgid "Loading files from multiple paths"
+#~ msgstr "正在从多个路径中导入文件"
+
+#~ msgid "Loading single file"
+#~ msgstr "正在导入单个文件"
+
+#~ msgid "Loading files from directory"
+#~ msgstr "正在从文件夹中导入文件"
+
 #~ msgid "Anime4KCPP doesn't yet support GIF processing"
 #~ msgstr "Anime4KCPP 尚不支持GIF处理"
 
 #~ msgid "Starting to upscale video with Anime4KCPP"
 #~ msgstr "开始用 Anime4KCPP 放大视频"
 
-#~ msgid "output video width"
-#~ msgstr "输出视频宽度"
-
-#~ msgid "output video height"
-#~ msgstr "输出视频高度"
-
 #~ msgid "You must specify input video file/directory path"
 #~ msgstr "您必须指定输入视频文件/目录路径"
 
@@ -340,8 +423,5 @@ msgstr "发生了异常"
 #~ msgid "Scaling ratio must be one of 2, 3 or 4 for srmd_ncnn_vulkan"
 #~ msgstr "srmd_ncnn_vulkan 的缩放比必须为 2、3 或 4"
 
-#~ msgid "You can only specify either scaling ratio or output width and height"
-#~ msgstr "您只能指定缩放比或输出宽度和高度两者之一"
-
 #~ msgid "You must specify both width and height"
 #~ msgstr "您必须同时指定宽度和高度"

src/progress_monitor.py

@@ -2,9 +2,9 @@
 # -*- coding: utf-8 -*-
 """
 Name: Video2X Upscale Progress Monitor
-Author: BrianPetkovsek
+Author: K4YT3X
 Date Created: May 7, 2020
-Last Modified: May 10, 2020
+Last Modified: September 9, 2020
 """
 
 # built-in imports
@@ -17,7 +17,7 @@ from tqdm import tqdm
 
 
 class ProgressMonitor(threading.Thread):
-    """ progress monitor
+    """progress monitor
 
     This class provides progress monitoring functionalities
     by keeping track of the amount of frames in the input
@@ -34,12 +34,15 @@ class ProgressMonitor(threading.Thread):
     def run(self):
         self.running = True
 
-        # get number of extracted frames
+        with tqdm(
-        self.upscaler.total_frames = 0
+            total=self.upscaler.total_frames,
-        for directory in self.extracted_frames_directories:
+            ascii=True,
-            self.upscaler.total_frames += len([f for f in directory.iterdir() if str(f).lower().endswith(self.upscaler.image_format.lower())])
+            desc=_("Processing: {} (pass {}/{})").format(
-
+                self.upscaler.current_input_file.name,
-        with tqdm(total=self.upscaler.total_frames, ascii=True, desc=_('Upscaling Progress')) as progress_bar:
+                self.upscaler.current_pass,
+                len(self.upscaler.scaling_jobs),
+            ),
+        ) as progress_bar:
             # tqdm update method adds the value to the progress
             # bar instead of setting the value. Therefore, a delta
             # needs to be calculated.
@@ -47,7 +50,13 @@ class ProgressMonitor(threading.Thread):
             while self.running:
 
                 with contextlib.suppress(FileNotFoundError):
-                    upscaled_frames = [f for f in self.upscaler.upscaled_frames.iterdir() if str(f).lower().endswith(self.upscaler.image_format.lower())]
+                    upscaled_frames = [
+                        f
+                        for f in self.upscaler.upscaled_frames.iterdir()
+                        if str(f)
+                        .lower()
+                        .endswith(self.upscaler.extracted_frame_format.lower())
+                    ]
                     if len(upscaled_frames) >= 1:
                         self.upscaler.last_frame_upscaled = sorted(upscaled_frames)[-1]
                     self.upscaler.total_frames_upscaled = len(upscaled_frames)

src/requirements-linux.txt

@@ -1,10 +0,0 @@
-avalon_framework
-colorama
-patool
-psutil
-pyqt5
-python-magic
-pyunpack
-pyyaml
-requests
-tqdm

src/requirements-windows.txt

@@ -1,11 +0,0 @@
-avalon_framework
-colorama
-patool
-psutil
-pyqt5
-python-magic
-python-magic-bin
-pyunpack
-pyyaml
-requests
-tqdm

src/requirements.txt

@@ -0,0 +1,10 @@
+avalon_framework
+colorama
+patool
+pillow
+pyqt5
+python-magic-bin; platform_system == "Windows"
+python-magic; platform_system != "Windows"
+pyyaml
+requests
+tqdm

src/video2x.pot

@@ -5,7 +5,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: PACKAGE VERSION\n"
-"POT-Creation-Date: 2020-05-22 17:51-0400\n"
+"POT-Creation-Date: 2020-09-14 14:24-0400\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <LL@li.org>\n"
@@ -15,227 +15,275 @@ msgstr ""
 "Generated-By: pygettext.py 1.5\n"
 
 
-#: progress_monitor.py:42
+#: progress_monitor.py:37
-msgid "Upscaling Progress"
+msgid "Processing: {} (pass {}/{})"
 msgstr ""
 
-#: upscaler.py:110
+#: upscaler.py:149
 msgid "Specified or default cache directory is a file/link"
 msgstr ""
 
-#: upscaler.py:116
+#: upscaler.py:155
 msgid "Creating cache directory {}"
 msgstr ""
 
-#: upscaler.py:119
+#: upscaler.py:158
 msgid "Unable to create {}"
 msgstr ""
 
-#: upscaler.py:124
+#: upscaler.py:163
 msgid "Extracted frames are being saved to: {}"
 msgstr ""
 
-#: upscaler.py:126
+#: upscaler.py:165
 msgid "Upscaled frames are being saved to: {}"
 msgstr ""
 
-#: upscaler.py:136
+#: upscaler.py:175
 msgid "Cleaning up cache directory: {}"
 msgstr ""
 
-#: upscaler.py:141
+#: upscaler.py:180
 msgid "Unable to delete: {}"
 msgstr ""
 
-#: upscaler.py:147 upscaler.py:162 upscaler.py:173
+#: upscaler.py:186 upscaler.py:201 upscaler.py:212
 msgid "Input and output path type mismatch"
 msgstr ""
 
-#: upscaler.py:148
+#: upscaler.py:187
 msgid "Input is multiple files but output is not directory"
 msgstr ""
 
-#: upscaler.py:152
+#: upscaler.py:191
 msgid "Input path {} is neither a file nor a directory"
 msgstr ""
 
-#: upscaler.py:156 upscaler.py:178
+#: upscaler.py:195 upscaler.py:217
 msgid "Input directory and output directory cannot be the same"
 msgstr ""
 
-#: upscaler.py:163
+#: upscaler.py:202
 msgid "Input is single file but output is directory"
 msgstr ""
 
-#: upscaler.py:166
+#: upscaler.py:205
 msgid "No suffix found in output file path"
 msgstr ""
 
-#: upscaler.py:167
+#: upscaler.py:206
 msgid "Suffix must be specified"
 msgstr ""
 
-#: upscaler.py:174
+#: upscaler.py:213
 msgid "Input is directory but output is existing single file"
 msgstr ""
 
-#: upscaler.py:183
+#: upscaler.py:222
 msgid "Input path is neither a file nor a directory"
 msgstr ""
 
-#: upscaler.py:192
+#: upscaler.py:231
 msgid "FFmpeg or FFprobe cannot be found under the specified path"
 msgstr ""
 
-#: upscaler.py:193 upscaler.py:203
+#: upscaler.py:232 upscaler.py:242
 msgid "Please check the configuration file settings"
 msgstr ""
 
-#: upscaler.py:202
+#: upscaler.py:241
 msgid "Specified driver executable directory doesn't exist"
 msgstr ""
 
-#: upscaler.py:229
+#: upscaler.py:268
 msgid "Failed to parse driver argument: {}"
 msgstr ""
 
-#: upscaler.py:261
+#: upscaler.py:288
 msgid "Unrecognized driver: {}"
 msgstr ""
 
-#: upscaler.py:301
+#: upscaler.py:328
 msgid "Starting progress monitor"
 msgstr ""
 
-#: upscaler.py:306
+#: upscaler.py:333
 msgid "Starting upscaled image cleaner"
 msgstr ""
 
-#: upscaler.py:315 upscaler.py:332
+#: upscaler.py:342 upscaler.py:359
 msgid "Killing progress monitor"
 msgstr ""
 
-#: upscaler.py:318 upscaler.py:335
+#: upscaler.py:345 upscaler.py:362
 msgid "Killing upscaled image cleaner"
 msgstr ""
 
-#: upscaler.py:339
+#: upscaler.py:366
 msgid "Terminating all processes"
 msgstr ""
 
-#: upscaler.py:346
+#: upscaler.py:373
 msgid "Main process waiting for subprocesses to exit"
 msgstr ""
 
-#: upscaler.py:365 upscaler.py:369
+#: upscaler.py:392 upscaler.py:396
 msgid "Subprocess {} exited with code {}"
 msgstr ""
 
-#: upscaler.py:375
+#: upscaler.py:402
 msgid "Stop signal received"
 msgstr ""
 
-#: upscaler.py:380
+#: upscaler.py:407
 msgid "Subprocess execution ran into an error"
 msgstr ""
 
-#: upscaler.py:410
+#: upscaler.py:437
 msgid "Loading files into processing queue"
 msgstr ""
 
-#: upscaler.py:415
+#: upscaler.py:438
-msgid "Loading files from multiple paths"
-msgstr ""
-
-#: upscaler.py:416 upscaler.py:435 upscaler.py:442
 msgid "Input path(s): {}"
 msgstr ""
 
-#: upscaler.py:434
+#: upscaler.py:484
-msgid "Loading single file"
+msgid "File MIME type: {}"
 msgstr ""
 
-#: upscaler.py:441
+#: upscaler.py:500
-msgid "Loading files from directory"
-msgstr ""
-
-#: upscaler.py:455
-msgid "Loaded files into processing queue"
-msgstr ""
-
-#: upscaler.py:458
-msgid "Input file: {}"
-msgstr ""
-
-#: upscaler.py:485
-msgid "Starting to upscale image"
-msgstr ""
-
-#: upscaler.py:488 upscaler.py:550
-msgid "Upscaling completed"
-msgstr ""
-
-#: upscaler.py:502
-msgid "Reading video information"
-msgstr ""
-
-#: upscaler.py:516
-msgid "Aborting: No video stream found"
-msgstr ""
-
-#: upscaler.py:521
-msgid "Framerate: {}"
-msgstr ""
-
-#: upscaler.py:538
-msgid "Unsupported pixel format: {}"
-msgstr ""
-
-#: upscaler.py:548
-msgid "Starting to upscale extracted frames"
-msgstr ""
-
-#: upscaler.py:555
 msgid "File {} ({}) neither an image nor a video"
 msgstr ""
 
-#: upscaler.py:556
+#: upscaler.py:501
 msgid "Skipping this file"
 msgstr ""
 
-#: upscaler.py:566
+#: upscaler.py:526
+msgid "Loaded files into processing queue"
+msgstr ""
+
+#: upscaler.py:529
+msgid "Input file: {}"
+msgstr ""
+
+#: upscaler.py:541
+msgid "Reading file information"
+msgstr ""
+
+#: upscaler.py:550
+msgid "Starting upscaling image"
+msgstr ""
+
+#: upscaler.py:561
+msgid "Starting upscaling video/GIF"
+msgstr ""
+
+#: upscaler.py:572
+msgid "Aborting: No video stream found"
+msgstr ""
+
+#: upscaler.py:581
+msgid "Getting total number of frames in the file"
+msgstr ""
+
+#: upscaler.py:592
+msgid "Calculating scaling parameters"
+msgstr ""
+
+#: upscaler.py:656
+msgid "Framerate: {}"
+msgstr ""
+
+#: upscaler.py:657
+msgid "Width: {}"
+msgstr ""
+
+#: upscaler.py:658
+msgid "Height: {}"
+msgstr ""
+
+#: upscaler.py:659
+msgid "Total number of frames: {}"
+msgstr ""
+
+#: upscaler.py:660
+msgid "Output width: {}"
+msgstr ""
+
+#: upscaler.py:661
+msgid "Output height: {}"
+msgstr ""
+
+#: upscaler.py:662
+msgid "Required scale ratio: {}"
+msgstr ""
+
+#: upscaler.py:663
+msgid "Upscaling jobs queue: {}"
+msgstr ""
+
+#: upscaler.py:680
+msgid "Unsupported pixel format: {}"
+msgstr ""
+
+#: upscaler.py:684
+msgid "Starting to upscale extracted frames"
+msgstr ""
+
+#: upscaler.py:701
+msgid "Upscaling completed"
+msgstr ""
+
+#: upscaler.py:702
+msgid "Average processing speed: {} seconds per frame"
+msgstr ""
+
+#: upscaler.py:705
+msgid "Lanczos downscaling frames"
+msgstr ""
+
+#: upscaler.py:710
+msgid "Downscaling"
+msgstr ""
+
+#: upscaler.py:729
+msgid "Exporting image"
+msgstr ""
+
+#: upscaler.py:739
 msgid "Converting extracted frames into GIF image"
 msgstr ""
 
-#: upscaler.py:570 upscaler.py:579
+#: upscaler.py:743 upscaler.py:752
 msgid "Conversion completed"
 msgstr ""
 
-#: upscaler.py:575
+#: upscaler.py:748
 msgid "Converting extracted frames into video"
 msgstr ""
 
-#: upscaler.py:583
+#: upscaler.py:756
 msgid "Migrating audio, subtitles and other streams to upscaled video"
 msgstr ""
 
-#: upscaler.py:593
+#: upscaler.py:766
 msgid "Failed to migrate streams"
 msgstr ""
 
-#: upscaler.py:594
+#: upscaler.py:767
 msgid "Trying to output video without additional streams"
 msgstr ""
 
-#: upscaler.py:610
+#: upscaler.py:783
 msgid "Output video file exists"
 msgstr ""
 
-#: upscaler.py:614
+#: upscaler.py:787
 msgid "Created temporary directory to contain file"
 msgstr ""
 
-#: upscaler.py:617
+#: upscaler.py:790
 msgid "Writing intermediate file to: {}"
 msgstr ""
 
@@ -257,51 +305,71 @@ msgstr ""
 msgid "show this help message and exit"
 msgstr ""
 
-#: video2x.py:110
+#: video2x.py:116
 msgid "source video file/directory"
 msgstr ""
 
-#: video2x.py:111
+#: video2x.py:117
 msgid "output video file/directory"
 msgstr ""
 
-#: video2x.py:112
-msgid "video2x config file path"
-msgstr ""
-
-#: video2x.py:114
-msgid "display version, lawful information and exit"
-msgstr ""
-
-#: video2x.py:117
-msgid "Upscaling Options"
-msgstr ""
-
-#: video2x.py:118
-msgid "upscaling driver"
-msgstr ""
-
 #: video2x.py:119
-msgid "scaling ratio"
+msgid "Video2X config file path"
-msgstr ""
-
-#: video2x.py:120
-msgid "number of processes to use for upscaling"
 msgstr ""
 
 #: video2x.py:121
+msgid "log file path"
+msgstr ""
+
+#: video2x.py:122
+msgid "display version, lawful information and exit"
+msgstr ""
+
+#: video2x.py:125
+msgid "Upscaling Options"
+msgstr ""
+
+#: video2x.py:126
+msgid "scaling ratio"
+msgstr ""
+
+#: video2x.py:127
+msgid "output width"
+msgstr ""
+
+#: video2x.py:128
+msgid "output height"
+msgstr ""
+
+#: video2x.py:129
+msgid "upscaling driver"
+msgstr ""
+
+#: video2x.py:130
+msgid "number of processes to use for upscaling"
+msgstr ""
+
+#: video2x.py:131
 msgid "preserve extracted and upscaled frames"
 msgstr ""
 
-#: video2x.py:161
+#: video2x.py:171
 msgid "This file cannot be imported"
 msgstr ""
 
-#: video2x.py:236
+#: video2x.py:187
+msgid "Specify either scaling ratio or scaling resolution, not both"
+msgstr ""
+
+#: video2x.py:273
 msgid "Program completed, taking {} seconds"
 msgstr ""
 
-#: video2x.py:239
+#: video2x.py:277
 msgid "An exception has occurred"
 msgstr ""
 
+#: video2x.py:292
+msgid "The error log file can be found at: {}"
+msgstr ""
+

src/video2x.py

@@ -13,7 +13,7 @@ __      __  _       _                  ___   __   __
 Name: Video2X Controller
 Creator: K4YT3X
 Date Created: Feb 24, 2018
-Last Modified: May 23, 2020
+Last Modified: September 13, 2020
 
 Editor: BrianPetkovsek
 Last Modified: June 17, 2019
@@ -49,6 +49,7 @@ smooth and edges sharp.
 """
 
 # local imports
+from bilogger import BiLogger
 from upscaler import AVAILABLE_DRIVERS
 from upscaler import UPSCALER_VERSION
 from upscaler import Upscaler
@@ -70,73 +71,143 @@ import yaml
 from avalon_framework import Avalon
 
 # internationalization constants
-DOMAIN = 'video2x'
+DOMAIN = "video2x"
-LOCALE_DIRECTORY = pathlib.Path(__file__).parent.absolute() / 'locale'
+LOCALE_DIRECTORY = pathlib.Path(__file__).parent.absolute() / "locale"
 
 # getting default locale settings
 default_locale, encoding = locale.getdefaultlocale()
-language = gettext.translation(DOMAIN, LOCALE_DIRECTORY, [default_locale], fallback=True)
+language = gettext.translation(
+    DOMAIN, LOCALE_DIRECTORY, [default_locale], fallback=True
+)
 language.install()
 _ = language.gettext
 
+CLI_VERSION = "4.3.1"
 
-CLI_VERSION = '4.0.1'
+LEGAL_INFO = _(
-
+    """Video2X CLI Version: {}
-LEGAL_INFO = _('''Video2X CLI Version: {}
 Upscaler Version: {}
 Author: K4YT3X
 License: GNU GPL v3
 Github Page: https://github.com/k4yt3x/video2x
-Contact: k4yt3x@k4yt3x.com''').format(CLI_VERSION, UPSCALER_VERSION)
+Contact: k4yt3x@k4yt3x.com"""
+).format(CLI_VERSION, UPSCALER_VERSION)
 
-LOGO = r'''
+LOGO = r"""
     __      __  _       _                  ___   __   __
     \ \    / / (_)     | |                |__ \  \ \ / /
      \ \  / /   _    __| |   ___    ___      ) |  \ V /
       \ \/ /   | |  / _` |  / _ \  / _ \    / /    > <
        \  /    | | | (_| | |  __/ | (_) |  / /_   / . \
         \/     |_|  \__,_|  \___|  \___/  |____| /_/ \_\
-'''
+"""
 
 
 def parse_arguments():
-    """ parse CLI arguments
+    """parse CLI arguments"""
-    """
+    parser = argparse.ArgumentParser(
-    parser = argparse.ArgumentParser(prog='video2x', formatter_class=argparse.ArgumentDefaultsHelpFormatter, add_help=False)
+        prog="video2x",
+        formatter_class=argparse.ArgumentDefaultsHelpFormatter,
+        add_help=False,
+    )
 
     # video options
-    video2x_options = parser.add_argument_group(_('Video2X Options'))
+    video2x_options = parser.add_argument_group(_("Video2X Options"))
-    video2x_options.add_argument('-h', '--help', action='help', help=_('show this help message and exit'))
+
+    video2x_options.add_argument(
+        "--help", action="help", help=_("show this help message and exit")
+    )
 
     # if help is in arguments list
     # do not require input and output path to be specified
     require_input_output = True
-    if '-h' in sys.argv or '--help' in sys.argv:
+    if "-h" in sys.argv or "--help" in sys.argv:
         require_input_output = False
-    video2x_options.add_argument('-i', '--input', type=pathlib.Path, help=_('source video file/directory'), required=require_input_output)
-    video2x_options.add_argument('-o', '--output', type=pathlib.Path, help=_('output video file/directory'), required=require_input_output)
 
-    video2x_options.add_argument('-c', '--config', type=pathlib.Path, help=_('video2x config file path'), action='store',
+    video2x_options.add_argument(
-                                 default=pathlib.Path(__file__).parent.absolute() / 'video2x.yaml')
+        "-i",
-    video2x_options.add_argument('-v', '--version', help=_('display version, lawful information and exit'), action='store_true')
+        "--input",
+        type=pathlib.Path,
+        help=_("source video file/directory"),
+        required=require_input_output,
+    )
+
+    video2x_options.add_argument(
+        "-o",
+        "--output",
+        type=pathlib.Path,
+        help=_("output video file/directory"),
+        required=require_input_output,
+    )
+
+    video2x_options.add_argument(
+        "-c",
+        "--config",
+        type=pathlib.Path,
+        help=_("Video2X config file path"),
+        action="store",
+        default=pathlib.Path(__file__).parent.absolute() / "video2x.yaml",
+    )
+
+    video2x_options.add_argument("--log", type=pathlib.Path, help=_("log file path"))
+
+    video2x_options.add_argument(
+        "-v",
+        "--version",
+        help=_("display version, lawful information and exit"),
+        action="store_true",
+    )
 
     # scaling options
-    upscaling_options = parser.add_argument_group(_('Upscaling Options'))
+    upscaling_options = parser.add_argument_group(_("Upscaling Options"))
-    upscaling_options.add_argument('-d', '--driver', help=_('upscaling driver'), choices=AVAILABLE_DRIVERS, default='waifu2x_caffe')
+
-    upscaling_options.add_argument('-r', '--ratio', help=_('scaling ratio'), action='store', type=float, default=2.0)
+    upscaling_options.add_argument(
-    upscaling_options.add_argument('-p', '--processes', help=_('number of processes to use for upscaling'), action='store', type=int, default=1)
+        "-r", "--ratio", help=_("scaling ratio"), action="store", type=float
-    upscaling_options.add_argument('--preserve_frames', help=_('preserve extracted and upscaled frames'), action='store_true')
+    )
+
+    upscaling_options.add_argument(
+        "-w", "--width", help=_("output width"), action="store", type=float
+    )
+
+    upscaling_options.add_argument(
+        "-h", "--height", help=_("output height"), action="store", type=float
+    )
+
+    upscaling_options.add_argument(
+        "-d",
+        "--driver",
+        help=_("upscaling driver"),
+        choices=AVAILABLE_DRIVERS,
+        default="waifu2x_ncnn_vulkan",
+    )
+
+    upscaling_options.add_argument(
+        "-p",
+        "--processes",
+        help=_("number of processes to use for upscaling"),
+        action="store",
+        type=int,
+        default=1,
+    )
+
+    upscaling_options.add_argument(
+        "--preserve_frames",
+        help=_("preserve extracted and upscaled frames"),
+        action="store_true",
+    )
 
     # if no driver arguments are specified
-    if '--' not in sys.argv:
+    if "--" not in sys.argv:
         video2x_args = parser.parse_args()
         return video2x_args, None
 
     # if driver arguments are specified
     else:
-        video2x_args = parser.parse_args(sys.argv[1:sys.argv.index('--')])
+        video2x_args = parser.parse_args(sys.argv[1 : sys.argv.index("--")])
-        wrapper = getattr(importlib.import_module(f'wrappers.{video2x_args.driver}'), 'WrapperMain')
+        wrapper = getattr(
-        driver_args = wrapper.parse_arguments(sys.argv[sys.argv.index('--') + 1:])
+            importlib.import_module(f"wrappers.{video2x_args.driver}"), "WrapperMain"
+        )
+        driver_args = wrapper.parse_arguments(sys.argv[sys.argv.index("--") + 1 :])
         return video2x_args, driver_args
 
 
@@ -148,7 +219,7 @@ def print_logo():
 
 
 def read_config(config_file: pathlib.Path) -> dict:
-    """ read video2x configurations from config file
+    """read video2x configurations from config file
 
     Arguments:
         config_file {pathlib.Path} -- video2x configuration file pathlib.Path
@@ -157,16 +228,16 @@ def read_config(config_file: pathlib.Path) -> dict:
         dict -- dictionary of video2x configuration
     """
 
-    with open(config_file, 'r') as config:
+    with open(config_file, "r") as config:
         return yaml.load(config, Loader=yaml.FullLoader)
 
 
 # /////////////////// Execution /////////////////// #
 
 # this is not a library
-if __name__ != '__main__':
+if __name__ != "__main__":
-    Avalon.error(_('This file cannot be imported'))
+    Avalon.error(_("This file cannot be imported"))
-    raise ImportError(f'{__file__} cannot be imported')
+    raise ImportError(f"{__file__} cannot be imported")
 
 # print video2x logo
 print_logo()
@@ -179,24 +250,47 @@ if video2x_args.version:
     print(LEGAL_INFO)
     sys.exit(0)
 
+# additional checks on upscaling arguments
+if video2x_args.ratio is not None and (
+    video2x_args.width is not None or video2x_args.height is not None
+):
+    Avalon.error(_("Specify either scaling ratio or scaling resolution, not both"))
+    sys.exit(1)
+
+# redirect output to both terminal and log file
+if video2x_args.log is not None:
+    log_file = video2x_args.log.open(mode="a+", encoding="utf-8")
+else:
+    log_file = tempfile.TemporaryFile(
+        mode="a+", suffix=".log", prefix="video2x_", encoding="utf-8"
+    )
+
+original_stdout = sys.stdout
+original_stderr = sys.stderr
+sys.stdout = BiLogger(sys.stdout, log_file)
+sys.stderr = BiLogger(sys.stderr, log_file)
+
 # read configurations from configuration file
 config = read_config(video2x_args.config)
 
 # load waifu2x configuration
 driver_settings = config[video2x_args.driver]
-driver_settings['path'] = os.path.expandvars(driver_settings['path'])
+driver_settings["path"] = os.path.expandvars(driver_settings["path"])
 
 # read FFmpeg configuration
-ffmpeg_settings = config['ffmpeg']
+ffmpeg_settings = config["ffmpeg"]
-ffmpeg_settings['ffmpeg_path'] = os.path.expandvars(ffmpeg_settings['ffmpeg_path'])
+ffmpeg_settings["ffmpeg_path"] = os.path.expandvars(ffmpeg_settings["ffmpeg_path"])
 
 # read Gifski configuration
-gifski_settings = config['gifski']
+gifski_settings = config["gifski"]
-gifski_settings['gifski_path'] = os.path.expandvars(gifski_settings['gifski_path'])
+gifski_settings["gifski_path"] = os.path.expandvars(gifski_settings["gifski_path"])
 
 # load video2x settings
-image_format = config['video2x']['image_format'].lower()
+extracted_frame_format = config["video2x"]["extracted_frame_format"].lower()
-preserve_frames = config['video2x']['preserve_frames']
+output_file_name_format_string = config["video2x"]["output_file_name_format_string"]
+image_output_extension = config["video2x"]["image_output_extension"]
+video_output_extension = config["video2x"]["video_output_extension"]
+preserve_frames = config["video2x"]["preserve_frames"]
 
 # if preserve frames specified in command line
 # overwrite config file options
@@ -205,10 +299,10 @@ if video2x_args.preserve_frames is True:
 
 # if cache directory not specified
 # use default path: %TEMP%\video2x
-if config['video2x']['video2x_cache_directory'] is None:
+if config["video2x"]["video2x_cache_directory"] is None:
-    video2x_cache_directory = (pathlib.Path(tempfile.gettempdir()) / 'video2x')
+    video2x_cache_directory = pathlib.Path(tempfile.gettempdir()) / "video2x"
 else:
-    video2x_cache_directory = pathlib.Path(config['video2x']['video2x_cache_directory'])
+    video2x_cache_directory = pathlib.Path(config["video2x"]["video2x_cache_directory"])
 
 # overwrite driver_settings with driver_args
 if driver_args is not None:
@@ -223,25 +317,56 @@ try:
     begin_time = time.time()
 
     # initialize upscaler object
-    upscaler = Upscaler(input_path=video2x_args.input,
+    upscaler = Upscaler(
-                        output_path=video2x_args.output,
+        # required parameters
-                        driver_settings=driver_settings,
+        input_path=video2x_args.input,
-                        ffmpeg_settings=ffmpeg_settings,
+        output_path=video2x_args.output,
-                        gifski_settings=gifski_settings)
+        driver_settings=driver_settings,
-
+        ffmpeg_settings=ffmpeg_settings,
-    # set upscaler optional options
+        gifski_settings=gifski_settings,
-    upscaler.driver = video2x_args.driver
+        # optional parameters
-    upscaler.scale_ratio = video2x_args.ratio
+        driver=video2x_args.driver,
-    upscaler.processes = video2x_args.processes
+        scale_ratio=video2x_args.ratio,
-    upscaler.video2x_cache_directory = video2x_cache_directory
+        scale_width=video2x_args.width,
-    upscaler.image_format = image_format
+        scale_height=video2x_args.height,
-    upscaler.preserve_frames = preserve_frames
+        processes=video2x_args.processes,
+        video2x_cache_directory=video2x_cache_directory,
+        extracted_frame_format=extracted_frame_format,
+        output_file_name_format_string=output_file_name_format_string,
+        image_output_extension=image_output_extension,
+        video_output_extension=video_output_extension,
+        preserve_frames=preserve_frames,
+    )
 
     # run upscaler
     upscaler.run()
 
-    Avalon.info(_('Program completed, taking {} seconds').format(round((time.time() - begin_time), 5)))
+    Avalon.info(
+        _("Program completed, taking {} seconds").format(
+            round((time.time() - begin_time), 5)
+        )
+    )
 
 except Exception:
-    Avalon.error(_('An exception has occurred'))
+
+    Avalon.error(_("An exception has occurred"))
     traceback.print_exc()
+
+    if video2x_args.log is not None:
+        log_file_path = video2x_args.log.absolute()
+
+    # if log file path is not specified, create temporary file as permanent log file
+    # tempfile.TempFile does not have a name attribute and is not guaranteed to have
+    # a visible name on the file system
+    else:
+        log_file_path = tempfile.mkstemp(suffix=".log", prefix="video2x_")[1]
+        with open(log_file_path, "w", encoding="utf-8") as permanent_log_file:
+            log_file.seek(0)
+            permanent_log_file.write(log_file.read())
+
+    Avalon.error(_("The error log file can be found at: {}").format(log_file_path))
+
+finally:
+    sys.stdout = original_stdout
+    sys.stderr = original_stderr
+    log_file.close()

src/video2x.yaml

@@ -1,7 +1,7 @@
 # Name: Video2X Configuration File
 # Creator: K4YT3X
 # Date Created: October 23, 2018
-# Last Modified: May 26, 2020
+# Last Modified: September 28, 2020
 # Values here are the default values. Change the value here to
 #   save the default value permanently.
 # Items commented out are parameters irrelevant to this context
@@ -18,8 +18,8 @@ waifu2x_caffe:
   output_quality: -1 # output image quality
   process: gpu # <cpu|gpu|cudnn> process mode
   model_dir: null # path to custom model directory (don't append last / )
-  scale_height: 0 # custom scale height (specifying this will overwrite scale_ratio)
+  #scale_height: 0 # custom scale height (specifying this will overwrite scale_ratio)
-  scale_width: 0 # custom scale width (specifying this will overwrite scale_ratio)
+  #scale_width: 0 # custom scale width (specifying this will overwrite scale_ratio)
   #scale_ratio: null # custom scale ratio
   noise_level: 3 # <0|1|2|3> noise reduction level
   mode: noise_scale # <noise|scale|noise_scale|auto_scale> image processing mode
@@ -32,7 +32,7 @@ waifu2x_converter_cpp:
   #list-supported-formats: null # dump currently supported format list
   #list-opencv-formats: null # (deprecated. Use --list-supported-formats) dump opencv supported format list
   #list-processor # dump processor list
-  output-format: null # The format used when running in recursive/folder mode
+  #output-format: null # The format used when running in recursive/folder mode
   png-compression: 5 # Set PNG compression level (0-9), 9 = Max compression (slowest & smallest)
   image-quality: -1 # JPEG & WebP Compression quality (-1-101, 0 being smallest size and lowest quality, -1 being default), use 101 for lossless WebP
   block-size: 0 # block size
@@ -55,15 +55,16 @@ waifu2x_converter_cpp:
 waifu2x_ncnn_vulkan:
   path: '%LOCALAPPDATA%\video2x\waifu2x-ncnn-vulkan\waifu2x-ncnn-vulkan'
   v: null # verbose output
-  #i: null # input-path: input image path (jpg/png) or directory
+  #i: null # input-path: input image path (jpg/png/webp) or directory
-  #o: null # output-path: output image path (png) or directory
+  #o: null # output-path: output image path (jpg/png/webp) or directory
   'n': 2 # noise-level: denoise level (-1/0/1/2/3, default=0)
   s: 2 # scale: upscale ratio (1/2, default=2)
   t: 400 # tile-size: tile size (>=32, default=400)
   m: null # model-path: waifu2x model path (default=models-cunet)
   g: 0 # gpu-id: gpu device to use (default=0)
-  j: '1:2:2' # thread count for load/proc/save (default=1:2:2)
+  j: '1:2:2' # thread count for load/proc/save (default=1:2:2) can be 1:2,2,2:2 for multi-gpu
   x: false # enable tta mode
+  #f: png # output image format (jpg/png/webp, default=ext/png)
 srmd_ncnn_vulkan:
   path: '%LOCALAPPDATA%\video2x\srmd-ncnn-vulkan\srmd-ncnn-vulkan'
   v: null # verbose output
@@ -76,6 +77,7 @@ srmd_ncnn_vulkan:
   g: 0 # gpu device to use (default=0)
   j: '1:2:2' # thread count for load/proc/save (default=1:2:2)
   x: false # enable tta mode
+  #f: png # output image format (jpg/png/webp, default=ext/png)
 realsr_ncnn_vulkan:
   path: '%LOCALAPPDATA%\video2x\realsr-ncnn-vulkan\realsr-ncnn-vulkan'
   v: null # verbose output
@@ -87,6 +89,7 @@ realsr_ncnn_vulkan:
   g: 0 # gpu device to use (default=0)
   j: '1:2:2' # thread count for load/proc/save (default=1:2:2)
   x: false # enable tta mode
+  #f: png # output image format (jpg/png/webp, default=ext/png)
 anime4kcpp:
   path: '%LOCALAPPDATA%\video2x\anime4kcpp\CLI\Anime4KCPP_CLI\Anime4KCPP_CLI'
   #input: null # File for loading (string [=./pic/p1.png])
@@ -100,17 +103,24 @@ anime4kcpp:
   fastMode: false # Faster but maybe low quality
   videoMode: false # Video process
   preview: null # Preview image
-  preprocessing: False # Enable pre processing
+  preprocessing: false # Enable pre processing
-  postprocessing: False # Enable post processing
+  postprocessing: false # Enable post processing
   preFilters: 4 # Enhancement filter, only working when preProcessing is true,there are 5 options by binary:Median blur=0000001, Mean blur=0000010, CAS Sharpening=0000100, Gaussian blur weak=0001000, Gaussian blur=0010000, Bilateral filter=0100000, Bilateral filter faster=1000000, you can freely combine them, eg: Gaussian blur weak + Bilateral filter = 0001000 | 0100000 = 0101000 = 40(D) (unsigned int [=4])
   postFilters: 40 # Enhancement filter, only working when postProcessing is true,there are 5 options by binary:Median blur=0000001, Mean blur=0000010, CAS Sharpening=0000100, Gaussian blur weak=0001000, Gaussian blur=0010000, Bilateral filter=0100000, Bilateral filter faster=1000000, you can freely combine them, eg: Gaussian blur weak + Bilateral filter = 0001000 | 0100000 = 0101000 = 40(D), so you can put 40 to enable Gaussian blur weak and Bilateral filter, which also is what I recommend for image that < 1080P, 48 for image that >= 1080P, and for performance I recommend to use 72 for video that < 1080P, 80 for video that >=1080P (unsigned int [=40])
-  GPUMode: False # Enable GPU acceleration
+  GPUMode: false # Enable GPU acceleration
+  CNNMode: false # Enable ACNet
+  HDN: false # Enable HDN mode for ACNet
+  HDNLevel: 1 # Set HDN level (int [=1])
   listGPUs: null # list GPUs
   platformID: 0 # Specify the platform ID (unsigned int [=0])
   deviceID: 0 # Specify the device ID (unsigned int [=0])
   codec: mp4v # Specify the codec for encoding from mp4v(recommended in Windows), dxva(for Windows), avc1(H264, recommended in Linux), vp09(very slow), hevc(not support in Windowds), av01(not support in Windowds) (string [=mp4v])
+  forceFps: 0 # Set output video fps to the specifying number, 0 to disable (float [=0])
+  disableProgress: false # disable progress display
+  webVideo: null # process the video from URL
+  alpha: false # preserve the Alpha channel for transparent image
 ffmpeg:
-  ffmpeg_path: '%LOCALAPPDATA%\video2x\ffmpeg-latest-win64-static\bin'
+  ffmpeg_path: '%LOCALAPPDATA%\video2x\ffmpeg\bin'
   intermediate_file_name: 'intermediate.mkv'
   # Step 1: Frame Extraction
   # extract all frames from original input into temporary directory
@@ -119,7 +129,7 @@ ffmpeg:
     '-y': true
     input_options: {} # empty dict, expand if necessary
     output_options:
-      '-pix_fmt': rgba64be # extracted frames pixel format
+      '-pix_fmt': rgb24 # extracted frames pixel format
       '-qscale:v': null # output image quality control for JPEG (1-31, 1 being highest)
   # Step 2: Video Assembly
   # assemble all frames back into a video with only a video track
@@ -161,12 +171,15 @@ gifski:
   # fps: 20 # Animation frames per second (for PNG frames only) [default: 20]
   fast: false # 3 times faster encoding, but 10% lower quality and bigger file
   quality: 100 # Lower quality may give smaller file
-  width: null # Maximum width
+  #width: null # Maximum width
-  height: null # Maximum height (if width is also set)
+  #height: null # Maximum height (if width is also set)
   once: false # Do not loop the GIF
   nosort: false # Use files exactly in the order given, rather than sorted
   quiet: false # Do not show a progress bar
 video2x:
-  video2x_cache_directory: null # default: %TEMP%\video2x
+  video2x_cache_directory: null # default: %TEMP%\video2x, directory where cache files are stored, will be deleted if preserve_frames is not set to true
-  image_format: png
+  extracted_frame_format: png # png/jpg intermediate file format used for extracted frames during video processing
-  preserve_frames: false
+  output_file_name_format_string: "{original_file_name}_output{extension}" # format string to use for generating output file names
+  image_output_extension: .png # image output extension during batch processing
+  video_output_extension: .mp4 # video output extension during batch processing
+  preserve_frames: false # if set to true, the cache directory won't be cleaned upon task completion

src/video2x_gui.pyproject.user

@@ -1,190 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE QtCreatorProject>
-<!-- Written by QtCreator 4.12.0, 2020-05-26T06:35:20. -->
-<qtcreator>
- <data>
-  <variable>EnvironmentId</variable>
-  <value type="QByteArray">{25c1e4a4-6b4a-4828-883b-6f32c3f7eba0}</value>
- </data>
- <data>
-  <variable>ProjectExplorer.Project.ActiveTarget</variable>
-  <value type="int">0</value>
- </data>
- <data>
-  <variable>ProjectExplorer.Project.EditorSettings</variable>
-  <valuemap type="QVariantMap">
-   <value type="bool" key="EditorConfiguration.AutoIndent">true</value>
-   <value type="bool" key="EditorConfiguration.AutoSpacesForTabs">false</value>
-   <value type="bool" key="EditorConfiguration.CamelCaseNavigation">true</value>
-   <valuemap type="QVariantMap" key="EditorConfiguration.CodeStyle.0">
-    <value type="QString" key="language">Cpp</value>
-    <valuemap type="QVariantMap" key="value">
-     <value type="QByteArray" key="CurrentPreferences">CppGlobal</value>
-    </valuemap>
-   </valuemap>
-   <valuemap type="QVariantMap" key="EditorConfiguration.CodeStyle.1">
-    <value type="QString" key="language">QmlJS</value>
-    <valuemap type="QVariantMap" key="value">
-     <value type="QByteArray" key="CurrentPreferences">QmlJSGlobal</value>
-    </valuemap>
-   </valuemap>
-   <value type="int" key="EditorConfiguration.CodeStyle.Count">2</value>
-   <value type="QByteArray" key="EditorConfiguration.Codec">UTF-8</value>
-   <value type="bool" key="EditorConfiguration.ConstrainTooltips">false</value>
-   <value type="int" key="EditorConfiguration.IndentSize">4</value>
-   <value type="bool" key="EditorConfiguration.KeyboardTooltips">false</value>
-   <value type="int" key="EditorConfiguration.MarginColumn">80</value>
-   <value type="bool" key="EditorConfiguration.MouseHiding">true</value>
-   <value type="bool" key="EditorConfiguration.MouseNavigation">true</value>
-   <value type="int" key="EditorConfiguration.PaddingMode">1</value>
-   <value type="bool" key="EditorConfiguration.ScrollWheelZooming">true</value>
-   <value type="bool" key="EditorConfiguration.ShowMargin">false</value>
-   <value type="int" key="EditorConfiguration.SmartBackspaceBehavior">0</value>
-   <value type="bool" key="EditorConfiguration.SmartSelectionChanging">true</value>
-   <value type="bool" key="EditorConfiguration.SpacesForTabs">true</value>
-   <value type="int" key="EditorConfiguration.TabKeyBehavior">0</value>
-   <value type="int" key="EditorConfiguration.TabSize">8</value>
-   <value type="bool" key="EditorConfiguration.UseGlobal">true</value>
-   <value type="int" key="EditorConfiguration.Utf8BomBehavior">1</value>
-   <value type="bool" key="EditorConfiguration.addFinalNewLine">true</value>
-   <value type="bool" key="EditorConfiguration.cleanIndentation">true</value>
-   <value type="bool" key="EditorConfiguration.cleanWhitespace">true</value>
-   <value type="bool" key="EditorConfiguration.inEntireDocument">false</value>
-  </valuemap>
- </data>
- <data>
-  <variable>ProjectExplorer.Project.PluginSettings</variable>
-  <valuemap type="QVariantMap">
-   <valuelist type="QVariantList" key="ClangCodeModel.CustomCommandLineKey">
-    <value type="QString">-fno-delayed-template-parsing</value>
-   </valuelist>
-   <value type="bool" key="ClangCodeModel.UseGlobalConfig">true</value>
-   <value type="QString" key="ClangCodeModel.WarningConfigId">Builtin.Questionable</value>
-   <valuemap type="QVariantMap" key="ClangTools">
-    <value type="bool" key="ClangTools.BuildBeforeAnalysis">true</value>
-    <value type="QString" key="ClangTools.DiagnosticConfig">Builtin.DefaultTidyAndClazy</value>
-    <value type="int" key="ClangTools.ParallelJobs">8</value>
-    <valuelist type="QVariantList" key="ClangTools.SelectedDirs"/>
-    <valuelist type="QVariantList" key="ClangTools.SelectedFiles"/>
-    <valuelist type="QVariantList" key="ClangTools.SuppressedDiagnostics"/>
-    <value type="bool" key="ClangTools.UseGlobalSettings">true</value>
-   </valuemap>
-  </valuemap>
- </data>
- <data>
-  <variable>ProjectExplorer.Project.Target.0</variable>
-  <valuemap type="QVariantMap">
-   <value type="QString" key="ProjectExplorer.ProjectConfiguration.DefaultDisplayName">Desktop (x86-windows-msvc2019-pe-64bit)</value>
-   <value type="QString" key="ProjectExplorer.ProjectConfiguration.DisplayName">Desktop (x86-windows-msvc2019-pe-64bit)</value>
-   <value type="QString" key="ProjectExplorer.ProjectConfiguration.Id">{5450e32e-f498-4c15-a0a5-7456f3375388}</value>
-   <value type="int" key="ProjectExplorer.Target.ActiveBuildConfiguration">-1</value>
-   <value type="int" key="ProjectExplorer.Target.ActiveDeployConfiguration">0</value>
-   <value type="int" key="ProjectExplorer.Target.ActiveRunConfiguration">0</value>
-   <value type="int" key="ProjectExplorer.Target.BuildConfigurationCount">0</value>
-   <valuemap type="QVariantMap" key="ProjectExplorer.Target.DeployConfiguration.0">
-    <valuemap type="QVariantMap" key="ProjectExplorer.BuildConfiguration.BuildStepList.0">
-     <value type="int" key="ProjectExplorer.BuildStepList.StepsCount">0</value>
-     <value type="QString" key="ProjectExplorer.ProjectConfiguration.DefaultDisplayName">Deploy</value>
-     <value type="QString" key="ProjectExplorer.ProjectConfiguration.DisplayName">Deploy</value>
-     <value type="QString" key="ProjectExplorer.ProjectConfiguration.Id">ProjectExplorer.BuildSteps.Deploy</value>
-    </valuemap>
-    <value type="int" key="ProjectExplorer.BuildConfiguration.BuildStepListCount">1</value>
-    <valuemap type="QVariantMap" key="ProjectExplorer.DeployConfiguration.CustomData"/>
-    <value type="bool" key="ProjectExplorer.DeployConfiguration.CustomDataEnabled">false</value>
-    <value type="QString" key="ProjectExplorer.ProjectConfiguration.Id">ProjectExplorer.DefaultDeployConfiguration</value>
-   </valuemap>
-   <value type="int" key="ProjectExplorer.Target.DeployConfigurationCount">1</value>
-   <valuemap type="QVariantMap" key="ProjectExplorer.Target.PluginSettings"/>
-   <valuemap type="QVariantMap" key="ProjectExplorer.Target.RunConfiguration.0">
-    <value type="QString" key="Analyzer.Perf.CallgraphMode">dwarf</value>
-    <valuelist type="QVariantList" key="Analyzer.Perf.Events">
-     <value type="QString">cpu-cycles</value>
-    </valuelist>
-    <valuelist type="QVariantList" key="Analyzer.Perf.ExtraArguments"/>
-    <value type="int" key="Analyzer.Perf.Frequency">250</value>
-    <valuelist type="QVariantList" key="Analyzer.Perf.RecordArguments">
-     <value type="QString">-e</value>
-     <value type="QString">cpu-cycles</value>
-     <value type="QString">--call-graph</value>
-     <value type="QString">dwarf,4096</value>
-     <value type="QString">-F</value>
-     <value type="QString">250</value>
-    </valuelist>
-    <value type="QString" key="Analyzer.Perf.SampleMode">-F</value>
-    <value type="bool" key="Analyzer.Perf.Settings.UseGlobalSettings">true</value>
-    <value type="int" key="Analyzer.Perf.StackSize">4096</value>
-    <value type="bool" key="Analyzer.QmlProfiler.AggregateTraces">false</value>
-    <value type="bool" key="Analyzer.QmlProfiler.FlushEnabled">false</value>
-    <value type="uint" key="Analyzer.QmlProfiler.FlushInterval">1000</value>
-    <value type="QString" key="Analyzer.QmlProfiler.LastTraceFile"></value>
-    <value type="bool" key="Analyzer.QmlProfiler.Settings.UseGlobalSettings">true</value>
-    <valuelist type="QVariantList" key="Analyzer.Valgrind.AddedSuppressionFiles"/>
-    <value type="bool" key="Analyzer.Valgrind.Callgrind.CollectBusEvents">false</value>
-    <value type="bool" key="Analyzer.Valgrind.Callgrind.CollectSystime">false</value>
-    <value type="bool" key="Analyzer.Valgrind.Callgrind.EnableBranchSim">false</value>
-    <value type="bool" key="Analyzer.Valgrind.Callgrind.EnableCacheSim">false</value>
-    <value type="bool" key="Analyzer.Valgrind.Callgrind.EnableEventToolTips">true</value>
-    <value type="double" key="Analyzer.Valgrind.Callgrind.MinimumCostRatio">0.01</value>
-    <value type="double" key="Analyzer.Valgrind.Callgrind.VisualisationMinimumCostRatio">10</value>
-    <value type="bool" key="Analyzer.Valgrind.FilterExternalIssues">true</value>
-    <value type="QString" key="Analyzer.Valgrind.KCachegrindExecutable">kcachegrind</value>
-    <value type="int" key="Analyzer.Valgrind.LeakCheckOnFinish">1</value>
-    <value type="int" key="Analyzer.Valgrind.NumCallers">25</value>
-    <valuelist type="QVariantList" key="Analyzer.Valgrind.RemovedSuppressionFiles"/>
-    <value type="int" key="Analyzer.Valgrind.SelfModifyingCodeDetection">1</value>
-    <value type="bool" key="Analyzer.Valgrind.Settings.UseGlobalSettings">true</value>
-    <value type="bool" key="Analyzer.Valgrind.ShowReachable">false</value>
-    <value type="bool" key="Analyzer.Valgrind.TrackOrigins">true</value>
-    <value type="QString" key="Analyzer.Valgrind.ValgrindExecutable">valgrind</value>
-    <valuelist type="QVariantList" key="Analyzer.Valgrind.VisibleErrorKinds">
-     <value type="int">0</value>
-     <value type="int">1</value>
-     <value type="int">2</value>
-     <value type="int">3</value>
-     <value type="int">4</value>
-     <value type="int">5</value>
-     <value type="int">6</value>
-     <value type="int">7</value>
-     <value type="int">8</value>
-     <value type="int">9</value>
-     <value type="int">10</value>
-     <value type="int">11</value>
-     <value type="int">12</value>
-     <value type="int">13</value>
-     <value type="int">14</value>
-    </valuelist>
-    <value type="int" key="PE.EnvironmentAspect.Base">2</value>
-    <valuelist type="QVariantList" key="PE.EnvironmentAspect.Changes"/>
-    <value type="QString" key="ProjectExplorer.ProjectConfiguration.DisplayName">video2x_gui</value>
-    <value type="QString" key="ProjectExplorer.ProjectConfiguration.Id">PythonEditor.RunConfiguration.C:/Users/k4yt3x/Documents/Projects/video2x/src/video2x_gui.py</value>
-    <value type="QString" key="ProjectExplorer.RunConfiguration.BuildKey">C:/Users/k4yt3x/Documents/Projects/video2x/src/video2x_gui.py</value>
-    <value type="bool" key="PythonEditor.RunConfiguation.Buffered">false</value>
-    <value type="QString" key="PythonEditor.RunConfiguation.Interpreter">{ffc39ed5-fbe0-4af8-8b16-9a60c393bdb8}</value>
-    <value type="QString" key="PythonEditor.RunConfiguation.Script">C:\Users\k4yt3x\Documents\Projects\video2x\src\video2x_gui.py</value>
-    <value type="QString" key="RunConfiguration.Arguments"></value>
-    <value type="bool" key="RunConfiguration.Arguments.multi">false</value>
-    <value type="QString" key="RunConfiguration.OverrideDebuggerStartup"></value>
-    <value type="bool" key="RunConfiguration.UseCppDebugger">false</value>
-    <value type="bool" key="RunConfiguration.UseCppDebuggerAuto">true</value>
-    <value type="bool" key="RunConfiguration.UseMultiProcess">false</value>
-    <value type="bool" key="RunConfiguration.UseQmlDebugger">false</value>
-    <value type="bool" key="RunConfiguration.UseQmlDebuggerAuto">true</value>
-    <value type="QString" key="RunConfiguration.WorkingDirectory"></value>
-    <value type="QString" key="RunConfiguration.WorkingDirectory.default"></value>
-   </valuemap>
-   <value type="int" key="ProjectExplorer.Target.RunConfigurationCount">1</value>
-  </valuemap>
- </data>
- <data>
-  <variable>ProjectExplorer.Project.TargetCount</variable>
-  <value type="int">1</value>
- </data>
- <data>
-  <variable>ProjectExplorer.Project.Updater.FileVersion</variable>
-  <value type="int">22</value>
- </data>
- <data>
-  <variable>Version</variable>
-  <value type="int">22</value>
- </data>
-</qtcreator>

src/video2x_setup.py

@@ -4,10 +4,11 @@
 Name: Video2X Setup Script
 Creator: K4YT3X
 Date Created: November 28, 2018
-Last Modified: May 29, 2020
+Last Modified: December 13, 2020
 
 Editor: BrianPetkovsek
 Editor: SAT3LL
+Editor: konqiDAM
 
 Description: This script helps installing all dependencies of video2x
 and generates a configuration for it.
@@ -44,34 +45,47 @@ import zipfile
 # Therefore, they will be installed during the Python dependency
 #   installation step and imported later in the script.
 
-SETUP_VERSION = '2.2.0'
+SETUP_VERSION = "2.4.1"
 
 # global static variables
-LOCALAPPDATA = pathlib.Path(os.getenv('localappdata'))
+LOCALAPPDATA = pathlib.Path(os.getenv("localappdata"))
-VIDEO2X_CONFIG = pathlib.Path(__file__).parent.absolute() / 'video2x.yaml'
+DRIVER_OPTIONS = [
-DRIVER_OPTIONS = ['all',
+    "all",
-                  'ffmpeg',
+    "ffmpeg",
-                  'gifski',
+    "gifski",
-                  'waifu2x_caffe',
+    "waifu2x_caffe",
-                  'waifu2x_converter_cpp',
+    "waifu2x_converter_cpp",
-                  'waifu2x_ncnn_vulkan',
+    "waifu2x_ncnn_vulkan",
-                  'srmd_ncnn_vulkan',
+    "srmd_ncnn_vulkan",
-                  # 'realsr_ncnn_vulkan',
+    "realsr_ncnn_vulkan",
-                  'anime4kcpp']
+    "anime4kcpp",
+]
 
 
 def parse_arguments():
-    """ parse command line arguments
+    """parse command line arguments"""
-    """
+    parser = argparse.ArgumentParser(
-    parser = argparse.ArgumentParser(formatter_class=argparse.ArgumentDefaultsHelpFormatter)
+        formatter_class=argparse.ArgumentDefaultsHelpFormatter
-    parser.add_argument('-d', '--driver', help='driver to download and configure', choices=DRIVER_OPTIONS, default='all')
+    )
-    parser.add_argument('-u', '--uninstall', help='uninstall Video2X dependencies from default location', action='store_true')
+    parser.add_argument(
+        "-d",
+        "--driver",
+        help="driver to download and configure",
+        choices=DRIVER_OPTIONS,
+        default="all",
+    )
+    parser.add_argument(
+        "-u",
+        "--uninstall",
+        help="uninstall Video2X dependencies from default location",
+        action="store_true",
+    )
     # parse arguments
     return parser.parse_args()
 
 
 class Video2xSetup:
-    """ install dependencies for video2x video enlarger
+    """install dependencies for video2x video enlarger
 
     This library is meant to be executed as a stand-alone
     script. All files will be installed under %LOCALAPPDATA%\\video2x.
@@ -86,161 +100,232 @@ class Video2xSetup:
         # regardless of which driver to install
         # always ensure Python modules are installed and up-to-date
         if self.download_python_modules:
-            print('\nInstalling Python libraries')
+            print("\nInstalling Python libraries")
             self._install_python_requirements()
 
         # if all drivers are to be installed
-        if self.driver == 'all':
+        if self.driver == "all":
-            DRIVER_OPTIONS.remove('all')
+            DRIVER_OPTIONS.remove("all")
             for driver in DRIVER_OPTIONS:
-                getattr(self, f'_install_{driver}')()
+                getattr(self, f"_install_{driver}")()
 
         # install only the selected driver
         else:
-            getattr(self, f'_install_{self.driver}')()
+            getattr(self, f"_install_{self.driver}")()
 
-        print('\nCleaning up temporary files')
+        # self._cleanup()
-        self._cleanup()
 
     def _install_python_requirements(self):
-        """ Read requirements.txt and return its content
+        """Read requirements.txt and return its content"""
-        """
+        pip_install("requirements.txt")
-        pip_install('requirements-windows.txt')
 
     def _cleanup(self):
-        """ Cleanup all the temp files downloaded
+        """Cleanup all the temp files downloaded"""
-        """
+        print("\nCleaning up temporary files")
+
         for file in self.trash:
             try:
                 if file.is_dir():
-                    print(f'Deleting directory: {file}')
+                    print(f"Deleting directory: {file}")
                     shutil.rmtree(file)
                 else:
-                    print(f'Deleting file: {file}')
+                    print(f"Deleting file: {file}")
                     file.unlink()
             except Exception:
-                print(f'Error deleting: {file}')
+                print(f"Error deleting: {file}")
                 traceback.print_exc()
 
     def _install_ffmpeg(self):
-        """ Install FFMPEG
+        """Install FFMPEG"""
-        """
+        print("\nInstalling FFmpeg")
-        print('\nInstalling FFmpeg')
 
-        latest_release = 'https://ffmpeg.zeranoe.com/builds/win64/static/ffmpeg-latest-win64-static.zip'
+        import patoolib
 
-        ffmpeg_zip = download(latest_release, tempfile.gettempdir())
+        latest_release = "https://www.gyan.dev/ffmpeg/builds/ffmpeg-release-full.7z"
-        self.trash.append(ffmpeg_zip)
 
-        with zipfile.ZipFile(ffmpeg_zip) as zipf:
+        ffmpeg_7z = download(latest_release, tempfile.gettempdir())
-            zipf.extractall(LOCALAPPDATA / 'video2x')
+        self.trash.append(ffmpeg_7z)
+
+        # if running in PyInstaller, add sys._MEIPASS\7z to path
+        # this directory contains 7za.exe and its DLL files
+        with contextlib.suppress(AttributeError):
+            os.environ["PATH"] += f";{sys._MEIPASS}\\7z"
+
+        ffmpeg_directory = LOCALAPPDATA / "video2x" / "ffmpeg"
+
+        # (ffmpeg_directory).mkdir(parents=True, exist_ok=True)
+        # pyunpack.Archive(ffmpeg_7z).extractall(ffmpeg_directory)
+        if (ffmpeg_directory).exists():
+            shutil.rmtree(ffmpeg_directory)
+        patoolib.extract_archive(str(ffmpeg_7z), outdir=str(LOCALAPPDATA / "video2x"))
+        (LOCALAPPDATA / "video2x" / ffmpeg_7z.stem).rename(ffmpeg_directory)
 
     def _install_gifski(self):
-        print('\nInstalling Gifski')
+        print("\nInstalling Gifski")
         import requests
 
-        # Get latest release of waifu2x-ncnn-vulkan via Github API
+        # Get latest release of Gifski via Github API
-        latest_release = requests.get('https://api.github.com/repos/ImageOptim/gifski/releases/latest').json()
+        releases = requests.get(
+            "https://api.github.com/repos/ImageOptim/gifski/releases"
+        ).json()
+        for release in releases:
+            for asset in release["assets"]:
+                if re.search(r"gifski-.*\.tar\.xz", asset["browser_download_url"]):
+                    gifski_tar_xz = download(
+                        asset["browser_download_url"], tempfile.gettempdir()
+                    )
+                    self.trash.append(gifski_tar_xz)
 
-        for a in latest_release['assets']:
+                    # extract and rename
-            if re.search(r'gifski-.*\.tar\.xz', a['browser_download_url']):
+                    with tarfile.open(gifski_tar_xz) as archive:
-                gifski_tar_gz = download(a['browser_download_url'], tempfile.gettempdir())
+                        archive.extractall(LOCALAPPDATA / "video2x" / "gifski")
-                self.trash.append(gifski_tar_gz)
 
-        # extract and rename
+                    return
-        with tarfile.open(gifski_tar_gz) as archive:
-            archive.extractall(LOCALAPPDATA / 'video2x' / 'gifski')
 
     def _install_waifu2x_caffe(self):
-        """ Install waifu2x_caffe
+        """Install waifu2x_caffe"""
-        """
+        print("\nInstalling waifu2x-caffe")
-        print('\nInstalling waifu2x-caffe')
         import requests
 
         # Get latest release of waifu2x-caffe via GitHub API
-        latest_release = requests.get('https://api.github.com/repos/lltcggie/waifu2x-caffe/releases/latest').json()
+        latest_release = requests.get(
+            "https://api.github.com/repos/lltcggie/waifu2x-caffe/releases/latest"
+        ).json()
 
-        for a in latest_release['assets']:
+        for a in latest_release["assets"]:
-            if 'waifu2x-caffe.zip' in a['browser_download_url']:
+            if "waifu2x-caffe.zip" in a["browser_download_url"]:
-                waifu2x_caffe_zip = download(a['browser_download_url'], tempfile.gettempdir())
+                waifu2x_caffe_zip = download(
+                    a["browser_download_url"], tempfile.gettempdir()
+                )
                 self.trash.append(waifu2x_caffe_zip)
 
         with zipfile.ZipFile(waifu2x_caffe_zip) as zipf:
-            zipf.extractall(LOCALAPPDATA / 'video2x')
+            zipf.extractall(LOCALAPPDATA / "video2x")
 
     def _install_waifu2x_converter_cpp(self):
-        """ Install waifu2x_caffe
+        """Install waifu2x_caffe"""
-        """
+        print("\nInstalling waifu2x-converter-cpp")
-        print('\nInstalling waifu2x-converter-cpp')
         import requests
 
         # Get latest release of waifu2x-caffe via GitHub API
-        latest_release = requests.get('https://api.github.com/repos/DeadSix27/waifu2x-converter-cpp/releases/latest').json()
+        latest_release = requests.get(
+            "https://api.github.com/repos/DeadSix27/waifu2x-converter-cpp/releases/latest"
+        ).json()
 
-        for a in latest_release['assets']:
+        for a in latest_release["assets"]:
-            if re.search(r'waifu2x-DeadSix27-win64_v[0-9]*\.zip', a['browser_download_url']):
+            if re.search(
-                waifu2x_converter_cpp_zip = download(a['browser_download_url'], tempfile.gettempdir())
+                r"waifu2x-DeadSix27-win64_v[0-9]*\.zip", a["browser_download_url"]
+            ):
+                waifu2x_converter_cpp_zip = download(
+                    a["browser_download_url"], tempfile.gettempdir()
+                )
                 self.trash.append(waifu2x_converter_cpp_zip)
 
         with zipfile.ZipFile(waifu2x_converter_cpp_zip) as zipf:
-            zipf.extractall(LOCALAPPDATA / 'video2x' / 'waifu2x-converter-cpp')
+            zipf.extractall(LOCALAPPDATA / "video2x" / "waifu2x-converter-cpp")
 
     def _install_waifu2x_ncnn_vulkan(self):
-        """ Install waifu2x-ncnn-vulkan
+        """Install waifu2x-ncnn-vulkan"""
-        """
+        print("\nInstalling waifu2x-ncnn-vulkan")
-        print('\nInstalling waifu2x-ncnn-vulkan')
         import requests
 
         # Get latest release of waifu2x-ncnn-vulkan via Github API
-        latest_release = requests.get('https://api.github.com/repos/nihui/waifu2x-ncnn-vulkan/releases/latest').json()
+        latest_release = requests.get(
+            "https://api.github.com/repos/nihui/waifu2x-ncnn-vulkan/releases/latest"
+        ).json()
 
-        for a in latest_release['assets']:
+        for a in latest_release["assets"]:
-            if re.search(r'waifu2x-ncnn-vulkan-\d*\.zip', a['browser_download_url']):
+            if re.search(
-                waifu2x_ncnn_vulkan_zip = download(a['browser_download_url'], tempfile.gettempdir())
+                r"waifu2x-ncnn-vulkan-\d*-windows\.zip", a["browser_download_url"]
+            ):
+                waifu2x_ncnn_vulkan_zip = download(
+                    a["browser_download_url"], tempfile.gettempdir()
+                )
                 self.trash.append(waifu2x_ncnn_vulkan_zip)
 
         # extract and rename
-        waifu2x_ncnn_vulkan_directory = LOCALAPPDATA / 'video2x' / 'waifu2x-ncnn-vulkan'
+        waifu2x_ncnn_vulkan_directory = LOCALAPPDATA / "video2x" / "waifu2x-ncnn-vulkan"
         with zipfile.ZipFile(waifu2x_ncnn_vulkan_zip) as zipf:
-            zipf.extractall(LOCALAPPDATA / 'video2x')
+            zipf.extractall(LOCALAPPDATA / "video2x")
 
             # if directory already exists, remove it
             if waifu2x_ncnn_vulkan_directory.exists():
                 shutil.rmtree(waifu2x_ncnn_vulkan_directory)
 
             # rename the newly extracted directory
-            (LOCALAPPDATA / 'video2x' / zipf.namelist()[0]).rename(waifu2x_ncnn_vulkan_directory)
+            (LOCALAPPDATA / "video2x" / zipf.namelist()[0]).rename(
+                waifu2x_ncnn_vulkan_directory
+            )
+
+    def _install_srmd_ncnn_vulkan(self):
+        """Install srmd-ncnn-vulkan"""
+        print("\nInstalling srmd-ncnn-vulkan")
+        import requests
+
+        # Get latest release of srmd-ncnn-vulkan via Github API
+        latest_release = requests.get(
+            "https://api.github.com/repos/nihui/srmd-ncnn-vulkan/releases/latest"
+        ).json()
+
+        for a in latest_release["assets"]:
+            if re.search(
+                r"srmd-ncnn-vulkan-\d*-windows\.zip", a["browser_download_url"]
+            ):
+                srmd_ncnn_vulkan_zip = download(
+                    a["browser_download_url"], tempfile.gettempdir()
+                )
+                self.trash.append(srmd_ncnn_vulkan_zip)
+
+        # extract and rename
+        srmd_ncnn_vulkan_directory = LOCALAPPDATA / "video2x" / "srmd-ncnn-vulkan"
+        with zipfile.ZipFile(srmd_ncnn_vulkan_zip) as zipf:
+            zipf.extractall(LOCALAPPDATA / "video2x")
+
+            # if directory already exists, remove it
+            if srmd_ncnn_vulkan_directory.exists():
+                shutil.rmtree(srmd_ncnn_vulkan_directory)
+
+            # rename the newly extracted directory
+            (LOCALAPPDATA / "video2x" / zipf.namelist()[0]).rename(
+                srmd_ncnn_vulkan_directory
+            )
 
     def _install_realsr_ncnn_vulkan(self):
-        """ Install realsr-ncnn-vulkan
+        """Install realsr-ncnn-vulkan"""
-        """
+        print("\nInstalling realsr-ncnn-vulkan")
-        print('\nInstalling realsr-ncnn-vulkan')
         import requests
 
         # Get latest release of realsr-ncnn-vulkan via Github API
-        latest_release = requests.get('https://api.github.com/repos/nihui/realsr-ncnn-vulkan/releases/latest').json()
+        latest_release = requests.get(
+            "https://api.github.com/repos/nihui/realsr-ncnn-vulkan/releases/latest"
+        ).json()
 
-        for a in latest_release['assets']:
+        for a in latest_release["assets"]:
-            if re.search(r'realsr-ncnn-vulkan-\d*\.zip', a['browser_download_url']):
+            if re.search(
-                realsr_ncnn_vulkan_zip = download(a['browser_download_url'], tempfile.gettempdir())
+                r"realsr-ncnn-vulkan-\d*-windows\.zip", a["browser_download_url"]
+            ):
+                realsr_ncnn_vulkan_zip = download(
+                    a["browser_download_url"], tempfile.gettempdir()
+                )
                 self.trash.append(realsr_ncnn_vulkan_zip)
 
         # extract and rename
-        realsr_ncnn_vulkan_directory = LOCALAPPDATA / 'video2x' / 'realsr-ncnn-vulkan'
+        realsr_ncnn_vulkan_directory = LOCALAPPDATA / "video2x" / "realsr-ncnn-vulkan"
         with zipfile.ZipFile(realsr_ncnn_vulkan_zip) as zipf:
-            zipf.extractall(LOCALAPPDATA / 'video2x')
+            zipf.extractall(LOCALAPPDATA / "video2x")
 
             # if directory already exists, remove it
             if realsr_ncnn_vulkan_directory.exists():
                 shutil.rmtree(realsr_ncnn_vulkan_directory)
 
             # rename the newly extracted directory
-            (LOCALAPPDATA / 'video2x' / zipf.namelist()[0]).rename(realsr_ncnn_vulkan_directory)
+            (LOCALAPPDATA / "video2x" / zipf.namelist()[0]).rename(
+                realsr_ncnn_vulkan_directory
+            )
 
     def _install_anime4kcpp(self):
-        """ Install Anime4KCPP
+        """Install Anime4KCPP"""
-        """
+        print("\nInstalling Anime4KCPP")
-        print('\nInstalling Anime4KCPP')
 
         import patoolib
         import requests
@@ -248,54 +333,35 @@ class Video2xSetup:
         # get latest release of Anime4KCPP via Github API
         # at the time of writing this portion, Anime4KCPP doesn't yet have a stable release
         # therefore releases/latest won't work
-        latest_release = requests.get('https://api.github.com/repos/TianZerL/Anime4KCPP/releases/latest').json()
+        latest_release = requests.get(
+            "https://api.github.com/repos/TianZerL/Anime4KCPP/releases/latest"
+        ).json()
 
-        for a in latest_release['assets']:
+        for a in latest_release["assets"]:
-            if re.search(r'Anime4KCPP_CLI-.*-Win64-msvc\.7z', a['browser_download_url']):
+            if re.search(
-                anime4kcpp_7z = download(a['browser_download_url'], tempfile.gettempdir())
+                r"Anime4KCPP_CLI-.*-Win64-msvc\.7z", a["browser_download_url"]
+            ):
+                anime4kcpp_7z = download(
+                    a["browser_download_url"], tempfile.gettempdir()
+                )
                 self.trash.append(anime4kcpp_7z)
 
         # if running in PyInstaller, add sys._MEIPASS\7z to path
         # this directory contains 7za.exe and its DLL files
         with contextlib.suppress(AttributeError):
-            os.environ['PATH'] += f';{sys._MEIPASS}\\7z'
+            os.environ["PATH"] += f";{sys._MEIPASS}\\7z"
 
         # (LOCALAPPDATA / 'video2x' / 'anime4kcpp').mkdir(parents=True, exist_ok=True)
         # pyunpack.Archive(anime4kcpp_7z).extractall(LOCALAPPDATA / 'video2x' / 'anime4kcpp')
-        if (LOCALAPPDATA / 'video2x' / 'anime4kcpp').exists():
+        if (LOCALAPPDATA / "video2x" / "anime4kcpp").exists():
-            shutil.rmtree(LOCALAPPDATA / 'video2x' / 'anime4kcpp')
+            shutil.rmtree(LOCALAPPDATA / "video2x" / "anime4kcpp")
-        patoolib.extract_archive(str(anime4kcpp_7z), outdir=str(LOCALAPPDATA / 'video2x' / 'anime4kcpp'))
+        patoolib.extract_archive(
-
+            str(anime4kcpp_7z), outdir=str(LOCALAPPDATA / "video2x" / "anime4kcpp")
-    def _install_srmd_ncnn_vulkan(self):
+        )
-        """ Install srmd-ncnn-vulkan
-        """
-        print('\nInstalling srmd-ncnn-vulkan')
-        import requests
-
-        # Get latest release of srmd-ncnn-vulkan via Github API
-        latest_release = requests.get('https://api.github.com/repos/nihui/srmd-ncnn-vulkan/releases/latest').json()
-
-        for a in latest_release['assets']:
-            if re.search(r'srmd-ncnn-vulkan-\d*\.zip', a['browser_download_url']):
-                srmd_ncnn_vulkan_zip = download(a['browser_download_url'], tempfile.gettempdir())
-                self.trash.append(srmd_ncnn_vulkan_zip)
-
-        # extract and rename
-        srmd_ncnn_vulkan_directory = LOCALAPPDATA / 'video2x' / 'srmd-ncnn-vulkan'
-        with zipfile.ZipFile(srmd_ncnn_vulkan_zip) as zipf:
-            zipf.extractall(LOCALAPPDATA / 'video2x')
-
-            # if directory already exists, remove it
-            if srmd_ncnn_vulkan_directory.exists():
-                shutil.rmtree(srmd_ncnn_vulkan_directory)
-
-            # rename the newly extracted directory
-            (LOCALAPPDATA / 'video2x' / zipf.namelist()[0]).rename(srmd_ncnn_vulkan_directory)
 
 
 def download(url, save_path, chunk_size=4096):
-    """ Download file to local with requests library
+    """Download file to local with requests library"""
-    """
     from tqdm import tqdm
     import requests
 
@@ -309,14 +375,14 @@ def download(url, save_path, chunk_size=4096):
 
     # get file name
     file_name = None
-    if 'content-disposition' in stream.headers:
+    if "content-disposition" in stream.headers:
-        disposition = stream.headers['content-disposition']
+        disposition = stream.headers["content-disposition"]
         with contextlib.suppress(IndexError):
             file_name = re.findall("filename=(.+)", disposition)[0].strip('"')
 
     if file_name is None:
         # output_file = f'{save_path}\\{stream.url.split("/")[-1]}'
-        output_file = save_path / stream.url.split('/')[-1]
+        output_file = save_path / stream.url.split("/")[-1]
     else:
         output_file = save_path / file_name
 
@@ -325,17 +391,17 @@ def download(url, save_path, chunk_size=4096):
 
     # get total size for progress bar if provided in headers
     total_size = 0
-    if 'content-length' in stream.headers:
+    if "content-length" in stream.headers:
-        total_size = int(stream.headers['content-length'])
+        total_size = int(stream.headers["content-length"])
 
     # print download information summary
-    print(f'Downloading: {url}')
+    print(f"Downloading: {url}")
-    print(f'Total size: {total_size}')
+    print(f"Total size: {total_size}")
-    print(f'Chunk size: {chunk_size}')
+    print(f"Chunk size: {chunk_size}")
-    print(f'Saving to: {output_file}')
+    print(f"Saving to: {output_file}")
 
     # Write content into file
-    with open(output_file, 'wb') as output:
+    with open(output_file, "wb") as output:
         with tqdm(total=total_size, ascii=True) as progress_bar:
             for chunk in stream.iter_content(chunk_size=chunk_size):
                 if chunk:
@@ -347,16 +413,18 @@ def download(url, save_path, chunk_size=4096):
 
 
 def pip_install(file):
-    """ Install python package via python pip module
+    """Install python package via python pip module
 
     pip.main() is not available after pip 9.0.1, thus
     pip module is not used in this case.
     """
-    return subprocess.run([sys.executable, '-m', 'pip', 'install', '-U', '-r', file]).returncode
+    return subprocess.run(
+        [sys.executable, "-m", "pip", "install", "-U", "-r", file]
+    ).returncode
 
 
-if __name__ != '__main__':
+if __name__ != "__main__":
-    raise ImportError('video2x_setup cannot be imported')
+    raise ImportError("video2x_setup cannot be imported")
 
 try:
     # set default exit code
@@ -366,42 +434,47 @@ try:
     start_time = time.time()
 
     # check platform
-    if platform.system() != 'Windows':
+    if platform.system() != "Windows":
-        print('This script is currently only compatible with Windows')
+        print("This script is currently only compatible with Windows")
         EXIT_CODE = 1
         sys.exit(1)
 
     # parse command line arguments
     args = parse_arguments()
-    print('Video2X Setup Script')
+    print("Video2X Setup Script")
-    print(f'Version: {SETUP_VERSION}')
+    print(f"Version: {SETUP_VERSION}")
 
     # uninstall video2x dependencies
     if args.uninstall:
-        if input('Are you sure you want to uninstall all Video2X dependencies? [y/N]: ').lower() == 'y':
+        if (
+            input(
+                "Are you sure you want to uninstall all Video2X dependencies? [y/N]: "
+            ).lower()
+            == "y"
+        ):
             try:
                 print(f'Removing: {LOCALAPPDATA / "video2x"}')
-                shutil.rmtree(LOCALAPPDATA / 'video2x')
+                shutil.rmtree(LOCALAPPDATA / "video2x")
-                print('Successfully uninstalled all dependencies')
+                print("Successfully uninstalled all dependencies")
             except FileNotFoundError:
                 print(f'Dependency folder does not exist: {LOCALAPPDATA / "video2x"}')
         else:
-            print('Uninstallation aborted')
+            print("Uninstallation aborted")
 
     # run installation
     else:
         # do not install pip modules if script
         # is packaged in exe format
         download_python_modules = True
-        if sys.argv[0].endswith('.exe'):
+        if sys.argv[0].endswith(".exe"):
-            print('\nScript is packaged as exe, skipping pip module download')
+            print("\nScript is packaged as exe, skipping pip module download")
             download_python_modules = False
 
         # create setup install instance and run installer
         setup = Video2xSetup(args.driver, download_python_modules)
         setup.run()
 
-        print('\nScript finished successfully')
+        print("\nScript finished successfully")
 
 # let SystemExit signals pass through
 except SystemExit as e:
@@ -411,35 +484,35 @@ except SystemExit as e:
 # user needs to run this with higher privilege
 except PermissionError:
     traceback.print_exc()
-    print('You might have insufficient privilege for this script to run')
+    print("You might have insufficient privilege for this script to run")
-    print('Try running this script with Administrator privileges')
+    print("Try running this script with Administrator privileges")
     EXIT_CODE = 1
 
 # for any exception in the script
 except Exception:
     traceback.print_exc()
-    print('An error has occurred')
+    print("An error has occurred")
-    print('Video2X Automatic Setup has failed')
+    print("Video2X Automatic Setup has failed")
-
-    # in case of a failure, try cleaning up temp files
-    try:
-        setup._cleanup()
-    except Exception:
-        traceback.print_exc()
-        print('An error occurred while trying to cleanup files')
 
     EXIT_CODE = 1
 
 # regardless if script finishes successfully or not
 # print script execution summary
 finally:
-    print('Script finished')
+    # always try cleaning up trash
-    print(f'Time taken: {timedelta(seconds=round(time.time() - start_time))}')
+    try:
+        setup._cleanup()
+    except Exception:
+        traceback.print_exc()
+        print("An error occurred while trying to cleanup files")
+
+    print("Script finished")
+    print(f"Time taken: {timedelta(seconds=round(time.time() - start_time))}")
 
     # if the program is launched as an Windows PE file
     # it might be launched from double clicking
     # pause the window before it closes automatically
-    if sys.argv[0].endswith('.exe'):
+    if sys.argv[0].endswith(".exe"):
-        input('Press [ENTER] to exit script')
+        input("Press [ENTER] to exit script")
 
     sys.exit(EXIT_CODE)

src/video2x_setup_ubuntu.sh

@@ -0,0 +1,246 @@
+#!/usr/bin/bash -e
+# Name: Video2X Setup Script (Ubuntu)
+# Creator: K4YT3X
+# Date Created: June 5, 2020
+# Last Modified: September 4, 2020
+
+# help message if input is incorrect of if -h/--help is specified
+if [ "$1" == "-h" ] || [ "$1" == "--help" ] || [ "$#" -gt 2 ]; then
+    echo "usage: $0 INSTALLATION_PATH TEMP"
+    exit 0
+fi
+
+# set intallation path if specified
+if [ ! -z "$1" ]; then
+    export INSTALLATION_PATH=$1
+else
+    export INSTALLATION_PATH="$HOME/.local/share"
+fi
+
+# set temp directory location if specified
+if [ ! -z "$2" ]; then
+    export TEMP=$2
+else
+    export TEMP="/tmp/video2x"
+fi
+
+# environment variables
+export DEBIAN_FRONTEND="noninteractive"
+
+# install basic utilities and add PPAs
+apt-get update
+apt-get install -y --no-install-recommends apt-utils software-properties-common
+
+# add PPAs and sources
+add-apt-repository -y ppa:apt-fast/stable
+add-apt-repository -y ppa:graphics-drivers/ppa
+apt-get install -y --no-install-recommends apt-fast aria2
+apt-fast update
+
+# install runtime packages
+apt-fast install -y --no-install-recommends ffmpeg libmagic1 nvidia-cuda-toolkit nvidia-driver-440 python3.8
+
+# install compilation packages
+apt-fast install -y --no-install-recommends git-core curl wget ca-certificates gnupg2 python3-dev python3-pip python3-setuptools python3-wheel
+
+# add Nvidia sources
+curl -fsSL https://developer.download.nvidia.com/compute/cuda/repos/ubuntu1804/x86_64/7fa2af80.pub | apt-key add -
+echo "deb https://developer.download.nvidia.com/compute/machine-learning/repos/ubuntu1804/x86_64 /" >/etc/apt/sources.list.d/nvidia-ml.list
+apt-fast update
+
+# install python3 packages
+git clone --recurse-submodules --progress https://github.com/k4yt3x/video2x.git --depth=1 $INSTALLATION_PATH/video2x
+python3.8 -m pip install -U pip
+python3.8 -m pip install -U -r $INSTALLATION_PATH/video2x/src/requirements.txt
+mkdir -v -p $INSTALLATION_PATH/video2x/src/dependencies
+
+# install gifski
+# cargo from APT might be outdate and will result in gifski components not being built successfully
+# apt-fast install -y --no-install-recommends cargo
+curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | bash -s -- -y
+source $HOME/.cargo/env
+cargo install gifski
+
+# install waifu2x-caffe
+apt-fast install -y --no-install-recommends autoconf build-essential cmake gcc-8 libatlas-base-dev libboost-atomic-dev libboost-chrono-dev libboost-date-time-dev libboost-filesystem-dev libboost-iostreams-dev libboost-python-dev libboost-system-dev libboost-thread-dev libcudnn7 libcudnn7-dev libgflags-dev libgoogle-glog-dev libhdf5-dev libleveldb-dev liblmdb-dev libopencv-dev libprotobuf-dev libsnappy-dev protobuf-compiler python-dev python-numpy texinfo yasm zlib1g-dev
+
+git clone --recurse-submodules --depth=1 --progress --recurse-submodules https://github.com/nagadomi/waifu2x-caffe-ubuntu.git $TEMP/waifu2x-caffe-ubuntu
+git clone --recurse-submodules --progress --depth=1 https://github.com/nagadomi/caffe.git $TEMP/waifu2x-caffe-ubuntu/caffe
+
+export CC=/usr/bin/gcc-8
+export CXX=/usr/bin/g++-8
+mkdir -v -p $TEMP/waifu2x-caffe-ubuntu/build
+cd $TEMP/waifu2x-caffe-ubuntu/build
+cmake .. -DCMAKE_INSTALL_PREFIX=/usr
+make -j$(nproc) install
+
+mv -v /tmp/video2x/waifu2x-caffe-ubuntu/bin $INSTALLATION_PATH/video2x/src/dependencies/waifu2x-caffe
+mv -v /tmp/video2x/waifu2x-caffe-ubuntu/build/waifu2x-caffe $INSTALLATION_PATH/video2x/src/dependencies/waifu2x-caffe/waifu2x-caffe
+
+# install waifu2x-converter-cpp
+apt-fast install -y --no-install-recommends build-essential cmake libopencv-dev beignet-opencl-icd mesa-opencl-icd nvidia-cuda-toolkit ocl-icd-opencl-dev opencl-headers
+git clone --recurse-submodules --depth=1 --progress https://github.com/DeadSix27/waifu2x-converter-cpp $TEMP/waifu2x-converter-cpp
+mkdir -v $TEMP/waifu2x-converter-cpp/build
+cd $TEMP/waifu2x-converter-cpp/build
+cmake ..
+make -j$(nproc)
+ldconfig
+mv -v $TEMP/waifu2x-converter-cpp/build $INSTALLATION_PATH/video2x/src/dependencies/waifu2x-converter-cpp
+mv -v $TEMP/waifu2x-converter-cpp/models_rgb $INSTALLATION_PATH/video2x/src/dependencies/waifu2x-converter-cpp/models_rgb
+
+# install waifu2x-ncnn-vulkan
+# download libvulkan1
+apt-fast install -y --no-install-recommends libvulkan1 unzip jq
+
+# get latest release JSON as a string
+echo "Fetching latest waifu2x-ncnn-vulkan release information using GitHub API"
+waifu2x_ncnn_vulkan_latest_release=$(curl -s https://api.github.com/repos/nihui/waifu2x-ncnn-vulkan/releases/latest)
+
+# count the number of assets in this release
+assets=$(echo "$waifu2x_ncnn_vulkan_latest_release" | jq -r '.assets | length')
+
+# iterate through each of the assets and see if the name of the asset matches what we're looking for
+for i in $(seq $assets $END); do
+    if echo "$waifu2x_ncnn_vulkan_latest_release" | jq -r ".assets["$(($i - 1))"].name" | egrep "^waifu2x-ncnn-vulkan-[0-9]*-linux\.zip$"; then
+        download_link=$(echo "$waifu2x_ncnn_vulkan_latest_release" | jq -r ".assets["$(($i - 1))"].browser_download_url")
+        break
+    fi
+done
+
+# check if download_link variable is set
+if [ -z "$download_link" ]; then
+    echo "$waifu2x_ncnn_vulkan_latest_release"
+    echo "Error: unable to find waifu2x-ncnn-vulkan download link or GitHub API rate limit exceeded"
+    exit 1
+fi
+
+waifu2x_ncnn_vulkan_zip="$TEMP/waifu2x-ncnn-vulkan-linux.zip"
+echo "Downloading $download_link to $waifu2x_ncnn_vulkan_zip"
+aria2c "$download_link" --dir / -o "$waifu2x_ncnn_vulkan_zip"
+unzip "$waifu2x_ncnn_vulkan_zip" -d $TEMP/waifu2x-ncnn-vulkan
+mv -v $TEMP/waifu2x-ncnn-vulkan/waifu2x-ncnn-vulkan-*-linux $INSTALLATION_PATH/video2x/src/dependencies/waifu2x-ncnn-vulkan
+
+# install srmd-ncnn-vulkan
+# download libvulkan1
+apt-fast install -y --no-install-recommends libvulkan1 unzip jq
+
+# get latest release JSON as a string
+echo "Fetching latest srmd-ncnn-vulkan release information using GitHub API"
+srmd_ncnn_vulkan_latest_release=$(curl -s https://api.github.com/repos/nihui/srmd-ncnn-vulkan/releases/latest)
+
+# count the number of assets in this release
+assets=$(echo "$srmd_ncnn_vulkan_latest_release" | jq -r '.assets | length')
+
+# iterate through each of the assets and see if the name of the asset matches what we're looking for
+for i in $(seq $assets $END); do
+    if echo "$srmd_ncnn_vulkan_latest_release" | jq -r ".assets["$(($i - 1))"].name" | egrep "^srmd-ncnn-vulkan-[0-9]*-linux\.zip$"; then
+        download_link=$(echo "$srmd_ncnn_vulkan_latest_release" | jq -r ".assets["$(($i - 1))"].browser_download_url")
+        break
+    fi
+done
+
+# check if download_link variable is set
+if [ -z "$download_link" ]; then
+    echo "$srmd_ncnn_vulkan_latest_release"
+    echo "Error: unable to find srmd-ncnn-vulkan download link or GitHub API rate limit exceeded"
+    exit 1
+fi
+
+srmd_ncnn_vulkan_zip="$TEMP/srmd-ncnn-vulkan-linux.zip"
+echo "Downloading $download_link to $srmd_ncnn_vulkan_zip"
+aria2c "$download_link" --dir / -o "$srmd_ncnn_vulkan_zip"
+unzip "$srmd_ncnn_vulkan_zip" -d $TEMP/srmd-ncnn-vulkan
+mv -v $TEMP/srmd-ncnn-vulkan/srmd-ncnn-vulkan-*-linux $INSTALLATION_PATH/video2x/src/dependencies/srmd-ncnn-vulkan
+
+# install realsr-ncnn-vulkan
+# download libvulkan1
+apt-fast install -y --no-install-recommends libvulkan1 unzip jq
+
+# get latest release JSON as a string
+echo "Fetching latest realsr-ncnn-vulkan release information using GitHub API"
+realsr_ncnn_vulkan_latest_release=$(curl -s https://api.github.com/repos/nihui/realsr-ncnn-vulkan/releases/latest)
+
+# count the number of assets in this release
+assets=$(echo "$realsr_ncnn_vulkan_latest_release" | jq -r '.assets | length')
+
+# iterate through each of the assets and see if the name of the asset matches what we're looking for
+for i in $(seq $assets $END); do
+    if echo "$realsr_ncnn_vulkan_latest_release" | jq -r ".assets["$(($i - 1))"].name" | egrep "^realsr-ncnn-vulkan-[0-9]*-linux\.zip$"; then
+        download_link=$(echo "$realsr_ncnn_vulkan_latest_release" | jq -r ".assets["$(($i - 1))"].browser_download_url")
+        break
+    fi
+done
+
+# check if download_link variable is set
+if [ -z "$download_link" ]; then
+    echo "$realsr_ncnn_vulkan_latest_release"
+    echo "Error: unable to find realsr-ncnn-vulkan download link or GitHub API rate limit exceeded"
+    exit 1
+fi
+
+realsr_ncnn_vulkan_zip="$TEMP/realsr-ncnn-vulkan-linux.zip"
+echo "Downloading $download_link to $realsr_ncnn_vulkan_zip"
+aria2c "$download_link" --dir / -o "$realsr_ncnn_vulkan_zip"
+unzip "$realsr_ncnn_vulkan_zip" -d $TEMP/realsr-ncnn-vulkan
+mv -v $TEMP/realsr-ncnn-vulkan/realsr-ncnn-vulkan-*-linux $INSTALLATION_PATH/video2x/src/dependencies/realsr-ncnn-vulkan
+
+# install Anime4KCPP
+# install the latest cmake for compiling Anime4KCPP
+aria2c https://github.com/Kitware/CMake/releases/download/v3.18.2/cmake-3.18.2-Linux-x86_64.sh --dir / -o "$TEMP/cmake.sh"
+mkdir $TEMP/cmake
+bash "$TEMP/cmake.sh" --prefix=$TEMP/cmake --skip-license
+
+# build and install Anime4KCPP
+apt-fast install -y --no-install-recommends libopencv-dev opencl-dev
+git clone --recurse-submodules --depth=1 --progress https://github.com/TianZerL/Anime4KCPP.git $TEMP/anime4kcpp
+mkdir -v $TEMP/anime4kcpp/build
+cd $TEMP/anime4kcpp/build
+$TEMP/cmake/bin/cmake -DBuild_GUI=OFF ..
+make -j$(nproc)
+mv -v $TEMP/anime4kcpp/build $INSTALLATION_PATH/video2x/src/dependencies/anime4kcpp
+ln -s $INSTALLATION_PATH/video2x/src/dependencies/anime4kcpp/bin/libAnime4KCPPCore.so /usr/lib
+
+# rewrite config file values
+python3.8 - <<EOF
+import yaml
+import os
+
+
+INSTALLATION_PATH = os.environ['INSTALLATION_PATH']
+
+with open('{}/video2x/src/video2x.yaml'.format(INSTALLATION_PATH), 'r') as template:
+    template_dict = yaml.load(template, Loader=yaml.FullLoader)
+    template.close()
+
+template_dict['ffmpeg']['ffmpeg_path'] = '/usr/bin'
+template_dict['gifski']['gifski_path'] = '/root/.cargo/bin/gifski'
+template_dict['waifu2x_caffe']['path'] = '{}/video2x/src/dependencies/waifu2x-caffe/waifu2x-caffe'.format(INSTALLATION_PATH)
+template_dict['waifu2x_converter_cpp']['path'] = '{}/video2x/src/dependencies/waifu2x-converter-cpp/waifu2x-converter-cpp'.format(INSTALLATION_PATH)
+template_dict['waifu2x_ncnn_vulkan']['path'] = '{}/video2x/src/dependencies/waifu2x-ncnn-vulkan/waifu2x-ncnn-vulkan'.format(INSTALLATION_PATH)
+template_dict['srmd_ncnn_vulkan']['path'] = '{}/video2x/src/dependencies/srmd-ncnn-vulkan/srmd-ncnn-vulkan'.format(INSTALLATION_PATH)
+template_dict['realsr_ncnn_vulkan']['path'] = '{}/video2x/src/dependencies/realsr-ncnn-vulkan/realsr-ncnn-vulkan'.format(INSTALLATION_PATH)
+template_dict['anime4kcpp']['path'] = '{}/video2x/src/dependencies/anime4kcpp/bin/Anime4KCPP_CLI'.format(INSTALLATION_PATH)
+
+# write configuration into file
+with open('{}/video2x/src/video2x.yaml'.format(INSTALLATION_PATH), 'w') as config:
+    yaml.dump(template_dict, config)
+EOF
+
+# clean up temp directory
+# purge default utilities
+# apt-get purge -y git-core curl wget ca-certificates gnupg2 python3-dev python3-pip python3-setuptools
+
+# purge waifu2x-caffe build dependencies
+# apt-get purge -y autoconf build-essential cmake gcc-8 libatlas-base-dev libboost-atomic-dev libboost-chrono-dev libboost-date-time-dev libboost-filesystem-dev libboost-iostreams-dev libboost-python-dev libboost-system-dev libboost-thread-dev libcudnn7 libcudnn7-dev libgflags-dev libgoogle-glog-dev libhdf5-dev libleveldb-dev liblmdb-dev libopencv-dev libprotobuf-dev libsnappy-dev protobuf-compiler python-numpy texinfo yasm zlib1g-dev
+
+# purge waifu2x-converter-cpp build dependencies
+# apt-get purge -y libopencv-dev ocl-icd-opencl-dev
+
+# purge waifu2x/srmd/realsr-ncnn-vulkan build dependencies
+# apt-get purge -y unzip jq
+
+# run autoremove and purge all unused packages
+# apt-get autoremove --purge -y
+
+# remove temp directory
+rm -rf $TEMP

src/wrappers/anime4kcpp.py

@@ -1,13 +1,16 @@
 #!/usr/bin/env python3
 # -*- coding: utf-8 -*-
 """
-Name: Waifu2x Caffe Driver
+Name: Anime4KCPP Driver
 Author: K4YT3X
 Date Created: May 3, 2020
-Last Modified: May 11, 2020
+Last Modified: December 15, 2020
+
+Editor: fire0shadow
+Last Modified: December 15, 2020
 
 Description: This class is a high-level wrapper
-for waifu2x-caffe.
+for Anime4KCPP.
 """
 
 # built-in imports
@@ -15,8 +18,8 @@ import argparse
 import os
 import pathlib
 import platform
-import shlex
 import subprocess
+import sys
 import threading
 
 # third-party imports
@@ -24,8 +27,7 @@ from avalon_framework import Avalon
 
 
 class WrapperMain:
-    """ Anime4K CPP wrapper
+    """Anime4K CPP wrapper"""
-    """
 
     def __init__(self, driver_settings):
         self.driver_settings = driver_settings
@@ -35,43 +37,55 @@ class WrapperMain:
     def zero_to_one_float(value):
         value = float(value)
         if value < 0.0 or value > 1.0:
-            raise argparse.ArgumentTypeError(f'{value} is not between 0.0 and 1.0')
+            raise argparse.ArgumentTypeError(f"{value} is not between 0.0 and 1.0")
         return value
 
     @staticmethod
     def parse_arguments(arguments):
+        # fmt: off
         parser = argparse.ArgumentParser(formatter_class=argparse.ArgumentDefaultsHelpFormatter, add_help=False)
         parser.error = lambda message: (_ for _ in ()).throw(AttributeError(message))
-        parser.add_argument('--help', action='help', help='show this help message and exit')
+        parser.add_argument("--help", action="help", help="show this help message and exit")
-        parser.add_argument('-i', '--input', type=str, help=argparse.SUPPRESS)  # help='File for loading')
+        parser.add_argument("-i", "--input", type=str, help=argparse.SUPPRESS)  # help="File for loading")
-        parser.add_argument('-o', '--output', type=str, help=argparse.SUPPRESS)  # help='File for outputting')
+        parser.add_argument("-o", "--output", type=str, help=argparse.SUPPRESS)  # help="File for outputting")
-        parser.add_argument('-p', '--passes', type=int, help='Passes for processing')
+        parser.add_argument("-p", "--passes", type=int, help="Passes for processing")
-        parser.add_argument('-n', '--pushColorCount', type=int, help='Limit the number of color pushes')
+        parser.add_argument("-n", "--pushColorCount", type=int, help="Limit the number of color pushes")
-        parser.add_argument('-c', '--strengthColor', type=WrapperMain.zero_to_one_float, help='Strength for pushing color,range 0 to 1,higher for thinner')
+        parser.add_argument("-c", "--strengthColor", type=WrapperMain.zero_to_one_float, help="Strength for pushing color,range 0 to 1,higher for thinner")
-        parser.add_argument('-g', '--strengthGradient', type=WrapperMain.zero_to_one_float, help='Strength for pushing gradient,range 0 to 1,higher for sharper')
+        parser.add_argument("-g", "--strengthGradient", type=WrapperMain.zero_to_one_float, help="Strength for pushing gradient,range 0 to 1,higher for sharper")
-        parser.add_argument('-z', '--zoomFactor', type=float, help='zoom factor for resizing')
+        parser.add_argument("-z", "--zoomFactor", type=float, help="zoom factor for resizing")
-        parser.add_argument('-t', '--threads', type=int, help='Threads count for video processing')
+        parser.add_argument("-t", "--threads", type=int, help="Threads count for video processing")
-        parser.add_argument('-f', '--fastMode', action='store_true', help='Faster but maybe low quality')
+        parser.add_argument("-f", "--fastMode", action="store_true", help="Faster but maybe low quality")
-        parser.add_argument('-v', '--videoMode', action='store_true', help='Video process')
+        parser.add_argument("-v", "--videoMode", action="store_true", help="Video process")
-        parser.add_argument('-s', '--preview', action='store_true', help='Preview image')
+        parser.add_argument("-s", "--preview", action="store_true", help="Preview image")
-        parser.add_argument('-b', '--preprocessing', action='store_true', help='Enable pre processing')
+        parser.add_argument("-b", "--preprocessing", action="store_true", help="Enable pre processing")
-        parser.add_argument('-a', '--postprocessing', action='store_true', help='Enable post processing')
+        parser.add_argument("-a", "--postprocessing", action="store_true", help="Enable post processing")
-        parser.add_argument('-r', '--preFilters', type=int, help='Enhancement filter, only working when preProcessing is true,there are 5 options by binary:Median blur=0000001, Mean blur=0000010, CAS Sharpening=0000100, Gaussian blur weak=0001000, Gaussian blur=0010000, Bilateral filter=0100000, Bilateral filter faster=1000000, you can freely combine them, eg: Gaussian blur weak + Bilateral filter = 0001000 | 0100000 = 0101000 = 40(D)')
+        parser.add_argument("-r", "--preFilters", type=int, help="Enhancement filter, only working when preProcessing is true,there are 5 options by binary:Median blur=0000001, Mean blur=0000010, CAS Sharpening=0000100, Gaussian blur weak=0001000, Gaussian blur=0010000, Bilateral filter=0100000, Bilateral filter faster=1000000, you can freely combine them, eg: Gaussian blur weak + Bilateral filter = 0001000 | 0100000 = 0101000 = 40(D)")
-        parser.add_argument('-e', '--postFilters', type=int, help='Enhancement filter, only working when postProcessing is true,there are 5 options by binary:Median blur=0000001, Mean blur=0000010, CAS Sharpening=0000100, Gaussian blur weak=0001000, Gaussian blur=0010000, Bilateral filter=0100000, Bilateral filter faster=1000000, you can freely combine them, eg: Gaussian blur weak + Bilateral filter = 0001000 | 0100000 = 0101000 = 40(D), so you can put 40 to enable Gaussian blur weak and Bilateral filter, which also is what I recommend for image that < 1080P, 48 for image that >= 1080P, and for performance I recommend to use 72 for video that < 1080P, 80 for video that >=1080P')
+        parser.add_argument("-e", "--postFilters", type=int, help="Enhancement filter, only working when postProcessing is true,there are 5 options by binary:Median blur=0000001, Mean blur=0000010, CAS Sharpening=0000100, Gaussian blur weak=0001000, Gaussian blur=0010000, Bilateral filter=0100000, Bilateral filter faster=1000000, you can freely combine them, eg: Gaussian blur weak + Bilateral filter = 0001000 | 0100000 = 0101000 = 40(D), so you can put 40 to enable Gaussian blur weak and Bilateral filter, which also is what I recommend for image that < 1080P, 48 for image that >= 1080P, and for performance I recommend to use 72 for video that < 1080P, 80 for video that >=1080P")
-        parser.add_argument('-q', '--GPUMode', action='store_true', help='Enable GPU acceleration')
+        parser.add_argument("-q", "--GPUMode", action="store_true", help="Enable GPU acceleration")
-        parser.add_argument('-l', '--listGPUs', action='store_true', help='list GPUs')
+        parser.add_argument("-w", "--CNNMode", action="store_true", help="Enable ACNet")
-        parser.add_argument('-h', '--platformID', type=int, help='Specify the platform ID')
+        parser.add_argument("-H", "--HDN", action="store_true", help="Enable HDN mode for ACNet")
-        parser.add_argument('-d', '--deviceID', type=int, help='Specify the device ID')
+        parser.add_argument("-L", "--HDNLevel", type=int, help="Set HDN level")
-        parser.add_argument('-C', '--codec', type=str, help='Specify the codec for encoding from mp4v(recommended in Windows), dxva(for Windows), avc1(H264, recommended in Linux), vp09(very slow), hevc(not support in Windowds), av01(not support in Windowds) (string [=mp4v])')
+        parser.add_argument("-l", "--listGPUs", action="store_true", help="list GPUs")
+        parser.add_argument("-h", "--platformID", type=int, help="Specify the platform ID")
+        parser.add_argument("-d", "--deviceID", type=int, help="Specify the device ID")
+        parser.add_argument("-C", "--codec", type=str, help="Specify the codec for encoding from mp4v(recommended in Windows), dxva(for Windows), avc1(H264, recommended in Linux), vp09(very slow), hevc(not support in Windowds), av01(not support in Windowds) (string [=mp4v])")
+        parser.add_argument("-F", "--forceFps", type=float, help="Set output video fps to the specifying number, 0 to disable")
+        parser.add_argument("-D", "--disableProgress", action="store_true", help="disable progress display")
+        parser.add_argument("-W", "--webVideo", type=str, help="process the video from URL")
+        parser.add_argument("-A", "--alpha", action="store_true", help="preserve the Alpha channel for transparent image")
         return parser.parse_args(arguments)
+        # fmt: on
 
     def load_configurations(self, upscaler):
-        self.driver_settings['zoomFactor'] = upscaler.scale_ratio
+        # self.driver_settings['zoomFactor'] = upscaler.scale_ratio
-        self.driver_settings['threads'] = upscaler.processes
+        self.driver_settings["threads"] = upscaler.processes
 
         # append FFmpeg path to the end of PATH
         # Anime4KCPP will then use FFmpeg to migrate audio tracks
-        os.environ['PATH'] += f';{upscaler.ffmpeg_settings["ffmpeg_path"]}'
+        os.environ["PATH"] += f';{upscaler.ffmpeg_settings["ffmpeg_path"]}'
+
+    def set_scale_ratio(self, scale_ratio: float):
+        self.driver_settings["zoomFactor"] = scale_ratio
 
     def upscale(self, input_file, output_file):
         """This is the core function for WAIFU2X class
@@ -83,31 +97,35 @@ class WrapperMain:
             height {int} -- output video height
         """
 
+        # change the working directory to the binary's parent directory
+        # so the binary can find shared object files and other files
+        os.chdir(pathlib.Path(self.driver_settings["path"]).parent)
+
         # overwrite config file settings
-        self.driver_settings['input'] = input_file
+        self.driver_settings["input"] = input_file
-        self.driver_settings['output'] = output_file
+        self.driver_settings["output"] = output_file
 
         # Anime4KCPP will look for Anime4KCPPKernel.cl under the current working directory
         # change the CWD to its containing directory so it will find it
-        if platform.system() == 'Windows':
+        if platform.system() == "Windows":
-            os.chdir(pathlib.Path(self.driver_settings['path']).parent)
+            os.chdir(pathlib.Path(self.driver_settings["path"]).parent)
 
         # list to be executed
         # initialize the list with waifu2x binary path as the first element
-        execute = [self.driver_settings['path']]
+        execute = [self.driver_settings["path"]]
 
         for key in self.driver_settings.keys():
 
             value = self.driver_settings[key]
 
             # null or None means that leave this option out (keep default)
-            if key == 'path' or value is None or value is False:
+            if key == "path" or value is None or value is False:
                 continue
             else:
                 if len(key) == 1:
-                    execute.append(f'-{key}')
+                    execute.append(f"-{key}")
                 else:
-                    execute.append(f'--{key}')
+                    execute.append(f"--{key}")
 
                 # true means key is an option
                 if value is not True:
@@ -115,6 +133,8 @@ class WrapperMain:
 
         # return the Popen object of the new process created
         self.print_lock.acquire()
-        Avalon.debug_info(f'[upscaler] Subprocess {os.getpid()} executing: {shlex.join(execute)}')
+        Avalon.debug_info(
+            f'[upscaler] Subprocess {os.getpid()} executing: {" ".join(execute)}'
+        )
         self.print_lock.release()
-        return subprocess.Popen(execute)
+        return subprocess.Popen(execute, stdout=sys.stdout, stderr=sys.stderr)

src/wrappers/ffmpeg.py

@@ -4,7 +4,7 @@
 Name: Video2X FFmpeg Controller
 Author: K4YT3X
 Date Created: Feb 24, 2018
-Last Modified: May 14, 2020
+Last Modified: September 13, 2020
 
 Description: This class handles all FFmpeg related operations.
 """
@@ -12,8 +12,8 @@ Description: This class handles all FFmpeg related operations.
 # built-in imports
 import json
 import pathlib
-import shlex
 import subprocess
+import sys
 
 # third-party imports
 from avalon_framework import Avalon
@@ -27,20 +27,24 @@ class Ffmpeg:
     and inserting audio tracks to videos.
     """
 
-    def __init__(self, ffmpeg_settings, image_format='png'):
+    def __init__(self, ffmpeg_settings, extracted_frame_format="png"):
         self.ffmpeg_settings = ffmpeg_settings
 
-        self.ffmpeg_path = pathlib.Path(self.ffmpeg_settings['ffmpeg_path'])
+        self.ffmpeg_path = pathlib.Path(self.ffmpeg_settings["ffmpeg_path"])
-        self.ffmpeg_binary = self.ffmpeg_path / 'ffmpeg'
+        self.ffmpeg_binary = self.ffmpeg_path / "ffmpeg"
-        self.ffmpeg_probe_binary = self.ffmpeg_path / 'ffprobe'
+        self.ffmpeg_probe_binary = self.ffmpeg_path / "ffprobe"
 
         # video metadata
-        self.image_format = image_format
+        self.extracted_frame_format = extracted_frame_format
-        self.intermediate_file_name = pathlib.Path(self.ffmpeg_settings['intermediate_file_name'])
+        self.intermediate_file_name = pathlib.Path(
-        self.pixel_format = self.ffmpeg_settings['extract_frames']['output_options']['-pix_fmt']
+            self.ffmpeg_settings["intermediate_file_name"]
+        )
+        self.pixel_format = self.ffmpeg_settings["extract_frames"]["output_options"][
+            "-pix_fmt"
+        ]
 
     def get_pixel_formats(self):
-        """ Get a dictionary of supported pixel formats
+        """Get a dictionary of supported pixel formats
 
         List all supported pixel formats and their
         corresponding bit depth.
@@ -48,25 +52,26 @@ class Ffmpeg:
         Returns:
             dictionary -- JSON dict of all pixel formats to bit depth
         """
-        execute = [
+        execute = [self.ffmpeg_probe_binary, "-v", "quiet", "-pix_fmts"]
-            self.ffmpeg_probe_binary,
-            '-v',
-            'quiet',
-            '-pix_fmts'
-        ]
 
         # turn elements into str
         execute = [str(e) for e in execute]
 
-        Avalon.debug_info(f'Executing: {shlex.join(execute)}')
+        Avalon.debug_info(f'Executing: {" ".join(execute)}')
 
         # initialize dictionary to store pixel formats
         pixel_formats = {}
 
         # record all pixel formats into dictionary
-        for line in subprocess.run(execute, check=True, stdout=subprocess.PIPE).stdout.decode().split('\n'):
+        for line in (
+            subprocess.run(execute, check=True, stdout=subprocess.PIPE)
+            .stdout.decode()
+            .split("\n")
+        ):
             try:
-                pixel_formats[' '.join(line.split()).split()[1]] = int(' '.join(line.split()).split()[3])
+                pixel_formats[" ".join(line.split()).split()[1]] = int(
+                    " ".join(line.split()).split()[3]
+                )
             except (IndexError, ValueError):
                 pass
 
@@ -75,8 +80,43 @@ class Ffmpeg:
 
         return pixel_formats
 
+    def get_number_of_frames(self, input_file: str, video_stream_index: int) -> int:
+        """Count the number of frames in a video
+
+        Args:
+            input_file (str): input file path
+            video_stream_index (int): index number of the video stream
+
+        Returns:
+            int: number of frames in the video
+        """
+
+        execute = [
+            self.ffmpeg_probe_binary,
+            "-v",
+            "quiet",
+            "-count_frames",
+            "-select_streams",
+            f"v:{video_stream_index}",
+            "-show_entries",
+            "stream=nb_read_frames",
+            "-of",
+            "default=nokey=1:noprint_wrappers=1",
+            input_file,
+        ]
+
+        # turn elements into str
+        execute = [str(e) for e in execute]
+
+        Avalon.debug_info(f'Executing: {" ".join(execute)}')
+        return int(
+            subprocess.run(execute, check=True, stdout=subprocess.PIPE)
+            .stdout.decode()
+            .strip()
+        )
+
     def probe_file_info(self, input_video):
-        """ Gets input video information
+        """Gets input video information
 
         This method reads input video information
         using ffprobe in dictionary
@@ -92,51 +132,53 @@ class Ffmpeg:
         # since video2x only strictly recignizes this one format
         execute = [
             self.ffmpeg_probe_binary,
-            '-v',
+            "-v",
-            'quiet',
+            "quiet",
-            '-print_format',
+            "-print_format",
-            'json',
+            "json",
-            '-show_format',
+            "-show_format",
-            '-show_streams',
+            "-show_streams",
-            '-i',
+            "-i",
-            input_video
+            input_video,
         ]
 
         # turn elements into str
         execute = [str(e) for e in execute]
 
-        Avalon.debug_info(f'Executing: {shlex.join(execute)}')
+        Avalon.debug_info(f'Executing: {" ".join(execute)}')
         json_str = subprocess.run(execute, check=True, stdout=subprocess.PIPE).stdout
-        return json.loads(json_str.decode('utf-8'))
+        return json.loads(json_str.decode("utf-8"))
 
     def extract_frames(self, input_file, extracted_frames):
-        """ extract frames from video or GIF file
+        """extract frames from video or GIF file"""
-        """
+        execute = [self.ffmpeg_binary]
-        execute = [
-            self.ffmpeg_binary
-        ]
 
         # load general options
-        execute.extend(self._read_configuration(phase='extract_frames'))
+        execute.extend(self._read_configuration(phase="extract_frames"))
 
         # load input_options
-        execute.extend(self._read_configuration(phase='extract_frames', section='input_options'))
+        execute.extend(
+            self._read_configuration(phase="extract_frames", section="input_options")
+        )
 
         # specify input file
-        execute.extend([
+        execute.extend(["-i", input_file])
-            '-i',
-            input_file
-        ])
 
         # load output options
-        execute.extend(self._read_configuration(phase='extract_frames', section='output_options'))
+        execute.extend(
+            self._read_configuration(phase="extract_frames", section="output_options")
+        )
 
         # specify output file
-        execute.extend([
+        execute.extend(
-            extracted_frames / f'extracted_%0d.{self.image_format}'
+            [
-        ])
+                extracted_frames
+                / f"extracted_%0d.{self.extracted_frame_format}"
+                # extracted_frames / f'frame_%06d.{self.extracted_frame_format}'
+            ]
+        )
 
-        return(self._execute(execute))
+        return self._execute(execute)
 
     def assemble_video(self, framerate, upscaled_frames):
         """Converts images into videos
@@ -150,85 +192,93 @@ class Ffmpeg:
         """
         execute = [
             self.ffmpeg_binary,
-            '-r',
+            "-r",
             str(framerate)
             # '-s',
             # resolution
         ]
 
         # read other options
-        execute.extend(self._read_configuration(phase='assemble_video'))
+        execute.extend(self._read_configuration(phase="assemble_video"))
 
         # read input options
-        execute.extend(self._read_configuration(phase='assemble_video', section='input_options'))
+        execute.extend(
+            self._read_configuration(phase="assemble_video", section="input_options")
+        )
 
         # WORKAROUND FOR WAIFU2X-NCNN-VULKAN
         # Dev: SAT3LL
         # rename all .png.png suffixes to .png
         import re
-        regex = re.compile(r'\.png\.png$', re.IGNORECASE)
+
+        regex = re.compile(r"\.png\.png$", re.IGNORECASE)
         for frame_name in upscaled_frames.iterdir():
-            (upscaled_frames / frame_name).rename(upscaled_frames / regex.sub('.png', str(frame_name)))
+            (upscaled_frames / frame_name).rename(
+                upscaled_frames / regex.sub(".png", str(frame_name))
+            )
         # END WORKAROUND
 
         # append input frames path into command
-        execute.extend([
+        execute.extend(
-            '-i',
+            [
-            upscaled_frames / f'extracted_%d.{self.image_format}'
+                "-i",
-        ])
+                upscaled_frames / f"extracted_%d.{self.extracted_frame_format}"
+                # upscaled_frames / f'%06d.{self.extracted_frame_format}'
+            ]
+        )
 
         # read FFmpeg output options
-        execute.extend(self._read_configuration(phase='assemble_video', section='output_options'))
+        execute.extend(
+            self._read_configuration(phase="assemble_video", section="output_options")
+        )
 
         # specify output file location
-        execute.extend([
+        execute.extend([upscaled_frames / self.intermediate_file_name])
-            upscaled_frames / self.intermediate_file_name
-        ])
 
-        return(self._execute(execute))
+        return self._execute(execute)
 
     def migrate_streams(self, input_video, output_video, upscaled_frames):
-        """ Migrates audio tracks and subtitles from input video to output video
+        """Migrates audio tracks and subtitles from input video to output video
 
         Arguments:
             input_video {string} -- input video file path
             output_video {string} -- output video file path
             upscaled_frames {string} -- directory containing upscaled frames
         """
-        execute = [
+        execute = [self.ffmpeg_binary]
-            self.ffmpeg_binary
-        ]
 
         # load general options
-        execute.extend(self._read_configuration(phase='migrate_streams'))
+        execute.extend(self._read_configuration(phase="migrate_streams"))
 
         # load input options
-        execute.extend(self._read_configuration(phase='migrate_streams', section='input_options'))
+        execute.extend(
+            self._read_configuration(phase="migrate_streams", section="input_options")
+        )
 
         # load input file names
-        execute.extend([
+        execute.extend(
-
+            [
-            # input 1: upscaled intermediate file without sound
+                # input 1: upscaled intermediate file without sound
-            '-i',
+                "-i",
-            upscaled_frames / self.intermediate_file_name,
+                upscaled_frames / self.intermediate_file_name,
-
+                # input 2: original video with streams to copy over
-            # input 2: original video with streams to copy over
+                "-i",
-            '-i',
+                input_video,
-            input_video
+            ]
-        ])
+        )
 
         # load output options
-        execute.extend(self._read_configuration(phase='migrate_streams', section='output_options'))
+        execute.extend(
+            self._read_configuration(phase="migrate_streams", section="output_options")
+        )
 
         # load output video path
-        execute.extend([
+        execute.extend([output_video])
-            output_video
-        ])
 
-        return(self._execute(execute))
+        return self._execute(execute)
 
     def _read_configuration(self, phase, section=None):
-        """ read configuration from JSON
+        """read configuration from JSON
 
         Read the configurations (arguments) from the JSON
         configuration file and append them to the end of the
@@ -257,7 +307,12 @@ class Ffmpeg:
                 value = self.ffmpeg_settings[phase][key]
 
             # null or None means that leave this option out (keep default)
-            if value is None or value is False or isinstance(value, dict) or value == '':
+            if (
+                value is None
+                or value is False
+                or isinstance(value, dict)
+                or value == ""
+            ):
                 continue
 
             # if the value is a list, append the same argument and all values
@@ -283,5 +338,5 @@ class Ffmpeg:
     def _execute(self, execute):
         # turn all list elements into string to avoid errors
         execute = [str(e) for e in execute]
-        Avalon.debug_info(f'Executing: {shlex.join(execute)}')
+        Avalon.debug_info(f'Executing: {" ".join(execute)}')
-        return subprocess.Popen(execute)
+        return subprocess.Popen(execute, stdout=sys.stdout, stderr=sys.stderr)

src/wrappers/gifski.py

@@ -4,7 +4,7 @@
 Name: Gifski Wrapper
 Creator: K4YT3X
 Date Created: May 11, 2020
-Last Modified: May 11, 2020
+Last Modified: September 13, 2020
 
 Description: High-level wrapper for Gifski.
 """
@@ -12,32 +12,44 @@ Description: High-level wrapper for Gifski.
 # built-in imports
 import pathlib
 import subprocess
+import sys
 
 # third-party imports
 from avalon_framework import Avalon
 
 
 class Gifski:
-
     def __init__(self, gifski_settings):
         self.gifski_settings = gifski_settings
 
-    def make_gif(self, upscaled_frames: pathlib.Path, output_path: pathlib.Path, framerate: float, image_format: str) -> subprocess.Popen:
+    def make_gif(
+        self,
+        upscaled_frames: pathlib.Path,
+        output_path: pathlib.Path,
+        framerate: float,
+        extracted_frame_format: str,
+        output_width: int,
+        output_height: int,
+    ) -> subprocess.Popen:
         execute = [
-            self.gifski_settings['gifski_path'],
+            self.gifski_settings["gifski_path"],
-            '-o',
+            "-o",
             output_path,
-            '--fps',
+            "--fps",
-            int(round(framerate, 0))
+            int(round(framerate, 0)),
+            "--width",
+            output_width,
+            "--height",
+            output_height,
         ]
 
         # load configurations from config file
         execute.extend(self._load_configuration())
 
         # append frames location
-        execute.extend([upscaled_frames / f'extracted_*.{image_format}'])
+        execute.extend([upscaled_frames / f"extracted_*.{extracted_frame_format}"])
 
-        return(self._execute(execute))
+        return self._execute(execute)
 
     def _load_configuration(self):
 
@@ -48,13 +60,13 @@ class Gifski:
             value = self.gifski_settings[key]
 
             # null or None means that leave this option out (keep default)
-            if key == 'gifski_path' or value is None or value is False:
+            if key == "gifski_path" or value is None or value is False:
                 continue
             else:
                 if len(key) == 1:
-                    configuration.append(f'-{key}')
+                    configuration.append(f"-{key}")
                 else:
-                    configuration.append(f'--{key}')
+                    configuration.append(f"--{key}")
 
                 # true means key is an option
                 if value is not True:
@@ -65,6 +77,6 @@ class Gifski:
         # turn all list elements into string to avoid errors
         execute = [str(e) for e in execute]
 
-        Avalon.debug_info(f'Executing: {execute}')
+        Avalon.debug_info(f"Executing: {execute}")
 
-        return subprocess.Popen(execute)
+        return subprocess.Popen(execute, stdout=sys.stdout, stderr=sys.stderr)

src/wrappers/realsr_ncnn_vulkan.py

@@ -4,7 +4,7 @@
 Name: RealSR NCNN Vulkan Driver
 Creator: K4YT3X
 Date Created: May 26, 2020
-Last Modified: May 26, 2020
+Last Modified: September 21, 2020
 
 Description: This class is a high-level wrapper
 for realsr_ncnn_vulkan.
@@ -15,8 +15,8 @@ import argparse
 import os
 import pathlib
 import platform
-import shlex
 import subprocess
+import sys
 import threading
 
 # third-party imports
@@ -38,23 +38,32 @@ class WrapperMain:
 
     @staticmethod
     def parse_arguments(arguments):
+        # fmt: off
         parser = argparse.ArgumentParser(formatter_class=argparse.ArgumentDefaultsHelpFormatter, add_help=False)
         parser.error = lambda message: (_ for _ in ()).throw(AttributeError(message))
-        parser.add_argument('--help', action='help', help='show this help message and exit')
+        parser.add_argument("--help", action="help", help="show this help message and exit")
-        parser.add_argument('-v', action='store_true', help='verbose output')
+        parser.add_argument("-v", action="store_true", help="verbose output")
-        parser.add_argument('-i', type=str, help=argparse.SUPPRESS)  # help='input image path (jpg/png) or directory')
+        parser.add_argument("-i", type=str, help=argparse.SUPPRESS)  # help="input image path (jpg/png) or directory")
-        parser.add_argument('-o', type=str, help=argparse.SUPPRESS)  # help='output image path (png) or directory')
+        parser.add_argument("-o", type=str, help=argparse.SUPPRESS)  # help="output image path (png) or directory")
-        parser.add_argument('-s', type=int, choices=[4], help='upscale ratio')
+        parser.add_argument("-s", type=int, help="upscale ratio")
-        parser.add_argument('-t', type=int, help='tile size (>=32/0=auto)')
+        parser.add_argument("-t", type=int, help="tile size (>=32/0=auto)")
-        parser.add_argument('-m', type=str, help='realsr model path')
+        parser.add_argument("-m", type=str, help="realsr model path")
-        parser.add_argument('-g', type=int, help='gpu device to use')
+        parser.add_argument("-g", type=int, help="gpu device to use")
-        parser.add_argument('-j', type=str, help='thread count for load/proc/save')
+        parser.add_argument("-j", type=str, help="thread count for load/proc/save")
-        parser.add_argument('-x', action='store_true', help='enable tta mode')
+        parser.add_argument("-x", action="store_true", help="enable tta mode")
+        parser.add_argument("-f", type=str, help=argparse.SUPPRESS)  # help="output image format (jpg/png/webp, default=ext/png)")
         return parser.parse_args(arguments)
+        # fmt: on
 
     def load_configurations(self, upscaler):
-        self.driver_settings['s'] = int(upscaler.scale_ratio)
+        # self.driver_settings['s'] = int(upscaler.scale_ratio)
-        self.driver_settings['j'] = '{}:{}:{}'.format(upscaler.processes, upscaler.processes, upscaler.processes)
+        self.driver_settings["j"] = "{}:{}:{}".format(
+            upscaler.processes, upscaler.processes, upscaler.processes
+        )
+        self.driver_settings["f"] = upscaler.extracted_frame_format.lower()
+
+    def set_scale_ratio(self, scale_ratio: int):
+        self.driver_settings["s"] = int(scale_ratio)
 
     def upscale(self, input_directory, output_directory):
         """This is the core function for RealSR NCNN Vulkan class
@@ -65,31 +74,35 @@ class WrapperMain:
             ratio {int} -- output video ratio
         """
 
+        # change the working directory to the binary's parent directory
+        # so the binary can find shared object files and other files
+        os.chdir(pathlib.Path(self.driver_settings["path"]).parent)
+
         # overwrite config file settings
-        self.driver_settings['i'] = input_directory
+        self.driver_settings["i"] = input_directory
-        self.driver_settings['o'] = output_directory
+        self.driver_settings["o"] = output_directory
 
         # by default, realsr-ncnn-vulkan will look for the models under the current working directory
         # change the working directory to its containing folder if model directory not specified
-        if self.driver_settings['m'] is None and platform.system() == 'Windows':
+        if self.driver_settings["m"] is None and platform.system() == "Windows":
-            os.chdir(pathlib.Path(self.driver_settings['path']).parent)
+            os.chdir(pathlib.Path(self.driver_settings["path"]).parent)
 
         # list to be executed
         # initialize the list with the binary path as the first element
-        execute = [self.driver_settings['path']]
+        execute = [self.driver_settings["path"]]
 
         for key in self.driver_settings.keys():
 
             value = self.driver_settings[key]
 
             # null or None means that leave this option out (keep default)
-            if key == 'path' or value is None or value is False:
+            if key == "path" or value is None or value is False:
                 continue
             else:
                 if len(key) == 1:
-                    execute.append(f'-{key}')
+                    execute.append(f"-{key}")
                 else:
-                    execute.append(f'--{key}')
+                    execute.append(f"--{key}")
 
                 # true means key is an option
                 if value is not True:
@@ -97,6 +110,8 @@ class WrapperMain:
 
         # return the Popen object of the new process created
         self.print_lock.acquire()
-        Avalon.debug_info(f'[upscaler] Subprocess {os.getpid()} executing: {shlex.join(execute)}')
+        Avalon.debug_info(
+            f'[upscaler] Subprocess {os.getpid()} executing: {" ".join(execute)}'
+        )
         self.print_lock.release()
-        return subprocess.Popen(execute)
+        return subprocess.Popen(execute, stdout=sys.stdout, stderr=sys.stderr)

src/wrappers/srmd_ncnn_vulkan.py

@@ -4,7 +4,7 @@
 Name: SRMD NCNN Vulkan Driver
 Creator: K4YT3X
 Date Created: April 26, 2020
-Last Modified: May 11, 2020
+Last Modified: September 21, 2020
 
 Description: This class is a high-level wrapper
 for srmd_ncnn_vulkan.
@@ -15,8 +15,8 @@ import argparse
 import os
 import pathlib
 import platform
-import shlex
 import subprocess
+import sys
 import threading
 
 # third-party imports
@@ -38,24 +38,33 @@ class WrapperMain:
 
     @staticmethod
     def parse_arguments(arguments):
+        # fmt: off
         parser = argparse.ArgumentParser(formatter_class=argparse.ArgumentDefaultsHelpFormatter, add_help=False)
         parser.error = lambda message: (_ for _ in ()).throw(AttributeError(message))
-        parser.add_argument('--help', action='help', help='show this help message and exit')
+        parser.add_argument("--help", action="help", help="show this help message and exit")
-        parser.add_argument('-v', action='store_true', help='verbose output')
+        parser.add_argument("-v", action="store_true", help="verbose output")
-        parser.add_argument('-i', type=str, help=argparse.SUPPRESS)  # help='input image path (jpg/png) or directory')
+        parser.add_argument("-i", type=str, help=argparse.SUPPRESS)  # help="input image path (jpg/png) or directory")
-        parser.add_argument('-o', type=str, help=argparse.SUPPRESS)  # help='output image path (png) or directory')
+        parser.add_argument("-o", type=str, help=argparse.SUPPRESS)  # help="output image path (png) or directory")
-        parser.add_argument('-n', type=int, choices=range(-1, 11), help='denoise level')
+        parser.add_argument("-n", type=int, choices=range(-1, 11), help="denoise level")
-        parser.add_argument('-s', type=int, choices=range(2, 5), help='upscale ratio')
+        parser.add_argument("-s", type=int, help="upscale ratio")
-        parser.add_argument('-t', type=int, help='tile size (>=32)')
+        parser.add_argument("-t", type=int, help="tile size (>=32)")
-        parser.add_argument('-m', type=str, help='srmd model path')
+        parser.add_argument("-m", type=str, help="srmd model path")
-        parser.add_argument('-g', type=int, help='gpu device to use')
+        parser.add_argument("-g", type=int, help="gpu device to use")
-        parser.add_argument('-j', type=str, help='thread count for load/proc/save')
+        parser.add_argument("-j", type=str, help="thread count for load/proc/save")
-        parser.add_argument('-x', action='store_true', help='enable tta mode')
+        parser.add_argument("-x", action="store_true", help="enable tta mode")
+        parser.add_argument("-f", type=str, help=argparse.SUPPRESS)  # help="output image format (jpg/png/webp, default=ext/png)")
         return parser.parse_args(arguments)
+        # fmt: on
 
     def load_configurations(self, upscaler):
-        self.driver_settings['s'] = int(upscaler.scale_ratio)
+        # self.driver_settings['s'] = int(upscaler.scale_ratio)
-        self.driver_settings['j'] = '{}:{}:{}'.format(upscaler.processes, upscaler.processes, upscaler.processes)
+        self.driver_settings["j"] = "{}:{}:{}".format(
+            upscaler.processes, upscaler.processes, upscaler.processes
+        )
+        self.driver_settings["f"] = upscaler.extracted_frame_format.lower()
+
+    def set_scale_ratio(self, scale_ratio: int):
+        self.driver_settings["s"] = int(scale_ratio)
 
     def upscale(self, input_directory, output_directory):
         """This is the core function for SRMD ncnn Vulkan class
@@ -66,31 +75,35 @@ class WrapperMain:
             ratio {int} -- output video ratio
         """
 
+        # change the working directory to the binary's parent directory
+        # so the binary can find shared object files and other files
+        os.chdir(pathlib.Path(self.driver_settings["path"]).parent)
+
         # overwrite config file settings
-        self.driver_settings['i'] = input_directory
+        self.driver_settings["i"] = input_directory
-        self.driver_settings['o'] = output_directory
+        self.driver_settings["o"] = output_directory
 
         # by default, srmd-ncnn-vulkan will look for the models under the current working directory
         # change the working directory to its containing folder if model directory not specified
-        if self.driver_settings['m'] is None and platform.system() == 'Windows':
+        if self.driver_settings["m"] is None and platform.system() == "Windows":
-            os.chdir(pathlib.Path(self.driver_settings['path']).parent)
+            os.chdir(pathlib.Path(self.driver_settings["path"]).parent)
 
         # list to be executed
         # initialize the list with the binary path as the first element
-        execute = [self.driver_settings['path']]
+        execute = [self.driver_settings["path"]]
 
         for key in self.driver_settings.keys():
 
             value = self.driver_settings[key]
 
             # null or None means that leave this option out (keep default)
-            if key == 'path' or value is None or value is False:
+            if key == "path" or value is None or value is False:
                 continue
             else:
                 if len(key) == 1:
-                    execute.append(f'-{key}')
+                    execute.append(f"-{key}")
                 else:
-                    execute.append(f'--{key}')
+                    execute.append(f"--{key}")
 
                 # true means key is an option
                 if value is not True:
@@ -98,6 +111,8 @@ class WrapperMain:
 
         # return the Popen object of the new process created
         self.print_lock.acquire()
-        Avalon.debug_info(f'[upscaler] Subprocess {os.getpid()} executing: {shlex.join(execute)}')
+        Avalon.debug_info(
+            f'[upscaler] Subprocess {os.getpid()} executing: {" ".join(execute)}'
+        )
         self.print_lock.release()
-        return subprocess.Popen(execute)
+        return subprocess.Popen(execute, stdout=sys.stdout, stderr=sys.stderr)

src/wrappers/waifu2x_caffe.py

@@ -4,7 +4,7 @@
 Name: Waifu2x Caffe Driver
 Author: K4YT3X
 Date Created: Feb 24, 2018
-Last Modified: May 11, 2020
+Last Modified: September 12, 2020
 
 Description: This class is a high-level wrapper
 for waifu2x-caffe.
@@ -13,8 +13,9 @@ for waifu2x-caffe.
 # built-in imports
 import argparse
 import os
-import shlex
+import pathlib
 import subprocess
+import sys
 import threading
 
 # third-party imports
@@ -36,63 +37,78 @@ class WrapperMain:
 
     @staticmethod
     def parse_arguments(arguments):
+        # fmt: off
         parser = argparse.ArgumentParser(formatter_class=argparse.ArgumentDefaultsHelpFormatter, add_help=False)
         parser.error = lambda message: (_ for _ in ()).throw(AttributeError(message))
-        parser.add_argument('--help', action='help', help='show this help message and exit')
+        parser.add_argument("--help", action="help", help="show this help message and exit")
-        parser.add_argument('-t', '--tta', type=int, choices=range(2), help='8x slower and slightly high quality')
+        parser.add_argument("-t", "--tta", type=int, choices=range(2), help="8x slower and slightly high quality")
-        parser.add_argument('--gpu', type=int, help='gpu device no')
+        parser.add_argument("--gpu", type=int, help="gpu device no")
-        parser.add_argument('-b', '--batch_size', type=int, help='input batch size')
+        parser.add_argument("-b", "--batch_size", type=int, help="input batch size")
-        parser.add_argument('--crop_h', type=int, help='input image split size(height)')
+        parser.add_argument("--crop_h", type=int, help="input image split size(height)")
-        parser.add_argument('--crop_w', type=int, help='input image split size(width)')
+        parser.add_argument("--crop_w", type=int, help="input image split size(width)")
-        parser.add_argument('-c', '--crop_size', type=int, help='input image split size')
+        parser.add_argument("-c", "--crop_size", type=int, help="input image split size")
-        parser.add_argument('-d', '--output_depth', type=int, help='output image chaneel depth bit')
+        parser.add_argument("-d", "--output_depth", type=int, help="output image chaneel depth bit")
-        parser.add_argument('-q', '--output_quality', type=int, help='output image quality')
+        parser.add_argument("-q", "--output_quality", type=int, help="output image quality")
-        parser.add_argument('-p', '--process', choices=['cpu', 'gpu', 'cudnn'], help='process mode')
+        parser.add_argument("-p", "--process", choices=["cpu", "gpu", "cudnn"], help="process mode")
-        parser.add_argument('--model_dir', type=str, help='path to custom model directory (don\'t append last / )')
+        parser.add_argument("--model_dir", type=str, help="path to custom model directory (don\"t append last / )")
-        parser.add_argument('-h', '--scale_height', type=int, help='custom scale height')
+        parser.add_argument("-h", "--scale_height", type=int, help="custom scale height")
-        parser.add_argument('-w', '--scale_width', type=int, help='custom scale width')
+        parser.add_argument("-w", "--scale_width", type=int, help="custom scale width")
-        parser.add_argument('-s', '--scale_ratio', type=float, help='custom scale ratio')
+        parser.add_argument("-s", "--scale_ratio", type=float, help="custom scale ratio")
-        parser.add_argument('-n', '--noise_level', type=int, choices=range(4), help='noise reduction level')
+        parser.add_argument("-n", "--noise_level", type=int, choices=range(4), help="noise reduction level")
-        parser.add_argument('-m', '--mode', choices=['noise', 'scale', 'noise_scale', 'auto_scale'], help='image processing mode')
+        parser.add_argument("-m", "--mode", choices=["noise", "scale", "noise_scale", "auto_scale"], help="image processing mode")
-        parser.add_argument('-e', '--output_extention', type=str, help='extention to output image file when output_path is (auto) or input_path is folder')
+        parser.add_argument("-e", "--output_extention", type=str, help="extention to output image file when output_path is (auto) or input_path is folder")
-        parser.add_argument('-l', '--input_extention_list', type=str, help='extention to input image file when input_path is folder')
+        parser.add_argument("-l", "--input_extention_list", type=str, help="extention to input image file when input_path is folder")
-        parser.add_argument('-o', '--output_path', type=str, help=argparse.SUPPRESS)  # help='path to output image file (when input_path is folder, output_path must be folder)')
+        parser.add_argument("-o", "--output_path", type=str, help=argparse.SUPPRESS)  # help="path to output image file (when input_path is folder, output_path must be folder)")
-        parser.add_argument('-i', '--input_path', type=str, help=argparse.SUPPRESS)  # help='(required) path to input image file')
+        parser.add_argument("-i", "--input_path", type=str, help=argparse.SUPPRESS)  # help="(required) path to input image file")
         return parser.parse_args(arguments)
+        # fmt: on
 
     def load_configurations(self, upscaler):
         # use scale width and scale height if specified
-        self.driver_settings['scale_ratio'] = upscaler.scale_ratio
+        # self.driver_settings['scale_ratio'] = upscaler.scale_ratio
-        self.driver_settings['output_extention'] = upscaler.image_format
+        self.driver_settings["output_extention"] = upscaler.extracted_frame_format
 
         # bit_depth will be 12 at this point
         # it will up updated later
-        self.driver_settings['output_depth'] = 12
+        self.driver_settings["output_depth"] = 12
+
+    def set_scale_resolution(self, width: int, height: int):
+        self.driver_settings["scale_width"] = width
+        self.driver_settings["scale_height"] = height
+        self.driver_settings["scale_ratio"] = None
+
+    def set_scale_ratio(self, scale_ratio: float):
+        self.driver_settings["scale_width"] = None
+        self.driver_settings["scale_height"] = None
+        self.driver_settings["scale_ratio"] = scale_ratio
 
     def upscale(self, input_directory, output_directory):
-        """ start upscaling process
+        """start upscaling process"""
-        """
+
+        # change the working directory to the binary's parent directory
+        # so the binary can find shared object files and other files
+        os.chdir(pathlib.Path(self.driver_settings["path"]).parent)
 
         # overwrite config file settings
-        self.driver_settings['input_path'] = input_directory
+        self.driver_settings["input_path"] = input_directory
-        self.driver_settings['output_path'] = output_directory
+        self.driver_settings["output_path"] = output_directory
 
         # list to be executed
         # initialize the list with waifu2x binary path as the first element
-        execute = [self.driver_settings['path']]
+        execute = [self.driver_settings["path"]]
 
         for key in self.driver_settings.keys():
 
             value = self.driver_settings[key]
 
             # null or None means that leave this option out (keep default)
-            if key == 'path' or value is None or value is False:
+            if key == "path" or value is None or value is False:
                 continue
             else:
                 if len(key) == 1:
-                    execute.append(f'-{key}')
+                    execute.append(f"-{key}")
                 else:
-                    execute.append(f'--{key}')
+                    execute.append(f"--{key}")
 
                 # true means key is an option
                 if value is not True:
@@ -100,6 +116,8 @@ class WrapperMain:
 
         # return the Popen object of the new process created
         self.print_lock.acquire()
-        Avalon.debug_info(f'[upscaler] Subprocess {os.getpid()} executing: {shlex.join(execute)}')
+        Avalon.debug_info(
+            f'[upscaler] Subprocess {os.getpid()} executing: {" ".join(execute)}'
+        )
         self.print_lock.release()
-        return subprocess.Popen(execute)
+        return subprocess.Popen(execute, stdout=sys.stdout, stderr=sys.stderr)

src/wrappers/waifu2x_converter_cpp.py

@@ -4,7 +4,7 @@
 Name: Waifu2x Converter CPP Driver
 Author: K4YT3X
 Date Created: February 8, 2019
-Last Modified: May 11, 2020
+Last Modified: September 9, 2020
 
 Description: This class is a high-level wrapper
 for waifu2x-converter-cpp.
@@ -14,8 +14,8 @@ for waifu2x-converter-cpp.
 import argparse
 import os
 import pathlib
-import shlex
 import subprocess
+import sys
 import threading
 
 # third-party imports
@@ -37,42 +37,47 @@ class WrapperMain:
 
     @staticmethod
     def parse_arguments(arguments):
+        # fmt: off
         parser = argparse.ArgumentParser(formatter_class=argparse.ArgumentDefaultsHelpFormatter, add_help=False)
         parser.error = lambda message: (_ for _ in ()).throw(AttributeError(message))
-        parser.add_argument('--help', action='help', help='show this help message and exit')
+        parser.add_argument("--help", action="help", help="show this help message and exit")
-        parser.add_argument('--list-supported-formats', action='store_true', help='dump currently supported format list')
+        parser.add_argument("--list-supported-formats", action="store_true", help="dump currently supported format list")
-        parser.add_argument('--list-opencv-formats', action='store_true', help='(deprecated. Use --list-supported-formats) dump opencv supported format list')
+        parser.add_argument("--list-opencv-formats", action="store_true", help="(deprecated. Use --list-supported-formats) dump opencv supported format list")
-        parser.add_argument('-l', '--list-processor', action='store_true', help='dump processor list')
+        parser.add_argument("-l", "--list-processor", action="store_true", help="dump processor list")
-        parser.add_argument('-f', '--output-format', choices=['png', 'jpg'], help='The format used when running in recursive/folder mode\nSee --list-supported-formats for a list of supported formats/extensions.')
+        parser.add_argument("-f", "--output-format", choices=["png", "jpg"], help="The format used when running in recursive/folder mode\nSee --list-supported-formats for a list of supported formats/extensions.")
-        parser.add_argument('-c', '--png-compression', type=int, choices=range(10), help='Set PNG compression level (0-9), 9 = Max compression (slowest & smallest)')
+        parser.add_argument("-c", "--png-compression", type=int, choices=range(10), help="Set PNG compression level (0-9), 9 = Max compression (slowest & smallest)")
-        parser.add_argument('-q', '--image-quality', type=int, choices=range(-1, 102), help='JPEG & WebP Compression quality (0-101, 0 being smallest size and lowest quality), use 101 for lossless WebP')
+        parser.add_argument("-q", "--image-quality", type=int, choices=range(-1, 102), help="JPEG & WebP Compression quality (0-101, 0 being smallest size and lowest quality), use 101 for lossless WebP")
-        parser.add_argument('--block-size', type=int, help='block size')
+        parser.add_argument("--block-size", type=int, help="block size")
-        parser.add_argument('--disable-gpu', action='store_true', help='disable GPU')
+        parser.add_argument("--disable-gpu", action="store_true", help="disable GPU")
-        parser.add_argument('--force-OpenCL', action='store_true', help='force to use OpenCL on Intel Platform')
+        parser.add_argument("--force-OpenCL", action="store_true", help="force to use OpenCL on Intel Platform")
-        parser.add_argument('-p', '--processor', type=int, help='set target processor')
+        parser.add_argument("-p", "--processor", type=int, help="set target processor")
-        parser.add_argument('-j', '--jobs', type=int, help='number of threads launching at the same time')
+        parser.add_argument("-j", "--jobs", type=int, help="number of threads launching at the same time")
-        parser.add_argument('--model-dir', type=str, help='path to custom model directory (don\'t append last / )')
+        parser.add_argument("--model-dir", type=str, help="path to custom model directory (don\"t append last / )")
-        parser.add_argument('--scale-ratio', type=float, help='custom scale ratio')
+        parser.add_argument("--scale-ratio", type=float, help="custom scale ratio")
-        parser.add_argument('--noise-level', type=int, choices=range(4), help='noise reduction level')
+        parser.add_argument("--noise-level", type=int, choices=range(4), help="noise reduction level")
-        parser.add_argument('-m', '--mode', choices=['noise', 'scale', 'noise-scale'], help='image processing mode')
+        parser.add_argument("-m", "--mode", choices=["noise", "scale", "noise-scale"], help="image processing mode")
-        parser.add_argument('-v', '--log-level', type=int, choices=range(5), help='Set log level')
+        parser.add_argument("-v", "--log-level", type=int, choices=range(5), help="Set log level")
-        parser.add_argument('-s', '--silent', action='store_true', help='Enable silent mode. (same as --log-level 1)')
+        parser.add_argument("-s", "--silent", action="store_true", help="Enable silent mode. (same as --log-level 1)")
-        parser.add_argument('-t', '--tta', type=int, choices=range(2), help='Enable Test-Time Augmentation mode.')
+        parser.add_argument("-t", "--tta", type=int, choices=range(2), help="Enable Test-Time Augmentation mode.")
-        parser.add_argument('-g', '--generate-subdir', type=int, choices=range(2), help='Generate sub folder when recursive directory is enabled.')
+        parser.add_argument("-g", "--generate-subdir", type=int, choices=range(2), help="Generate sub folder when recursive directory is enabled.")
-        parser.add_argument('-a', '--auto-naming', type=int, choices=range(2), help='Add postfix to output name when output path is not specified.\nSet 0 to disable this.')
+        parser.add_argument("-a", "--auto-naming", type=int, choices=range(2), help="Add postfix to output name when output path is not specified.\nSet 0 to disable this.")
-        parser.add_argument('-r', '--recursive-directory', type=int, choices=range(2), help='Search recursively through directories to find more images to process.')
+        parser.add_argument("-r", "--recursive-directory", type=int, choices=range(2), help="Search recursively through directories to find more images to process.")
-        parser.add_argument('-o', '--output', type=str, help=argparse.SUPPRESS)  # help='path to output image file or directory  (you should use the full path)')
+        parser.add_argument("-o", "--output", type=str, help=argparse.SUPPRESS)  # help="path to output image file or directory  (you should use the full path)")
-        parser.add_argument('-i', '--input', type=str, help=argparse.SUPPRESS)  # help='(required)  path to input image file or directory (you should use the full path)')
+        parser.add_argument("-i", "--input", type=str, help=argparse.SUPPRESS)  # help="(required)  path to input image file or directory (you should use the full path)")
-        parser.add_argument('--version', action='store_true', help='Displays version information and exits.')
+        parser.add_argument("--version", action="store_true", help="Displays version information and exits.")
         return parser.parse_args(arguments)
+        # fmt: on
 
     def load_configurations(self, upscaler):
-        self.driver_settings['scale-ratio'] = upscaler.scale_ratio
+        # self.driver_settings['scale-ratio'] = upscaler.scale_ratio
-        self.driver_settings['jobs'] = upscaler.processes
+        self.driver_settings["jobs"] = upscaler.processes
-        self.driver_settings['output-format'] = upscaler.image_format.lower()
+        self.driver_settings["output-format"] = upscaler.extracted_frame_format.lower()
+
+    def set_scale_ratio(self, scale_ratio: float):
+        self.driver_settings["scale-ratio"] = scale_ratio
 
     def upscale(self, input_directory, output_directory):
-        """ Waifu2x Converter Driver Upscaler
+        """Waifu2x Converter Driver Upscaler
         This method executes the upscaling of extracted frames.
 
         Arguments:
@@ -82,31 +87,37 @@ class WrapperMain:
             threads {int} -- number of threads
         """
 
+        # change the working directory to the binary's parent directory
+        # so the binary can find shared object files and other files
+        os.chdir(pathlib.Path(self.driver_settings["path"]).parent)
+
         # overwrite config file settings
-        self.driver_settings['input'] = input_directory
+        self.driver_settings["input"] = input_directory
-        self.driver_settings['output'] = output_directory
+        self.driver_settings["output"] = output_directory
 
         # models_rgb must be specified manually for waifu2x-converter-cpp
         # if it's not specified in the arguments, create automatically
-        if self.driver_settings['model-dir'] is None:
+        if self.driver_settings["model-dir"] is None:
-            self.driver_settings['model-dir'] = pathlib.Path(self.driver_settings['path']).parent / 'models_rgb'
+            self.driver_settings["model-dir"] = (
+                pathlib.Path(self.driver_settings["path"]).parent / "models_rgb"
+            )
 
         # list to be executed
         # initialize the list with waifu2x binary path as the first element
-        execute = [self.driver_settings['path']]
+        execute = [self.driver_settings["path"]]
 
         for key in self.driver_settings.keys():
 
             value = self.driver_settings[key]
 
             # null or None means that leave this option out (keep default)
-            if key == 'path' or value is None or value is False:
+            if key == "path" or value is None or value is False:
                 continue
             else:
                 if len(key) == 1:
-                    execute.append(f'-{key}')
+                    execute.append(f"-{key}")
                 else:
-                    execute.append(f'--{key}')
+                    execute.append(f"--{key}")
 
                 # true means key is an option
                 if value is not True:
@@ -114,6 +125,8 @@ class WrapperMain:
 
         # return the Popen object of the new process created
         self.print_lock.acquire()
-        Avalon.debug_info(f'[upscaler] Subprocess {os.getpid()} executing: {shlex.join(execute)}')
+        Avalon.debug_info(
+            f'[upscaler] Subprocess {os.getpid()} executing: {" ".join(execute)}'
+        )
         self.print_lock.release()
-        return subprocess.Popen(execute)
+        return subprocess.Popen(execute, stdout=sys.stdout, stderr=sys.stderr)

src/wrappers/waifu2x_ncnn_vulkan.py

@@ -7,7 +7,7 @@ Date Created: June 26, 2019
 Last Modified: May 11, 2020
 
 Editor: K4YT3X
-Last Modified: February 22, 2020
+Last Modified: September 21, 2020
 
 Description: This class is a high-level wrapper
 for waifu2x_ncnn_vulkan.
@@ -18,8 +18,8 @@ import argparse
 import os
 import pathlib
 import platform
-import shlex
 import subprocess
+import sys
 import threading
 
 # third-party imports
@@ -41,27 +41,36 @@ class WrapperMain:
 
     @staticmethod
     def parse_arguments(arguments):
+        # fmt: off
         parser = argparse.ArgumentParser(formatter_class=argparse.ArgumentDefaultsHelpFormatter, add_help=False)
         parser.error = lambda message: (_ for _ in ()).throw(AttributeError(message))
-        parser.add_argument('--help', action='help', help='show this help message and exit')
+        parser.add_argument("--help", action="help", help="show this help message and exit")
-        parser.add_argument('-v', action='store_true', help='verbose output')
+        parser.add_argument("-v", action="store_true", help="verbose output")
-        parser.add_argument('-i', type=str, help=argparse.SUPPRESS)  # help='input image path (jpg/png) or directory')
+        parser.add_argument("-i", type=str, help=argparse.SUPPRESS)  # help="input image path (jpg/png/webp) or directory")
-        parser.add_argument('-o', type=str, help=argparse.SUPPRESS)  # help='output image path (png) or directory')
+        parser.add_argument("-o", type=str, help=argparse.SUPPRESS)  # help="output image path (jpg/png/webp) or directory")
-        parser.add_argument('-n', type=int, choices=range(-1, 4), help='denoise level')
+        parser.add_argument("-n", type=int, choices=range(-1, 4), help="denoise level")
-        parser.add_argument('-s', type=int, choices=range(1, 3), help='upscale ratio')
+        parser.add_argument("-s", type=int, help="upscale ratio")
-        parser.add_argument('-t', type=int, help='tile size (>=32)')
+        parser.add_argument("-t", type=int, help="tile size (>=32)")
-        parser.add_argument('-m', type=str, help='waifu2x model path')
+        parser.add_argument("-m", type=str, help="waifu2x model path")
-        parser.add_argument('-g', type=int, help='gpu device to use')
+        parser.add_argument("-g", type=int, help="gpu device to use")
-        parser.add_argument('-j', type=str, help='thread count for load/proc/save')
+        parser.add_argument("-j", type=str, help="thread count for load/proc/save")
-        parser.add_argument('-x', action='store_true', help='enable tta mode')
+        parser.add_argument("-x", action="store_true", help="enable tta mode")
+        parser.add_argument("-f", type=str, help=argparse.SUPPRESS)  # help="output image format (jpg/png/webp, default=ext/png)")
         return parser.parse_args(arguments)
+        # fmt: on
 
     def load_configurations(self, upscaler):
-        self.driver_settings['s'] = int(upscaler.scale_ratio)
+        # self.driver_settings['s'] = int(upscaler.scale_ratio)
-        self.driver_settings['j'] = '{}:{}:{}'.format(upscaler.processes, upscaler.processes, upscaler.processes)
+        self.driver_settings["j"] = "{}:{}:{}".format(
+            upscaler.processes, upscaler.processes, upscaler.processes
+        )
+        self.driver_settings["f"] = upscaler.extracted_frame_format.lower()
+
+    def set_scale_ratio(self, scale_ratio: int):
+        self.driver_settings["s"] = int(scale_ratio)
 
     def upscale(self, input_directory, output_directory):
-        """This is the core function for WAIFU2X class
+        """This is the core function for waifu2x class
 
         Arguments:
             input_directory {string} -- source directory path
@@ -69,31 +78,35 @@ class WrapperMain:
             ratio {int} -- output video ratio
         """
 
+        # change the working directory to the binary's parent directory
+        # so the binary can find shared object files and other files
+        os.chdir(pathlib.Path(self.driver_settings["path"]).parent)
+
         # overwrite config file settings
-        self.driver_settings['i'] = input_directory
+        self.driver_settings["i"] = input_directory
-        self.driver_settings['o'] = output_directory
+        self.driver_settings["o"] = output_directory
 
         # by default, waifu2x-ncnn-vulkan will look for the models under the current working directory
         # change the working directory to its containing folder if model directory not specified
-        if self.driver_settings['m'] is None and platform.system() == 'Windows':
+        if self.driver_settings["m"] is None and platform.system() == "Windows":
-            os.chdir(pathlib.Path(self.driver_settings['path']).parent)
+            os.chdir(pathlib.Path(self.driver_settings["path"]).parent)
 
         # list to be executed
         # initialize the list with waifu2x binary path as the first element
-        execute = [self.driver_settings['path']]
+        execute = [self.driver_settings["path"]]
 
         for key in self.driver_settings.keys():
 
             value = self.driver_settings[key]
 
             # null or None means that leave this option out (keep default)
-            if key == 'path' or value is None or value is False:
+            if key == "path" or value is None or value is False:
                 continue
             else:
                 if len(key) == 1:
-                    execute.append(f'-{key}')
+                    execute.append(f"-{key}")
                 else:
-                    execute.append(f'--{key}')
+                    execute.append(f"--{key}")
 
                 # true means key is an option
                 if value is not True:
@@ -101,6 +114,8 @@ class WrapperMain:
 
         # return the Popen object of the new process created
         self.print_lock.acquire()
-        Avalon.debug_info(f'[upscaler] Subprocess {os.getpid()} executing: {shlex.join(execute)}')
+        Avalon.debug_info(
+            f'[upscaler] Subprocess {os.getpid()} executing: {" ".join(execute)}'
+        )
         self.print_lock.release()
-        return subprocess.Popen(execute)
+        return subprocess.Popen(execute, stdout=sys.stdout, stderr=sys.stderr)