aboutsummaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorsayo <rg32@ciallo.tech>2026-08-20 07:00:32 +0000
committersayo <rg32@ciallo.tech>2026-08-20 07:00:32 +0000
commit98076c5a1dc46d52f6c08c8343923d7b9fbfd6b7 (patch)
treedbc09ad9ecd3e4771eb1f3cbb95a374b8ea5c404 /docs
parentadded info on recent ffmpeg update breaking nvidia pascal & obs-wayland-hotkeys on bare-metal (diff)
instructions on manually compiling wayland hotkey plugin
Diffstat (limited to 'docs')
-rw-r--r--docs/applications/multimedia/obs_studio.md131
1 files changed, 85 insertions, 46 deletions
diff --git a/docs/applications/multimedia/obs_studio.md b/docs/applications/multimedia/obs_studio.md
index 3a73f2a..7f30e52 100644
--- a/docs/applications/multimedia/obs_studio.md
+++ b/docs/applications/multimedia/obs_studio.md
@@ -1,7 +1,7 @@
# OBS Studio
-<!-- TODO: L118, L164, L186 -->
+<!-- TODO: L203, L217 -->
-![Markdown Logo](https://obsproject.com/assets/images/new_icon_small-r.png)
+![obslogo](https://obsproject.com/assets/images/new_icon_small-r.png)
全称:Open Broadcaster Software,开源广播软件(直译)
@@ -25,15 +25,20 @@ sudo snap install obs-studio
```
### 传统包管理器(推荐:Nvidia)
-- Debian系:
+- Debian 系:
```bash
sudo apt install obs-studio
```
-- Redhat系:
+- Redhat 系:
```bash
sudo yum install obs-studio
```
+- Arch 系:
+ ```bash
+ sudo pacman -S obs-studio
+ ```
+
## 配置
### 录制屏幕
@@ -106,7 +111,7 @@ OBS Studio 默认输出 1080p ,(视您的硬件)最高 6000 kbps 的视频
VA-API, VDPAU 和 高性能的 NVDEC, NVENC 都可用。
-??? warning "不给 Nvidia 交钱(买新显卡)?活该失去支持。"
+??? warning "如果您的 Nvidia 显卡较老..."
我们了解到一些发行版中最新的 FFmpeg 基于新版本的 NVENC API 头文件构建,如果你使用 **帕斯卡架构**( Geforce **10系** )及更老的 Nvidia 显卡,发现无法使用 NVENC,您可能需要降级 FFmpeg。
如果电脑上有使用 FFmpeg 的其他软件,它们可能也需要跟着一起降级。通常您的包管理器会提醒您所有要降级的软件。
@@ -133,39 +138,41 @@ flatpak install org.freedesktop.Platform.VAAPI.nvidia
上述“从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`
+ ##### 安装 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`
+ ##### 安装固件
+ - 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/
+ ```
- 如果您使用 Flatpak 安装 OBS Studio,第三步 **安装 FFmpeg** 可以跳过。
+ ##### 安装 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`` 。
@@ -174,20 +181,6 @@ flatpak install org.freedesktop.Platform.VAAPI.nvidia
flatpak install com.obsproject.Studio.Plugin.WaylandHotkeys
```
-安装完成后启动 OBS Studio,您应该会看到一个设置快捷键的弹窗。
-
-!!! info "注意"
- OBS 内置的快捷键设置没有效果,应该去系统设置里更改快捷键。
-
-???+ note "添加,更改,移除快捷键"
- **GNOME**
-
- 打开系统设置,导航至 **应用程序** - **OBS Studio** ,点击 **全局快捷键** 。
-
- **KDE Plasma**
-
- 打开系统设置,导航至 **键盘** - **快捷键**,在列表里选择 **OBS Studio** 。
-
#### 传统包管理器
##### Arch 系
@@ -206,6 +199,7 @@ rm -rf /tmp/obs-wayland-hotkeys-git
##### Fedora
+<!-- 我不知道 copr 只能用于fedora,还是可以用于“redhat 系”。请审稿者修改这里 -->
启用第三方的 COPR 源,安装 `obs-studio-plugin-wayland-hotkeys`。
在终端运行:
@@ -219,12 +213,57 @@ 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/` \ No newline at end of file