VideoTagger

Getting started

Download the repository with:

git clone --recursive https://github.com/VideoTagger/VideoTagger

If the repository was cloned non-recursively run:

git submodule update --init

Build Requirements

• Python 3.12+ (tested with 3.12.6 and 3.13.0)
• Visual Studio 2022 (on Windows)

‍[!Important] Both Linux and macOS require SDL2 version 2.0.17 or later to build properly.

Windows comes with prebuilt binaries.

Windows - Visual Studio

Generate project files with:

scripts/win-gen-projects.cmd

Build the projects by opening the Visual Studio solution file and building with desired configuration.

Linux - Makefile

Install Required packages

build-essential pkg-config libsdl2-dev libavcodec-dev libavformat-dev libswscale-dev python3-dev libgtk-3-dev libglib2.0-dev libgtk2.0-dev libssl-dev

Generate project files with:

chmod +x ./scripts/linux-gen-projects.sh && ./scripts/linux-gen-projects.sh

Build the projects by running:

make config=<BUILD_CONFIG>

Replace <BUILD_CONFIG> with one of:

• debug_x86_64
• release_x86_64
• shipping_x86_64

Xcode (macOS)

‍[!Warning] Building on macOS is untested

Generate project files with:

scripts/macos-gen-projects.sh

Build the projects by opening the Xcode project file and building with desired configuration.

Third party libraries

• SDL2
• ImGui
• ImGuizmo
• Native File Dialog Extended
• fmt
• Nlohmann Json
• utf8.h
• pybind11
• FFmpeg
• cpp-httplib
• OpenSSL

License

This software is licensed under the MIT License.

This software uses LGPL-licensed libraries from the FFmpeg project.

FFmpeg is an open-source framework licensed under the GNU Lesser General Public License (LGPL) version 2.1 or later. However, FFmpeg incorporates several optional parts and optimizations that are covered by the GNU General Public License (GPL) version 2 or later. If those parts get used the GPL applies to all of FFmpeg.

For more information regarding FFmpeg license and legal considerations see https://www.ffmpeg.org/legal.html.