Fail to install ffmpeg in Publish documentation / update-cli-screenshots ci workflow

[HankyStyle]

Description

The update-cli-screenshots job in the documentation publishing workflow is failing due to an ffmpeg installation error when using charmbracelet/vhs-action@v2.

Workflow Run: https://github.com/commitizen-tools/commitizen/actions/runs/22021621926/job/63631586440

Error Message:

Error: Failed to install ffmpeg

Root Cause:

I found this is a known issue with vhs-action@v2 (see charmbracelet/vhs-action#459).

The problem is related to:

1. Ubuntu 24.04 compatibility: GitHub Actions now defaults to Ubuntu 24.04, and vhs-action@v2 has compatibility issues with ffmpeg installation on this newer Ubuntu version
2. Installation process failure: The action's internal ffmpeg installation step fails on the newer runner environment

Steps to reproduce

1. Push changes to the master branch that trigger the documentation workflow
2. The update-cli-screenshots job runs with ubuntu-latest (currently Ubuntu 24.04)
3. The workflow executes the step: - name: Install VHS using charmbracelet/vhs-action@v2
4. The VHS action attempts to install ffmpeg
5. Installation fails with error: Error: Failed to install ffmpeg

Current behavior

Workflow fails and CLI screenshots cannot be updated

Desired behavior

ffmpeg should install successfully and VHS should generate CLI screenshots

Screenshots

Environment

Commitizen Version: 4.13.7
Python Version: 3.14.2 (v3.14.2:df793163d58, Dec 5 2025, 12:18:06) [Clang 16.0.0 (clang-1600.0.26.6)]
Operating System: Darwin

[bearomorphism]

Thanks for providing the root cause!