在 MacOS 里面跑 VideoCaptioner 1.3.2

[philpw99]

看到有几位大哥都在问有关 Mac 版本的 VideoCaptioner ，于是就想在这里放个教程，让大家可以看看，也希望WEIFENG大哥可以把这样的教程放到 WIKI 里面，毕竟问的人开始多了。

因为我人比较话多，所以这个教程会有点长，各位请耐心看完。因为高手就一早把这软件给装了，看这教程的人我假定是不清楚HomeBrew，Python 等东西的。

首先什么是 HomeBrew 。 一般的苹果软件都是图形界面，但互联网上许多免费和实用的工具都是纯文字的，而苹果电脑正缺乏这些免费工具。HomeBrew 就是一个让你轻松安装这些免费工具的免费工具。

要安装HomeBrew，首先要打开个终端屏幕，在苹果里面，这样的工具一般是这个样子的：

点击终端屏幕后，就出现一个这样的终端屏幕：

你现在就可以一句一句地打命令了。别小看这一句句的，许多强功能都是这样实现的。
第一个命令就是安装 HomeBrew：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

然后它会问你Mac账号的密码，打入后按回车
接着它会给你最后机会退出，按回车键继续
一大堆的东西出来后，HomeBrew 就安装好了。接下来的工作也就相对简单了。
逐行打入以下命令：
brew install aria2
brew install git
brew install python@3.12
brew install ffmpeg
brew install whisper-cpp

等这五个都安装好后，就逐行打入：
cd Desktop
git clone https://github.com/WEIFENG2333/VideoCaptioner.git
cd VideoCaptioner
python3 -m venv venv
source venv/bin/activate
pip3 install -r requirements.txt
接着又是一大堆东西安装下来，结束后，打以下命令建立一个 run.command 文件：
echo "cd Desktop/VideoCaptioner&&source venv/bin/activate&&python3 main.py" > run.command
chmod 755 run.command

然后整个安装就大工告成了。需要跑 VideoCaptioner 的话，就进入桌面的VideoCaptioner文件夹，然后跑 run.command 就好。
接下来在配置时，记得语音转录要用 whisper-cpp ，然后下载其large-v2的模型，英语视频的用large-v3-turbo的比较快。
Whisper-CPP 纵有一些毛病，但速度还是不错的，更难得的是它可以在 Intel Mac 跑，也可以在 M1 Mac 上面跑。

[chenjun12138]

苹果m4，卡98%，谢谢大哥的教程。还是用接口吧

[philpw99]

苹果m4，卡98%，谢谢大哥的教程。还是用接口吧

终于有大哥帮忙打包了 M1 的苹果包，而我的分支也解决了WhisperCPP半途死机的问题，可以下载来看看如何：
https://github.com/philpw99/VideoCaptioner/releases/tag/v1.2.0_3.5.2_M1_Mac

[imanuelwang]

请问这个包怎么用，能详细说一下吗

[Jiang00]

哈喽大佬，我的运行报着个错咋搞呀
m4芯片
momo@Mac ~ % /Users/momo/VideoCaptioner/run.command ; exit;

📢 Tips: QFluentWidgets Pro is now released. Click https://qfluentwidgets.com/pages/pro to learn more about it.

Traceback (most recent call last):
File "/Users/momo/VideoCaptioner/main.py", line 35, in
from app.view.main_window import MainWindow
File "/Users/momo/VideoCaptioner/app/view/main_window.py", line 20, in
from app.view.batch_process_interface import BatchProcessInterface
File "/Users/momo/VideoCaptioner/app/view/batch_process_interface.py", line 30, in
from app.thread.batch_process_thread import (
...<3 lines>...
)
File "/Users/momo/VideoCaptioner/app/thread/batch_process_thread.py", line 17, in
from app.thread.transcript_thread import TranscriptThread
File "/Users/momo/VideoCaptioner/app/thread/transcript_thread.py", line 8, in
from app.core.bk_asr import transcribe
File "/Users/momo/VideoCaptioner/app/core/bk_asr/init.py", line 1, in
from .bcut import BcutASR
File "/Users/momo/VideoCaptioner/app/core/bk_asr/bcut.py", line 10, in
from .base import BaseASR
File "/Users/momo/VideoCaptioner/app/core/bk_asr/base.py", line 9, in
from app.core.storage.cache_manager import CacheManager
File "/Users/momo/VideoCaptioner/app/core/storage/init.py", line 2, in
from .cache_manager import CacheManager
File "/Users/momo/VideoCaptioner/app/core/storage/cache_manager.py", line 7, in
from sqlalchemy import and_
ModuleNotFoundError: No module named 'sqlalchemy'

[chenjun12138]

缺sqlalchemy，估计是作者写漏了，pip3 install一下就行，这些报错随便丢给大模型他就会告诉你怎么做

[philpw99]

看来确实只是少装了个 sqlalchemy 而已，一个 pip3 install sqlalchemy 就搞定了。

[change3799]

