#5425 Error embedding final dub: Filter not foundTraceback (most recent call last): File "/Users/user/Desktop/Tool/youtube/py

108.165* Posted at: 10 hours ago

Error embedding final dub: Filter not found
Traceback (most recent call last):
File "/Users/user/Desktop/Tool/youtube/pyvideotrans/videotrans/task/trans_create.py", line 1665, in _subprocess

subprocess.run(

File "/Users/user/.local/share/uv/python/cpython-3.10.19-macos-aarch64-none/lib/python3.10/subprocess.py", line 526, in run

raise CalledProcessError(retcode, process.args,

subprocess.CalledProcessError: Command '['ffmpeg', '-nostdin', '-y', '-progress', 'compose1782239818.139078.txt', '-i', 'novoice.mp4', '-i', 'will_embed.m4a', '-filter_complex', "[0:v]subtitles=filename='end.ass'[v_out]", '-map', '[v_out]', '-map', '1:a', '-c:v', 'h264_videotoolbox', '-c:a', 'copy', '-q:v', '67', '-movflags', '+faststart', '-shortest', 'laste_target.mp4']' returned non-zero exit status 8.

The above exception was the direct cause of the following exception:

Traceback (most recent call last):
File "/Users/user/Desktop/Tool/youtube/pyvideotrans/videotrans/task/trans_create.
......
eads --enable-version3 --cc=clang --host-cflags= --host-ldflags= --enable-ffplay --enable-gpl --enable-libsvtav1 --enable-libopus --enable-libx264 --enable-libmp3lame --enable-libdav1d --enable-libvmaf --enable-libvpx --enable-libx265 --enable-openssl --enable-videotoolbox --enable-audiotoolbox --enable-neon
libavutil 60. 26.102 / 60. 26.102
libavcodec 62. 28.102 / 62. 28.102
libavformat 62. 12.102 / 62. 12.102
libavdevice 62. 3.102 / 62. 3.102
libavfilter 11. 14.102 / 11. 14.102
libswscale 9. 5.102 / 9. 5.102
libswresample 6. 3.102 / 6. 3.102
[AVFilterGraph @ 0x147e13b90] No such filter: 'subtitles'
Error : Filter not found

,Command '['ffmpeg', '-nostdin', '-y', '-progress', 'compose1782239818.139078.txt', '-i', 'novoice.mp4', '-i', 'will_embed.m4a', '-filter_complex', "[0:v]subtitles=filename='end.ass'[v_out]", '-map', '[v_out]', '-map', '1:a', '-c:v', 'h264_videotoolbox', '-c:a', 'copy', '-q:v', '67', '-movflags', '+faststart', '-shortest', 'laste_target.mp4']' returned non-zero exit status 8.

During handling of the above exception, another exception occurred:

Traceback (most recent call last):
File "/Users/user/Desktop/Tool/youtube/pyvideotrans/videotrans/util/help_ffmpeg.py", line 57, in runffmpeg

subprocess.run(

File "/Users/user/.local/share/uv/python/cpython-3.10.19-macos-aarch64-none/lib/python3.10/subprocess.py", line 526, in run

raise CalledProcessError(retcode, process.args,

subprocess.CalledProcessError: Command '['ffmpeg', '-hide_banner', '-nostdin', '-ignore_unknown', '-threads', '0', '-y', '-progress', 'compose1782239818.139078.txt', '-i', 'novoice.mp4', '-i', 'will_embed.m4a', '-filter_complex', "[0:v]subtitles=filename='end.ass'[v_out]", '-map', '[v_out]', '-map', '1:a', '-c:v', 'libx264', '-c:a', 'copy', '-crf', '23', '-preset', 'medium', '-movflags', '+faststart', '-shortest', 'laste_target.mp4']' returned non-zero exit status 8.

The above exception was the direct cause of the following exception:

Traceback (most recent call last):
File "/Users/user/Desktop/Tool/youtube/pyvideotrans/videotrans/task/trans_create.py", line 1486, in _join_video_audio_srt

runffmpeg(cmd0 + cmd1 + subtitle_filter + cmd2 + enc_qua + cmd3,

File "/Users/user/Desktop/Tool/youtube/pyvideotrans/videotrans/util/help_ffmpeg.py", line 87, in runffmpeg

raise FFmpegError(err) from e

videotrans.configure.excepts.FFmpegError: : Filter not found

The above exception was the direct cause of the following exception:

Traceback (most recent call last):
File "/Users/user/Desktop/Tool/youtube/pyvideotrans/videotrans/task/only_one.py", line 124, in run

trk.assembling()

File "/Users/user/Desktop/Tool/youtube/pyvideotrans/videotrans/task/trans_create.py", line 761, in assembling

self._join_video_audio_srt()

File "/Users/user/Desktop/Tool/youtube/pyvideotrans/videotrans/task/trans_create.py", line 1489, in _join_video_audio_srt

raise VideoTransError(tr('Error in embedding the final step of the subtitle dubbing')+str(e)) from e

videotrans.configure.excepts.VideoTransError: Error embedding final dub: Filter not found

cfg=[TaskCfgVTT]当前工作模式: 翻译视频或音频 单视频模式
原始输入文件名: /Users/user/Downloads/Family Guy - Bonnie opened her curtains.mp4,
输出结果保存到文件夹: /Users/user/Desktop/Tool/youtube/Family Guy - Bonnie opened her curtains-mp4,
临时文件夹: /Users/user/Desktop/Tool/youtube/pyvideotrans/tmp/5483/bcde59a931
已选 清理已存在
未选 启用CUDA加速
未选 降噪
ASR Channel:faster-whisper(LocalBuilt-in), model_name: large-v3-turbo, 发音语言: English, 断句方式:默认断句
Trans Channel:OpenAI ChatGPT,原始语言:English,目标语言:Vietnamese, 已选 Send SRT
未选 配音角色,不进行配音
字幕: Embed Hard Subs
已选 分离人声与背景声, 已选 重新嵌入背景声, 背景音量1.0, 背景声音时长 短于 视频时长时: 拉长(降速播放),存在分离后的纯净人声文件,存在分离后的背景声音文件
代理地址:


=
system:macOS-15.7.3-arm64-arm-64bit
version:v4.03
frozen:False
language:en
root_dir:/Users/user/Desktop/Tool/youtube/pyvideotrans
Python: 3.10.19 (main, Feb 12 2026, 00:36:33) [Clang 21.1.4 ]

1 Replies

The error Filter not found: 'subtitles' indicates that your FFmpeg installation lacks the libass library, which is required for embedding hard subtitles (the subtitles filter). This is the root cause.

Solution:

  1. Install/Reinstall FFmpeg via Homebrew with libass support:

    brew reinstall ffmpeg --with-libass

    If --with-libass is not recognized (Homebrew may have updated), use:

    brew reinstall ffmpeg

    Then ensure libass is present by running brew list ffmpeg | grep libass. If not, install libass separately:

    brew install libass
    brew reinstall ffmpeg
  2. Verify the subtitles filter is now available:

    ffmpeg -filters | grep subtitles

    You should see subtitles listed.

  3. If you compiled FFmpeg manually, add --enable-libass to your configure flags and rebuild.
  4. Restart pyVideoTrans and retry the task.

The libass dependency is not bundled with macOS default FFmpeg builds, so this is a common issue on macOS.

Post Your Reply
Open source and free maintenance is not easy. If this project is helpful to you, please consider making a small donation to help the project continue to maintain and update. Dondate: ko-fi.com/jianchang512

Related resource

Similar issues already exist