Repository navigation
Releases
AxiomPy 0.2.5
AxiomPy 0.2.5
AxiomPy 0.2.5 fixes invalid FFmpeg scale filters emitted by some size presets and
makes batch progress reporting reliable at completion.
Size preset scaling
- Selecting a size such as 1080p now resolves its standard dimensions even
though the width and height fields are locked by the preset. - Combining 1080p with lanczos now generates
scale=1920:-2:flags=lanczosinstead of the invalid
scale=:-2:flags=lanczos. - The same correction applies to UHD and Blu-ray presets that previously left
the locked width empty. - Full Screen mode uses the preset height when its locked field is empty.
Batch progress
- Aggregate batch progress no longer moves backward when the final progress
poll races with a partial report. - Completed batch conversions now reliably finish at 100%.
Portable package
Two archives are published:
AxiomPy-0.2.5-win64.zipincludes FFmpeg 7.1.1, FFprobe and FFplay.AxiomPy-0.2.5-win64-noffmpeg.zipomits those tools. Put a real FFmpeg
bindirectory onPATHor select the executables in Settings → Config.
Both archives extract to an AxiomPy folder. Run AxiomPy\AxiomPy.exe; in the
full package keep _internal next to the executable.
Get-FileHash -Algorithm SHA256 .\AxiomPy-0.2.5-win64.zip
Get-FileHash -Algorithm SHA256 .\AxiomPy-0.2.5-win64-noffmpeg.zipValidation
- Test suite:
458 passed, 9 skipped - Real FFmpeg 7.1.1 conversions:
9 passed - 15 native Windows screenshots matched
- PyInstaller 6.22.3 build passed
- Both portable packages passed
packaging\verify.ps1, including the startup
smoke test
Requirements and limitations
- Windows 10 or Windows 11.
- Python 3.9 through 3.13 for source installs.
- Bundled FFmpeg 7.1.1; NVENC requires NVIDIA driver 570.00 or newer.
- QSV/AMF availability depends on the GPU and driver runtime.
AxiomPy 0.2.4
AxiomPy 0.2.4
AxiomPy 0.2.4 restores dock recoverability and refreshes the CI and packaging
toolchain while keeping Python 3.9 support.
Dock recovery
- A new View menu lists Script Panel, Log Panel and Batch Queue.
- Closing any of those docks no longer makes it unreachable.
- The same menu restores docks that were hidden by a saved workspace.
- Menu styling follows the Axiom Dark theme.
Build and CI
- Updated
actions/checkoutto v7 andactions/setup-pythonto v7. - Updated PyInstaller to 6.22.3.
- Dependency update PRs requiring Python 3.10 or newer were intentionally not
merged because the project still supports Python 3.9.
Portable package
Two archives are published:
AxiomPy-0.2.4-win64.zipincludes FFmpeg 7.1.1, FFprobe and FFplay. This is
the recommended self-contained package.AxiomPy-0.2.4-win64-noffmpeg.zipomits those tools. Put a real FFmpeg
bindirectory onPATHor select the executables in Settings → Config.
Both archives extract to an AxiomPy folder. Run AxiomPy\AxiomPy.exe; in the
full package keep _internal next to the executable.
Get-FileHash -Algorithm SHA256 .\AxiomPy-0.2.4-win64.zip
Get-FileHash -Algorithm SHA256 .\AxiomPy-0.2.4-win64-noffmpeg.zipValidation
- Test suite:
456 passed, 9 skipped - Real FFmpeg 7.1.1 conversions:
9 passed - 15 native Windows screenshots matched at
0.0000% - PyInstaller 6.22.3 build passed
- Both portable packages passed
packaging\verify.ps1, including the startup
smoke test
Requirements and limitations
- Windows 10 or Windows 11.
- Python 3.9 through 3.13 for source installs.
- Bundled FFmpeg 7.1.1; NVENC requires NVIDIA driver 570.00 or newer.
- QSV/AMF availability depends on the GPU and driver runtime.
AxiomPy 0.2.3
AxiomPy 0.2.3
AxiomPy 0.2.3 makes Custom quality rate-control generation predictable and
extends the preset hint system to parameter-level presets and settings paths.
Custom quality
- User-entered CRF, bitrate, min/max rate and buffer size values are preserved
when controls are resolved. - Bare rate numbers are treated as kilobits:
4500becomes4500K. - Selecting Custom starts on the
CRFpass. Bitrate is preserved as-b:v
and does not create Max Rate or Buffer Size arguments on its own. A supplied
Max Rate is clamped to at least Bitrate and receives a default buffer when
Buffer Size is empty. x264/x265 still prioritize CRF over the bitrate target. - In
1 Pass/2 Pass, VBR checked uses average bitrate (-b:v); VBR
unchecked emits CBR defaults (-minrate/-maxrateplus a buffer) when no
explicit limits are supplied. - In CRF mode, a supplied Max Rate plus its buffer act as VBV limits. Min Rate
is used in 1-pass/2-pass VBR/CBR and is disabled on the CRF pass, where
FFmpeg has no minimum-bitrate target. These limits reach software and
NVENC/AMF/QSV commands where supported. 2 Passignores CRF because FFmpeg does not allow CRF with two-pass encoding;
CRF and VBR controls are disabled with explanatory tooltips when the selected
pass cannot use them.- Image codecs use
-q:vfor the Custom quality value. - Switching from a named quality to Custom clears stale values once; later pass
or VBR changes keep the user's edits.
Presets and parameter hints
- The persistent hint now covers video quality, optimization, size and audio
quality presets, not only the Input/Output preset list. - Disabled labels and controls are grayed together and explain the controlling
preset on hover. - Top-level preset values still have the Unlock action.
Settings paths
- FFmpeg, FFprobe and FFplay rows show the resolved executable below
<auto>. - Each row has Browse… and Auto buttons.
- Log File has a Browse… button.
Portable package
Two archives are published:
AxiomPy-0.2.3-win64.zipincludes FFmpeg 7.1.1, FFprobe and FFplay. This is
the recommended self-contained package.AxiomPy-0.2.3-win64-noffmpeg.zipomits those tools. Put a real FFmpeg
bindirectory onPATHor select the executables in Settings → Config.
Both archives extract to an AxiomPy folder. Run AxiomPy\AxiomPy.exe; in the
full package keep _internal next to the executable.
Get-FileHash -Algorithm SHA256 .\AxiomPy-0.2.3-win64.zip
Get-FileHash -Algorithm SHA256 .\AxiomPy-0.2.3-win64-noffmpeg.zipValidation
- Test suite:
371 passed, 8 skipped - Real FFmpeg conversions with 7.1.1:
8 passed, including H.264/HEVC NVENC
and Custom CRF, bitrate and CBR cases - 13 native Windows screenshot pages matched at
0.0000% - C# golden commands remain byte-identical except for the documented Custom
rate-control and AMF QVBR corrections
Requirements and limitations
- Windows 10 or Windows 11.
- Bundled FFmpeg 7.1.1; NVENC requires NVIDIA driver 570.00 or newer.
- QSV/AMF availability depends on the GPU and driver runtime.
AxiomPy 0.2.2
AxiomPy 0.2.2
AxiomPy 0.2.2 improves preset discoverability and fixes the bundled FFmpeg /
NVIDIA driver compatibility failure.
Preset UI
- Selecting a preset now shows a persistent hint above the Input/Output panel.
- Preset-owned controls are grayed out and explain the reason on hover.
- Unlock keeps the current preset values while allowing edits.
- The hint disappears after unlocking or selecting the manual
Presetentry.
FFmpeg / NVENC compatibility
The portable package now bundles FFmpeg 7.1.1 instead of FFmpeg 8.x.
FFmpeg 7.1.1 uses NVENC API 13.0, which works with NVIDIA driver 570.00 or
newer. FFmpeg 8.x targets API 13.1 and requires driver 610+, producing:
Required: 13.1 Found: 13.0
The minimum required Nvidia driver for nvenc is 610.00 or newer
The release workflow downloads the pinned archive, verifies its SHA-256 and
checks the extracted ffmpeg -version before packaging. If FFmpeg still reports
an API mismatch at runtime, AxiomPy now shows an actionable status message
recommending a driver update or x264/x265 fallback.
Drivers older than 570.00 can still use x264/x265, or point
Settings → FFmpeg at a custom compatible build.
Portable package
Extract the whole AxiomPy-0.2.2-win64.zip folder and run
AxiomPy\AxiomPy.exe. Keep _internal next to the executable; the bundled
tools live there.
Get-FileHash -Algorithm SHA256 .\AxiomPy-0.2.2-win64.zipValidation
- Test suite:
349 passed, 4 skipped - Real FFmpeg conversions with 7.1.1:
4 passed, including H.264 and HEVC NVENC - 13 native Windows screenshot pages matched at
0.0000% - C# golden commands remain byte-identical, with the documented AMF QVBR
correction
Requirements and limitations
- Windows 10 or Windows 11.
- Bundled FFmpeg 7.1.1; NVENC requires driver 570.00 or newer.
- QSV/AMF availability depends on the installed GPU and driver runtime.
- The release is unsigned and does not include an installer.
AxiomPy 0.2.1
AxiomPy 0.2.1
AxiomPy 0.2.1 fixes the broken 0.2.0 portable package and adds the requested
preset, container, audio-stream and mouse-wheel UI behavior.
Fixed
- The Windows archive now contains the real FFmpeg, FFprobe and FFplay binaries.
The 0.2.0 archive accidentally bundled Chocolatey shims, which failed with
Cannot find file at '..\lib\ffmpeg\tools\ffmpeg\bin\ffmpeg.exe'. - Portable builds reject shim executables and verify each bundled tool with
-versionbefore publishing.
Added
- Preset-owned controls are grayed out with a hover explanation. Click
Unlock next to the preset list to keep the current values and edit them. - Settings → System → Mouse wheel adjusts values (off by default) controls
whether the wheel can change combo boxes and spin boxes.
Changed
- New installations start with the MP4 container.
- Audio stream selection defaults to all.
- AMF quality now uses native
-rc qvbr -qvbr_quality_levelarguments instead
of a generic-crfflag. NVENC and QSV keep their original Axiom arguments.
Portable package
Extract the whole AxiomPy-0.2.1-win64.zip folder and run
AxiomPy\AxiomPy.exe. Keep _internal next to the executable; the bundled
FFmpeg tools live there.
Verify the download:
Get-FileHash -Algorithm SHA256 .\AxiomPy-0.2.1-win64.zipValidation
- Test suite:
347 passed, 4 skipped - Opt-in real FFmpeg conversions:
4 passed, including H.264 and HEVC NVENC - 13 native Windows screenshot pages passed the pixel-regression comparison
- C# golden commands remain byte-identical, with a documented AMF QVBR
correction
Requirements and limitations
- Windows 10 or Windows 11.
- NVENC/QSV/AMF availability depends on the installed GPU, driver and FFmpeg
runtime. - The release is unsigned and does not include an installer.
AxiomPy 0.2.0
AxiomPy 0.2.0
The first public AxiomPy release: a Python/PySide6 desktop frontend for building,
reviewing and running FFmpeg commands on Windows.
Highlights
- Video, audio, subtitle, container, filter and output-naming controls.
- Software and hardware encoding, including NVENC, QSV and AMF codec families.
- CRF, VBR, CBR, lossless, 1-pass and 2-pass workflows.
- External audio/subtitle muxing, stream metadata and subtitle burn-in.
- Batch queue with per-file status tracking.
- Editable scripts, progress, cancellation and optional external console.
- 1280x720 default layout with 8-16 pt interface scaling.
- Optional workspace restoration covering geometry, docks, tabs, script and parameters.
- English and Simplified Chinese README.
Portable package
The release asset contains a self-contained Windows onedir package with FFmpeg,
FFprobe and FFplay. Extract AxiomPy-0.2.0-win64.zip, then run
AxiomPy\AxiomPy.exe.
Verify the download with the adjacent .sha256 file:
Get-FileHash -Algorithm SHA256 .\AxiomPy-0.2.0-win64.zipValidation
- Python test suite:
342 passed, 2 skipped - Opt-in real FFmpeg conversions:
2 passed - Four hardware-command oracle cases match the original C# implementation
- 13 native Windows screenshot pages matched at
0.0000% - Windows CI matrix: Python 3.9 and 3.12
Requirements and limitations
- Windows 10 or Windows 11.
- QSV/AMF availability depends on the installed GPU runtime and drivers.
- YouTube/yt-dlp download support is intentionally not included.
- This release is unsigned and does not include an installer.
See CHANGELOG.md and the
README for details.