Voxta docs

FFmpeg

Local audio format conversion. Required by several TTS / STT services.

FFmpeg provides local audio format conversion. Several TTS and STT services rely on it to convert between their internal audio formats and what Voxta's playback / capture pipeline expects. The Python modules load its libraries too.

Marked Required in the registry — installed automatically. You don't normally configure it.

Where it comes from

  • Windows — Voxta downloads its own copy into Data/Tools/ffmpeg when modules install.
  • Linux — Voxta uses the FFmpeg on your PATH: sudo apt install ffmpeg on Ubuntu, sudo pacman -S ffmpeg on Arch. The Python modules need the system's FFmpeg libraries anyway, so a second copy would add nothing. The install log says which one it found. A copy an older Voxta downloaded is removed.

Only if your FFmpeg is not on PATH, create ffmpeg.config.json in the folder you start Voxta from (normally next to the executable), naming the folder that holds it:

{
  "BinaryFolder": "/opt/ffmpeg/bin"
}

Troubleshooting

If you see "ffmpeg not found" or audio conversion errors in the Terminal:

  • Windows — the downloaded copy got moved or quarantined by antivirus. Manage Modules → Reinstall All fetches it again.
  • Linux — check ffmpeg -version works in the shell that starts Voxta. If it lives elsewhere, point ffmpeg.config.json at it.

On this page