AV1Converter

A terminal-based interactive tool to batch convert video files to the AV1 codec using FFmpeg. It auto-detects available hardware encoders, verifies output quality with VMAF, and manages the full encoding pipeline through a TUI.

Features

• Interactive TUI — Browse files, configure tracks, and monitor encoding progress in the terminal
• Two operating modes — Re-encode to AV1, or demux/remux to repackage and strip tracks without recompression
• Hardware acceleration — Automatically detects and uses NVIDIA NVENC, Intel QSV, or AMD AMF; the choice can be overridden manually in Settings
• Batch processing — Convert a single file, a folder, or an entire directory tree recursively
• Smart preset selection — Automatically picks encoding parameters based on resolution and HDR type
• Dolby Vision support — Keep Dolby Vision in the AV1 output (profile 10) or convert to true HDR10 with static metadata; profile 5 sources are tone-mapped on the GPU
• Quality presets — Low, Medium, or High shifts CRF/CQ values across every resolution tier at once; Custom leaves each tier's values manually editable
• VMAF quality verification — Scores output quality after encoding; deletes source file if the threshold is met
• Track selection — Auto-selects audio and subtitle tracks by preferred language; Selects all tracks or first track when no match is found
• Multi-language UI — Interface available in English (default), Italian, Spanish, French, German, and Chinese; selectable in Settings
• Configurable — All key settings adjustable through the built-in configuration screen or ~/.config/av1converter/config.toml

Prerequisites

ffmpeg and ffprobe must be on your PATH. FFmpeg 8.0 or newer is required for Dolby Vision passthrough ("Dolby Vision profile 10 support in AV1" landed in 8.0; the tool is developed and tested against 8.1).

Not every FFmpeg build includes every feature this tool uses. What you need depends on which features you use:

Check what your build supports:

ffmpeg -version                                  # 8.0+ required for DV passthrough
ffmpeg -h encoder=libsvtav1 | grep dolbyvision   # DV passthrough
ffmpeg -filters | grep libvmaf                   # VMAF verification
ffmpeg -filters | grep libplacebo                # DV profile 5 tone-mapping
vulkaninfo --summary                             # Vulkan driver (DV profile 5 only)

Platform notes:

• Arch Linux — pacman -S ffmpeg includes all of the above. For DV profile 5 tone-mapping also install your GPU's Vulkan driver (vulkan-radeon, vulkan-intel, or nvidia-utils).
• Debian/Ubuntu — the distro ffmpeg includes libsvtav1, but is often older than 8.0 (no DV passthrough — selecting "keep Dolby Vision" will fail); libvmaf and libplacebo also vary by release. Verify with the commands above.
• Fedora — use the FFmpeg from RPM Fusion; the freeworld build includes libsvtav1 and libvmaf.
• macOS — brew install ffmpeg includes libsvtav1 and libvmaf but not libplacebo/Vulkan: everything works except DV profile 5 → HDR10 tone-mapping (keeping DV still works for profile 5).
• Windows — the full builds from gyan.dev or BtbN (GPL variant) include everything.

Installation

git clone https://github.com/your-username/av1converter.git
cd av1converter
cargo build --release

The compiled binary will be at target/release/av1converter.

Usage

./av1converter

No command-line arguments are needed. All interaction happens through the TUI.

Workflow

1. Home menu — Choose to open a single file, a folder, or a folder recursively
2. File selection — Navigate with arrow keys; Space to toggle, Enter to confirm
3. Track configuration — Select audio and subtitle tracks to include, and switch the per-file mode (encode or demux/remux) with r
4. File review — Confirm the queue before encoding starts
5. Encoding — Monitor per-file and overall progress; Esc to cancel
6. VMAF verification — Quality score is computed after each file; source is deleted if the score meets the threshold (encode mode only)
7. Finish — View a summary of conversions, skipped files, and space saved

Modes

Each file in the queue is processed in one of two modes. The mode is chosen per file on the track configuration screen and can be toggled with r.

Encode Mode (Encode Video → AV1)

The default mode for non-AV1 sources. The video stream is re-encoded to AV1 using the detected hardware or software encoder, with parameters chosen automatically from the resolution and HDR format (see Encoding Presets). Selected audio and subtitle tracks are copied into the output. Output is written to the configured container (e.g. mkv) with the configured suffix (default _av1), and the result is verified with VMAF before the source can be deleted.

