#4940 Valid A/V file required

"Valid A/V file required" means the software cannot locate a valid audio or video file. This typically occurs due to file path issues, unsupported format, or an empty folder in batch mode.

Troubleshooting steps:

1. Check file path and name – Ensure the input file path contains no spaces, Chinese characters, or special symbols. Avoid deep directory trees (keep total path length under ~200 characters on Windows; Linux has similar limits when using ffmpeg).

2. Verify file format – Confirm the file extension is in the supported list:

   • Video: mp4, mov, avi, mkv, webm, mpeg, ogg, mts, ts
   • Audio: wav, mp3, m4a, flac, aac
3. If using folder mode – Make sure the selected folder actually contains at least one valid audio/video file.
4. If using CLI – Double-check the --name argument is correct and points to an existing file (e.g., uv run cli.py --task stt --name "/path/to/video.mp4").
5. Rename the file – Try a short, simple name like test.mp4 and place it in a shallow directory (e.g., /home/foxcode/test.mp4).

If the issue persists, please provide the last 30 lines from the log file located at logs/YYYYMMDD.log under the software root directory.
Do not include the file path in quotes unless it contains spaces – Linux requires quoted paths only when spaces or special characters are present.

Please refer to the following documentation:

• File path problems (Note: The English version might be available at the same URL)
• Common errors and solutions

[ERROR] faster_whisper[compute_type='int8_float16']语音转录失败:local_dir='/home/foxcode/Documents/Github/pyvideotrans/models/models--Systran--faster-whisper-large-v3'
Traceback (most recent call last):
File "/home/foxcode/Documents/Github/pyvideotrans/videotrans/process/stt_fun.py", line 347, in faster_whisper

model = WhisperModel(

File "/home/foxcode/Documents/Github/pyvideotrans/.venv/lib/python3.10/site-packages/faster_whisper/transcribe.py", line 689, in init

self.model = ctranslate2.models.Whisper(

RuntimeError: Unable to open file 'model.bin' in model '/home/foxcode/Documents/Github/pyvideotrans/models/models--Systran--faster-whisper-large-v3'

[ERROR] new process:Traceback (most recent call last):
File "/home/foxcode/Documents/Github/pyvideotrans/videotrans/configure/_base.py", line 289, in _new_process

raise RuntimeError(err)

RuntimeError: Traceback (most recent call last):
File "/home/foxcode/Documents/Github/pyvideotrans/videotrans/process/stt_fun.py", line 347, in faster_whisper

model = WhisperModel(

File "/home/foxcode/Documents/Github/pyvideotrans/.venv/lib/python3.10/site-packages/faster_whisper/transcribe.py", line 689, in init

self.model = ctranslate2.models.Whisper(

RuntimeError: Unable to open file 'model.bin' in model '/home/foxcode/Documents/Github/pyvideotrans/models/models--Systran--faster-whisper-large-v3'

Traceback (most recent call last):
File "/home/foxcode/Documents/Github/pyvideotrans/videotrans/configure/_base.py", line 289, in _new_process

raise RuntimeError(err)

RuntimeError: Traceback (most recent call last):
File "/home/foxcode/Documents/Github/pyvideotrans/videotrans/process/stt_fun.py", line 347, in faster_whisper

model = WhisperModel(

File "/home/foxcode/Documents/Github/pyvideotrans/.venv/lib/python3.10/site-packages/faster_whisper/transcribe.py", line 689, in init

self.model = ctranslate2.models.Whisper(

RuntimeError: Unable to open file 'model.bin' in model '/home/foxcode/Documents/Github/pyvideotrans/models/models--Systran--faster-whisper-large-v3'

[ERROR] Traceback (most recent call last):
File "/home/foxcode/Documents/Github/pyvideotrans/videotrans/process/stt_fun.py", line 347, in faster_whisper

model = WhisperModel(

File "/home/foxcode/Documents/Github/pyvideotrans/.venv/lib/python3.10/site-packages/faster_whisper/transcribe.py", line 689, in init

self.model = ctranslate2.models.Whisper(

RuntimeError: Unable to open file 'model.bin' in model '/home/foxcode/Documents/Github/pyvideotrans/models/models--Systran--faster-whisper-large-v3'
Traceback (most recent call last):
File "/home/foxcode/Documents/Github/pyvideotrans/videotrans/task/job.py", line 105, in run

trk.recogn()

File "/home/foxcode/Documents/Github/pyvideotrans/videotrans/task/_speech2text.py", line 159, in recogn

raw_subtitles = run(

File "/home/foxcode/Documents/Github/pyvideotrans/videotrans/recognition/__init__.py", line 293, in run

return FasterAll(**kwargs).run()

File "/home/foxcode/Documents/Github/pyvideotrans/videotrans/recognition/_base.py", line 143, in run

res = self._exec()

File "/home/foxcode/Documents/Github/pyvideotrans/videotrans/recognition/_overall.py", line 33, in _exec

raws = self._faster()

File "/home/foxcode/Documents/Github/pyvideotrans/videotrans/recognition/_overall.py", line 105, in _faster

raws=self._new_process(callback=faster_whisper,title=title,is_cuda=self.is_cuda,kwargs=kwargs)

File "/home/foxcode/Documents/Github/pyvideotrans/videotrans/configure/_base.py", line 289, in _new_process

raise RuntimeError(err)

RuntimeError: Traceback (most recent call last):
File "/home/foxcode/Documents/Github/pyvideotrans/videotrans/process/stt_fun.py", line 347, in faster_whisper

model = WhisperModel(

File "/home/foxcode/Documents/Github/pyvideotrans/.venv/lib/python3.10/site-packages/faster_whisper/transcribe.py", line 689, in init

self.model = ctranslate2.models.Whisper(

RuntimeError: Unable to open file 'model.bin' in model '/home/foxcode/Documents/Github/pyvideotrans/models/models--Systran--faster-whisper-large-v3'

核心原因是模型文件损坏或下载不完整：本地路径 /home/foxcode/Documents/Github/pyvideotrans/models/models--Systran--faster-whisper-large-v3/ 下缺少 model.bin 文件。

解决方案：

1. 删除损坏的模型目录

   rm -rf "/home/foxcode/Documents/Github/pyvideotrans/models/models--Systran--faster-whisper-large-v3"

2. 重新下载模型
   启动软件后再次运行识别任务，软件会自动从 HuggingFace 重新下载。由于国内网络可能受限，建议配置代理或使用镜像站：
   在软件主界面的网络代理地址框填入代理（例如 http://127.0.0.1:7890）；若无代理，也可手动从镜像下载并解压：

   cd /home/foxcode/Documents/Github/pyvideotrans/models
   git clone https://hf-mirror.com/Systran/faster-whisper-large-v3
   # 或使用 huggingface-cli (需安装)
   huggingface-cli download Systran/faster-whisper-large-v3 --local-dir ./models--Systran--faster-whisper-large-v3

3. 验证模型完整性
   确保目录下包含 model.bin、config.json、tokenizer.json 等核心文件。

如果问题依然存在：
请提供 models/models--Systran--faster-whisper-large-v3 目录列表，以进一步判断。