aboutsummaryrefslogtreecommitdiff
path: root/docs/applications/multimedia/obs_studio.md
blob: c2cb1331ef247bf99b3b47834eab4422d931ae1b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
# OBS Studio
<!-- TODO: L203, L217 -->

![obslogo](https://obsproject.com/assets/images/new_icon_small-r.png)

全称:Open Broadcaster Software,开源广播软件(直译)

## 概述

OBS Studio 同时是一款视频录制器和一款推流器。它还有“合成器”的功能,允许将多个输入源合并到同一个输出中——然后发送到视频流服务器或保存为文件。

OBS Studio 完全免费,灵活可定制,还有庞大的插件库和社区支持。

## 安装
可以通过 [Flatpak](../apps.md#flatpak) 和 Snap 安装 OBS Stuio,也可以通过传统包管理器直接安装 OBS Studio。

### Flatpak(推荐:AMD / Intel)
```bash
flatpak install com.obsproject.Studio
```

### Snap
```bash
sudo snap install obs-studio
```

### 传统包管理器(推荐:Nvidia)
- Debian 系:
    ```bash
    sudo apt install obs-studio
    ```
- Redhat 系:
    ```bash
    sudo yum install obs-studio
    ```

- Arch 系:
    ```bash
    sudo pacman -S obs-studio
    ```

## 配置

### 录制屏幕
在 **来源** 中,点击 **+** 号,选择 **屏幕采集(Pipewire)** ,点击 **OK** 。

???+ info "如果收到了弹窗..."
     桌面管理器可能会问您诸如 “是否允许该应用录制屏幕” 的问题,选择允许。这是安全的,只有 OBS Studio 能看见屏幕上的内容。

现在您应该可以在新弹出的窗口上看到目前屏幕的内容,再点击一次 **OK** 来保存设定。

### 视频质量
OBS Studio 默认输出 1080p ,(视您的硬件)最高 6000 kbps 的视频。

#### 更改输出分辨率
若要更改输出分辨率,点击右下角的 **设置**,在设置的左侧栏目中点击 **视频**,将右侧的 **输出分辨率** 改为想要的值,点击右下角的 **完成**。

#### 更改输出比特率
前往 **设置**,点击左侧栏目的 **输出**,将右侧的 **视频比特率** 改为想要的值,点击右下角的 **完成**。

### 快捷键

前往 **设置**,左侧栏目的 **快捷键**,点击项目后的输入框,在键盘和/或鼠标(是的,可以绑定鼠标侧键)按下你想要设置的键。
???+ note "不工作?"
     如果快捷键在 OBS 窗口外不工作,很有可能您使用 Wayland 显示服务器。OBS 无法在后台访问键盘,这是 Wayland 为了安全而作出的限制。有利用 Wayland 原生接口的插件,参阅 [**Wayland 下的快捷键**](#wayland) 章节。

## 使用

点击 **开始录制** 或 **开始直播** ,在完成后点击** 停止录制** 或 **停止直播** 。

如想暂停录制,点击 **停止录制** *旁边* 的暂停键以暂停。再点一下以继续录制,或点击** 停止录制** 来结束。

## 高级

### 硬件加速( AMD / Intel )

如果 OBS Studio 使用 Flatpak 或 Snap 安装,不用任何操作,依赖已经被管理好了。

如果 OBS Studio 使用传统包管理器安装,安装 ``ffmpeg`` 。

- Debian 系: `sudo apt install ffmpeg`
- RedHat 系: `sudo yum install ffmpeg`
- Arch 系:   `sudo pacman -S ffmpeg`

您可能需要重启电脑。

??? question "可是我看不到硬件加速的选项?"
     把输出模式改成 **高级** ,在 **直播** 和 **录像** 的视频编码器里选择 **"FFmpeg VAAPI"** 开头的选项。

### 硬件加速( Nvidia )

!!! quote "所以 Nvidia ..."
    **So Nvidia, fuck you.**  
    *所以 Nvidia,去你妈的。*  
    <p align="right">——Linus Torvalds</p>

#### Nvidia 专有驱动

??? warning "专有软件(非自由软件)"
    Nvidia 专有驱动(`nvidia`)是[专有软件](https://www.gnu.org/proprietary/proprietary.html)。

##### 传统包管理器

如果 OBS Studio 使用传统包管理器安装,安装 ``ffmpeg`` 。

- Debian 系: `sudo apt install ffmpeg`
- RedHat 系: `sudo yum install ffmpeg`
- Arch 系:   `sudo pacman -S ffmpeg`

您可能需要重启电脑。

VA-API、VDPAU 和 高性能的 NVDEC、NVENC 都可用。

??? warning "如果您的 Nvidia 显卡较旧..."
    我们了解到一些发行版中最新的 FFmpeg 基于新版本的 NVENC API 头文件构建,如果你使用 **帕斯卡架构**( Geforce **10系** )及更老的 Nvidia 显卡,发现无法使用 NVENC,您可能需要降级 FFmpeg。  
    如果电脑上有使用 FFmpeg 的其他软件,它们可能也需要跟着一起降级。通常您的包管理器会提醒您所有要降级的软件。

    [*专有软件常常是恶意软件*](https://www.gnu.org/proprietary/proprietary.html)*。*

##### Flatpak 或 Snap

如果 OBS Studio 使用 Flatpak 或 Snap 安装,不用任何操作,依赖(VA-API)已经被管理好了...除非先安装的 OBS,后安装的 Nvidia 专有驱动。这样的话,安装以下软件包:
```bash
flatpak install org.freedesktop.Platform.VAAPI.nvidia
```

现在只有 VA-API 和 VDPAU 可用。要使用 NVDEC 和 NVENC,[安装 CUDA 工具包](https://docs.nvidia.com/cuda/cuda-installation-guide-linux/)。

<!-- 不写了。我成功跑起来了但是太复杂了,写下来绝对撞j4w: vaapi又不是不能用。 -->

#### nouveau

从 GeForce 8系( 8600 GT、8800 GTX 等)到 **开普勒架构**的 GeForce 700系( GTX 760、GTX 780 等,**GTX 750 和 GTX 750 Ti 不包括在内**),nouveau 支持 VA-API 和 VDPAU 加速。

还需要安装 [从Nvidia驱动中提取的固件](https://nouveau.freedesktop.org/VideoAcceleration.html#firmware)。

??? warning "专有软件(非自由软件)"
    上述“从Nvidia驱动中提取的固件”是[专有软件](https://www.gnu.org/proprietary/proprietary.html)。如果您的目标是完全自由的软件,nouveau目前还做不到。您可以考虑使用集成显卡进行硬件加速。

???- info "安装过程..."
    ##### 安装 mesa 驱动
    - Debian 系: `sudo apt install mesa-va-drivers`  
    - RedHat 系: `sudo yum install mesa-va-drivers`  
    - Arch 系: `sudo pacman -S mesa`  
    - Gentoo Linux: `USE=vaapi sudo -E emerge media-libs/mesa`

    ##### 安装固件
    - Arch 系: `git clone --depth 1 https://aur.archlinux.org/nouveau-fw.git && cd nouveau-fw && makepkg -si`  
    - Gentoo Linux: `sudo emerge sys-firmware/nvidia-firmware`  
    - 其他发行版:
        ```bash
        mkdir /tmp/nouveau
        cd /tmp/nouveau
        wget https://raw.github.com/envytools/firmware/master/extract_firmware.py
        wget http://us.download.nvidia.com/XFree86/Linux-x86/325.15/NVIDIA-Linux-x86-325.15.run
        sh NVIDIA-Linux-x86-325.15.run --extract-only
        python extract_firmware.py
        sudo mkdir /lib/firmware/nouveau
        sudo cp -d nv* vuc-* /lib/firmware/nouveau/
        ```

    ##### 安装 FFmpeg
    - Debian 系: `sudo apt install ffmpeg`  
    - RedHat 系: `sudo yum install ffmpeg`  
    - Arch 系: `sudo pacman -S ffmpeg`  
    - Gentoo Linux: `USE=vaapi sudo -E emerge media-video/ffmpeg`

    *如果您使用 Flatpak 安装 OBS Studio,第三步 **安装 FFmpeg** 可以跳过。*

对于更新的显卡,nouveau **不支持** 硬件加速。

### Wayland 下的快捷键

有[社区插件](https://github.com/leia-uwu/obs-wayland-hotkeys)通过 XDG Desktop Portal 的全局快捷键协议来实现 Wayland 下的快捷键。下文介绍如何安装和使用这个插件。

#### Flatpak

如果 OBS Studio 使用 Flatpak 安装,安装 ``com.obsproject.Studio.Plugin.WaylandHotkeys`` 。

```bash
flatpak install com.obsproject.Studio.Plugin.WaylandHotkeys
```

#### 传统包管理器

##### Arch 系

安装 AUR 上的 `obs-wayland-hoykeys-git`。

在终端以*非 root,有 sudo 权限*的用户运行:
```bash
cd /tmp
git clone --depth 1 https://aur.archlinux.org/obs-wayland-hotkeys-git.git
cd obs-wayland-hotkeys-git
makepkg -si
cd
rm -rf /tmp/obs-wayland-hotkeys-git
```

##### RedHat 系

启用第三方的 COPR 源,安装 `obs-studio-plugin-wayland-hotkeys`。

在终端运行:
```bash
sudo dnf copr enable tarulia/obs-studio-plugins
dnf list --available --repo=copr:copr.fedorainfracloud.org:tarulia:obs-studio-plugins
sudo dnf install obs-studio-plugin-wayland-hotkeys
```

##### 其他发行版

您可能需要[手动编译这个插件](https://github.com/leia-uwu/obs-wayland-hotkeys#compiling-it-yourself)。

??? info "手动编译的方法"

    <!-- need help on ubuntu, zorin etc.-->
    ###### 安装编译时依赖
    - Debian
    
        - 安装 `cmake`、`libobs-dev`、`qt6-base-dev`、`qt6-base-private-dev`、`qt6-svg-dev`、`qt6-wayland-dev`。
        ```bash
        sudo apt install cmake libobs-dev qt6-base-dev qt6-base-private-dev qt6-svg-dev qt6-wayland-dev
        ```

    ###### 下载源代码
    ```bash
    git clone https://github.com/leia-uwu/obs-wayland-hotkeys
    cd obs-wayland-hotkeys
    ```

    ###### 编译
    ```bash
    cmake --preset ubuntu-x86_64
    cmake --build build_x86_64
    ```

    ###### 安装
    ```bash
    mkdir -p ~/.config/obs-studio/plugins/obs-wayland-hotkeys/bin/64bit/
    cp build_x86_64/obs-wayland-hotkeys.so ~/.config/obs-studio/plugins/obs-wayland-hotkeys/bin/64bit/obs-wayland-hotkeys.so
    ```

#### 使用

安装完成后启动 OBS Studio,您应该会看到一个设置快捷键的弹窗。如果没有,可能需要注销后重新登录。

!!! info "注意"
    OBS 内置的快捷键设置没有效果,应该去系统设置里更改快捷键。

???+ note "添加,更改,移除快捷键"
     **GNOME**

     打开系统设置,导航至 **应用程序** - **OBS Studio** ,点击 **全局快捷键** 。

     **KDE Plasma**

     打开系统设置,导航至 **键盘** - **快捷键**,在列表里选择 **OBS Studio** 。


## 关于更多

- [官方网站](https://obsproject.com/): `https://obsproject.com/`
- [官方文档](https://docs.obsproject.com/): `https://docs.obsproject.com/`
- 社区文档:
    - [OBS Studio 完全新手指南](https://www.obs.com.cn/post/140.html): `https://www.obs.com.cn/post/140.html`    ***这不是官网!OBS Studio 没有“中文官网”!**
- Nvidia:
    - [Linux CUDA 安装教程](https://docs.nvidia.com/cuda/cuda-installation-guide-linux/): `https://docs.nvidia.com/cuda/cuda-installation-guide-linux/`