Demux/Remux Mode (Remux Only → Copy Video)

A fast, lossless repackaging mode that copies the video, audio, and subtitle streams without recompression (-c copy). Use it to change the container, drop unwanted audio/subtitle tracks, or clean up files that are already AV1 — no quality is lost and the operation is near-instant since nothing is re-encoded. The output keeps the source file's container extension and uses the _remux suffix. Because no encoding happens, VMAF verification is skipped.

Files that are already encoded in AV1 default to demux/remux mode automatically; everything else defaults to encode mode.

Dolby Vision Handling

When a Dolby Vision source is queued for encoding, a dialog asks how to convert it (reopen it anytime with d):

1. AV1 with Dolby Vision (profile 10) — the DV dynamic metadata (RPU) is carried into the AV1 stream. Requires the SVT-AV1 encoder; hardware encoders (NVENC/QSV/AMF) cannot write the RPU and always produce HDR10. For cross-compatible profiles (7/8) the HDR10 base layer is preserved, so players without DV support still get correct HDR10 playback.
2. AV1 with true HDR10 — the DV layer is dropped and the HDR10 static metadata (mastering display, MaxCLL/MaxFALL) from the source is written into the AV1 stream.

Profile 5 sources (IPT-PQ-c2, no HDR10-compatible base layer) are special: converting to HDR10 tone-maps the video on the GPU via libplacebo (requires Vulkan), while keeping DV produces output that only plays correctly on DV-capable players. HDR10 conversion is the recommended default for profile 5; keeping DV is recommended for profiles 7/8. VMAF verification is skipped for tone-mapped profile 5 output, since the pixels are intentionally changed.

Keyboard Controls

Encoding Presets

Presets are selected automatically based on resolution and HDR format:

Files already encoded in AV1 are automatically skipped.

Encoder Detection

The tool detects available encoders at startup with the following priority:

1. NVIDIA NVENC (av1_nvenc) — RTX 40/50 series and compatible Ada/L-series GPUs
2. Intel Quick Sync (av1_qsv) — Intel Arc GPUs (Linux/Windows only)
3. AMD AMF (av1_amf) — RDNA3 architecture, RX 7000 series (Linux/Windows only)
4. SVT-AV1 (libsvtav1) — Software fallback; always used on macOS

Configuration

Configuration is stored at ~/.config/av1converter/config.toml and can be edited directly or through the built-in configuration screen.

language = "en"                # UI language: en, it, es, fr, de, zh (English if omitted)
encoder = "SvtAv1"             # Selected encoder: Nvenc, Qsv, Amf, SvtAv1 (auto-detected on first run, then overridable)
quality_preset = "medium"      # Quality preset: low, medium, high, custom

[Quality]
vmaf_threshold = 90.0          # VMAF score required to consider encoding successful (0–100)
vmaf_enabled = true            # Enable/disable VMAF verification after encoding
delete_source_on_success = false  # Delete source file when VMAF score meets threshold

[Performance]
svt_preset = 4             # SVT-AV1 preset: 0 (slowest) – 13 (fastest)
nvenc_preset = "p4"        # NVENC preset: p1 (best quality) – p7 (fastest)

[Output]
suffix = "_av1"            # Appended to output filenames
container = "mkv"          # Output container (mkv, mp4, …)
same_directory = true      # Write output next to source file
output_directory = null    # Custom output path (used when same_directory = false)

[Tracks]
preferred_audio_languages = ["eng", "ita"]
preferred_subtitle_languages = ["eng"]
select_all_fallback = true # Select all tracks if no preferred language is found

Each resolution preset also exposes per-encoder quality values (crf, nvenc_cq, qsv_quality, amf_quality) and film_grain synthesis strength.

quality_preset controls how those per-resolution values are managed: low, medium, and high apply built-in CRF/CQ values shifted across every tier at once (overwriting the presets table), while custom leaves the presets table untouched and editable, either directly in the file or via the RF fields on the configuration screen.

output_directory can only be set by editing the file directly; the configuration screen exposes same_directory but not a path picker.

Debugging

Set the AV1_DEBUG environment variable to enable log output:

AV1_DEBUG=1 ./av1converter

Logs are written to:

• macOS/Linux: ~/.local/share/av1converter/av1converter.log
• Windows: %APPDATA%\av1converter\av1converter.log