CasTTY安装与配置指南

1. 项目基础介绍

CasTTY是一个开源命令行工具，用于录制带有音频的终端屏幕录像，并将其发布到网页上。它类似于ttyrec和asciinema，但增加了音频录制功能。该项目主要用于将终端会话录制为可分享的格式，允许用户在网页上查看和听录制的音频。CasTTY的主要编程语言是C，同时也使用了一些JavaScript、HTML和Makefile等。

2. 项目使用的关键技术和框架

• libsoundio: 用于音频输入输出的库。
• LAME (libmp3lame): 用于实时MP3编码。
• asciicast v1格式: 输出格式，与asciinema播放器兼容。
• xterm.js: 用于网页上的终端模拟。
• jQuery和rangeslider.js: 用于Web界面中的用户交互。

3. 安装和配置准备工作

在安装CasTTY之前，你需要确保你的系统已经安装了以下依赖项：

• GCC或Clang编译器
• Make工具
• libsoundio库
• LAME库（如果需要MP3编码）

以下步骤适用于大多数Linux发行版，macOS用户可能需要使用Homebrew安装依赖项。

安装依赖项

对于基于Debian的系统（如Ubuntu），你可以使用以下命令安装编译器和make工具：

sudo apt-get update
sudo apt-get install build-essential

接下来，安装libsoundio。某些系统可能已经包含了该库，如果没有，你可以从源代码编译安装：

git clone https://github.com/ppy/libsoundio.git
cd libsoundio
mkdir build && cd build
cmake ..
make
sudo make install

对于LAME库，你可以这样安装：

sudo apt-get install libmp3lame-dev

安装步骤

1. 克隆项目到本地：

git clone https://github.com/dhobsd/castty.git
cd castty

2. 编辑config.mk文件，确保WITH_LAME设置为yes，如果你需要MP3支持。

3. 编译项目：

make

如果一切顺利，编译完成后你将在src目录下找到castty可执行文件。

配置指南

• 使用castty record -l命令列出可用的音频输入设备。
• 选择一个音频输入设备，并使用castty record -d '<设备名称>' -a <音频输出文件>开始录制。
• 使用-e '<命令>'参数可以指定录制会话开始时执行的命令。
• 录制完成后，你可以使用sox工具将PCM音频文件转换为其他格式，例如：

sox -D -r 44100 -e signed -b 16 -c 2 -L audio.raw audio.wav

以上步骤就是安装和配置CasTTY的基本流程。请确保在每一步操作中都仔细检查任何错误信息，并根据需要解决可能出现的问题。