提示错误 无法将“VideoCaptionerV3.5.2_M1_Mac.7z”解压缩到
。
（错误-1-无此进程。）

[philpw99]

提示错误 无法将“VideoCaptionerV3.5.2_M1_Mac.7z”解压缩到

咦？是没有安装7zip而导致的吗？

[inkkex]

看完了本楼还是会卡98%,似乎不止是没有sqlalchemy的问题

[philpw99]

卡98%是另外的一个问题，要解决这个就只能用我的分支了。

https://github.com/philpw99/VideoCaptioner/wiki/%E5%9C%A8-MacOS-%E9%87%8C%E5%AE%89%E8%A3%85-VideoCaptioner

[Zijinn]

我似乎无法运行成功，会出现：% pip3 install -r requirements.txt  

Collecting aria2 (from -r requirements.txt (line 1))

  Downloading aria2-0.0.1b0.tar.gz (37 kB)

  Installing build dependencies ... done

  Getting requirements to build wheel ... done

  Preparing metadata (pyproject.toml) ... error

  error: subprocess-exited-with-error

  
  × Preparing metadata (pyproject.toml) did not run successfully.

  │ exit code: 1

  ╰─> [23 lines of output]

      Traceback (most recent call last):

        File "/Users/zijin/Desktop/VideoCaptioner/venv/lib/python3.13/site-packages/pip/_vendor/pyproject_hooks/_in_process/_in_process.py", line 389, in

          main()

          ~~~~^^

        File "/Users/zijin/Desktop/VideoCaptioner/venv/lib/python3.13/site-packages/pip/_vendor/pyproject_hooks/_in_process/_in_process.py", line 373, in main

          json_out["return_val"] = hook(**hook_input["kwargs"])

                                   ~~~~^^^^^^^^^^^^^^^^^^^^^^^^

        File "/Users/zijin/Desktop/VideoCaptioner/venv/lib/python3.13/site-packages/pip/_vendor/pyproject_hooks/_in_process/_in_process.py", line 178, in prepare_metadata_for_build_wheel

          whl_basename = backend.build_wheel(metadata_directory, config_settings)

        File "/private/var/folders/my/3snjp63s11qg1lvxd4dbv6yr0000gn/T/pip-build-env-vytm2unk/overlay/lib/python3.13/site-packages/hatchling/build.py", line 58, in build_wheel

          return os.path.basename(next(builder.build(directory=wheel_directory, versions=['standard'])))

                                  ~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

        File "/private/var/folders/my/3snjp63s11qg1lvxd4dbv6yr0000gn/T/pip-build-env-vytm2unk/overlay/lib/python3.13/site-packages/hatchling/builders/plugin/interface.py", line 147, in build

          build_hook.initialize(version, build_data)

          ~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^

        File "/private/var/folders/my/3snjp63s11qg1lvxd4dbv6yr0000gn/T/pip-install-rtwojqff/aria2_b12ebe6c63024408a46f59606db5a62b/hatch_build.py", line 132, in initialize

          aria2_tag = get_tag_4_build()

        File "/private/var/folders/my/3snjp63s11qg1lvxd4dbv6yr0000gn/T/pip-install-rtwojqff/aria2_b12ebe6c63024408a46f59606db5a62b/hatch_build.py", line 110, in get_tag_4_build

          raise RuntimeError(msg)

      RuntimeError: Can't find tag for build.

      Please set 'WHL_PLATFORM' env var or run this building on supported platform.

          supported platform: manylinux_2_17_x86_64, musllinux_1_1_x86_64, manylinux_2_17_aarch64, musllinux_1_1_aarch64, win_amd64, win32

    
      [end of output]

 
  note: This error originates from a subprocess, and is likely not a problem with pip.

error: metadata-generation-failed

× Encountered error while generating package metadata.

╰─> See above for output.

note: This is an issue with the package mentioned above, not pip.

hint: See above for details.

[Zijinn]

请问有没有便捷的安转包，谢谢了!

[philpw99]

不好意思，之前是有个大佬说他自己有个包完全修正了WhisperCpp的问题的，他叫TensorP7还是什么的，记不清了。
如果找到我会回来汇报一下。

Aria2 不是用python的pip来安装的，而是用homebrew，再认真看看我的教程吧。
如果requirements.txt 里面有aria2，那就把那一行删掉。
还有，python 3.12的兼容性比较高，如果安装其它插件出问题，那最好还是把python 3.13删掉，装回3.12

[Zijinn]

是的，我后面删掉了requirements.txt 里面的aria2，后续还是无法运行，我看一下是哪里出错了。感谢您！

[TivFun]

我之前也遇到了aria2的错误，我看了一下，是需要aria2安装别的一些内容好像，然后我用 brew install aria2 安装了它，然后再运行启动命令就可以正常工作了

[philpw99]

找到啦！试试用TensorP7大哥的Mac专用版看看怎么样：
https://github.com/TensorP7/VideoCaptioneronMac

[Zijinn]

太感谢大哥了！万分感谢！