LiveCaptions 项目下载及安装教程

1. 项目介绍

LiveCaptions 是一个为 Linux 桌面环境提供的实时字幕应用程序。它能够为桌面或麦克风音频提供实时字幕，且音频数据不会被发送到任何外部服务。该应用程序不依赖于任何专有服务或库，用户可以调整字体、字体大小和文本大小写，并支持基于 token 级别的置信度文本淡化功能。

2. 项目下载位置

要下载 LiveCaptions 项目，请使用以下命令进行递归克隆：

git clone --recursive https://github.com/abb128/LiveCaptions.git

如果忘记使用 --recursive 选项，可以通过以下命令初始化子模块：

git submodule update --init --recursive

3. 项目安装环境配置

3.1 系统要求

LiveCaptions 项目需要以下依赖项：

• pulseaudio
• libadwaita
• meson
• ninja

3.2 配置 ONNXRuntime

3.2.1 Linux 系统

首先，下载 ONNXRuntime v1.14.1 (Linux)，并将其解压到某个目录。然后设置环境变量以指向 ONNXRuntime：

export ONNX_ROOT=/path/to/onnxruntime-linux-x64-1.14.1/
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/path/to/onnxruntime-linux-x64-1.14.1/lib

3.2.2 macOS 系统

下载 ONNXRuntime v1.14.1 (Mac OS x86)，并将其解压到某个目录。然后设置环境变量并复制库文件：

export ONNX_ROOT=/path/to/onnxruntime-osx-x86_64-1.14.1/
cp /path/to/onnxruntime-osx-x86_64-1.14.1/lib/libonnxruntime.1.14.1.dylib /usr/local/lib/libonnxruntime.1.14.1.dylib
cp /path/to/onnxruntime-osx-x86_64-1.14.1/lib/libonnxruntime.dylib /usr/local/lib/libonnxruntime.dylib

3.3 配置 PulseAudio（仅限 macOS）

在 macOS 上，可能需要运行以下命令以确保 PulseAudio 作为后台服务运行：

brew services restart pulseaudio

要停止服务，请将 restart 替换为 stop。

4. 项目安装方式

4.1 使用 GNOME Builder 安装（简单）

1. 克隆项目后，打开 GNOME Builder。
2. 在 GNOME Builder 中打开项目目录。
3. 如果系统提示下载 SDK，请下载并安装。
4. 点击“播放”按钮以构建并运行项目。

4.2 从终端安装（稍复杂）

1. 设置构建环境：

   meson setup builddir
   meson devenv -C builddir
   

2. 下载模型并设置环境变量：

   wget https://aprilasr.net/april-english-dev-01110_en.april
   export APRIL_MODEL_PATH=`pwd`/april-english-dev-01110_en.april
   

3. 构建并运行应用程序：

   ninja -C builddir
   src/livecaptions
   

5. 项目处理脚本

LiveCaptions 项目的主要处理脚本位于 src/ 目录下。主要的可执行文件是 livecaptions，它负责实时字幕的生成和显示。

5.1 主要脚本

• src/livecaptions: 主应用程序脚本，负责实时字幕的生成和显示。

5.2 配置文件

• meson.build: 构建配置文件，定义了项目的构建规则和依赖项。

5.3 模型文件

• april-english-dev-01110_en.april: 预训练的语音识别模型文件，用于实时字幕的生成。

通过以上步骤，您可以成功下载、配置并安装 LiveCaptions 项目，并开始使用其提供的实时字幕功能。