From ed215ef21b49e794715172e65d6703de04f6b95d Mon Sep 17 00:00:00 2001 From: sayo Date: Sun, 16 Aug 2026 11:43:26 -0400 Subject: new path --- docs/applications/multimedia/obs_studio.md | 121 +++++++++++++++++++++++++++++ 1 file changed, 121 insertions(+) create mode 100644 docs/applications/multimedia/obs_studio.md (limited to 'docs/applications/multimedia') diff --git a/docs/applications/multimedia/obs_studio.md b/docs/applications/multimedia/obs_studio.md new file mode 100644 index 0000000..a1b6ecc --- /dev/null +++ b/docs/applications/multimedia/obs_studio.md @@ -0,0 +1,121 @@ +# OBS Studio + +![Markdown Logo](https://obsproject.com/assets/images/new_icon_small-r.png) + +全称:Open Broadcaster Software,开源广播软件(直译) + +## 概述 + +OBS Studio 同时是一款视频录制器和一款推流器。它还有“合成器”的功能,允许将多个输入源合并到同一个输出中——然后发送到视频流服务器或保存为文件。 + +OBS Studio 完全免费,灵活可定制,还有庞大的插件库和社区支持。 + +## 安装 +可以通过 Flatpak 和 Snap 安装 OBS Stuio,也可以通过包管理器直接安装 OBS Studio。 + +???+ info "注意" + 应该先在应用商店(如果有的话)里搜一下 ``OBS Studio``。如果搜到了,最安全的方法是安装应用商店里的那个,因为通常来说发行版会管理好一切,开箱即用。 + +### Flatpak(推荐) +```bash +flatpak install com.obsproject.Studio +``` + +### Snap(在 Ubuntu 下推荐) +```bash +sudo snap install obs-studio +``` + +### 包管理器 +- Debian系: + ```bash + sudo apt install obs-studio + ``` +- Redhat系: + ```bash + sudo yum install 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 使用包管理器安装,安装 ``ffmpeg`` 。 +```bash +sudo apt install ffmpeg +# 或 +sudo yum install ffmpeg +``` +您可能需要重启电脑。 + +如果 OBS Studio 使用 Flatpak 或 Snap 安装,不用任何操作,依赖已经被管理好了。 + +???- info "可是我看不到硬件加速的选项耶?" + 把输出模式改成 **高级** ,在 **直播** 和 **录像** 的视频编码器里选择 **"FFmpeg VAAPI"** 开头的选项。 + +### Wayland 下的快捷键 + + + +如果 OBS Studio 使用 Flatpak 安装,安装 ``com.obsproject.Studio.Plugin.WaylandHotkeys`` 。 + +```bash +flatpak install com.obsproject.Studio.Plugin.WaylandHotkeys +``` + +安装完成后启动 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 没有“中文官网”!** \ No newline at end of file -- cgit v1.3 From 6ef06dcb9919b7e6d3200ca2b6a3b4504256453d Mon Sep 17 00:00:00 2001 From: sayo Date: Sun, 16 Aug 2026 11:46:45 -0400 Subject: fixed syntax --- docs/applications/multimedia/obs_studio.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'docs/applications/multimedia') diff --git a/docs/applications/multimedia/obs_studio.md b/docs/applications/multimedia/obs_studio.md index a1b6ecc..2fed765 100644 --- a/docs/applications/multimedia/obs_studio.md +++ b/docs/applications/multimedia/obs_studio.md @@ -59,7 +59,7 @@ OBS Studio 默认输出 1080p ,(视您的硬件)最高 6000 kbps 的视频 前往 **设置**,左侧栏目的 **快捷键**,点击项目后的输入框,在键盘和/或鼠标(是的,可以绑定鼠标侧键)按下你想要设置的键。 ???+ note "不工作?" - 如果快捷键在 OBS 窗口外不工作,很有可能您使用 Wayland 显示服务器。OBS 无法在后台访问键盘,这是 Wayland 为了安全而作出的限制。有利用 Wayland 原生接口的插件,参阅 [**Wayland 下的快捷键**](.#wayland) 章节。 + 如果快捷键在 OBS 窗口外不工作,很有可能您使用 Wayland 显示服务器。OBS 无法在后台访问键盘,这是 Wayland 为了安全而作出的限制。有利用 Wayland 原生接口的插件,参阅 [**Wayland 下的快捷键**](#wayland) 章节。 ## 使用 -- cgit v1.3 From 6fa089fb322a280d17012c4daa3ac7ab907cce9f Mon Sep 17 00:00:00 2001 From: sayo Date: Sun, 16 Aug 2026 11:57:54 -0400 Subject: flatpak link & more --- docs/applications/multimedia/obs_studio.md | 17 +++++++++-------- 1 file changed, 9 insertions(+), 8 deletions(-) (limited to 'docs/applications/multimedia') diff --git a/docs/applications/multimedia/obs_studio.md b/docs/applications/multimedia/obs_studio.md index 2fed765..168f419 100644 --- a/docs/applications/multimedia/obs_studio.md +++ b/docs/applications/multimedia/obs_studio.md @@ -1,4 +1,5 @@ # OBS Studio + ![Markdown Logo](https://obsproject.com/assets/images/new_icon_small-r.png) @@ -11,17 +12,17 @@ OBS Studio 同时是一款视频录制器和一款推流器。它还有“合成 OBS Studio 完全免费,灵活可定制,还有庞大的插件库和社区支持。 ## 安装 -可以通过 Flatpak 和 Snap 安装 OBS Stuio,也可以通过包管理器直接安装 OBS Studio。 +可以通过 [Flatpak](../../concepts/package_managers/flatpak.md) 和 Snap 安装 OBS Stuio,也可以通过传统包管理器直接安装 OBS Studio。 -???+ info "注意" - 应该先在应用商店(如果有的话)里搜一下 ``OBS Studio``。如果搜到了,最安全的方法是安装应用商店里的那个,因为通常来说发行版会管理好一切,开箱即用。 +???+ note "一键安装..." + 在应用商店(如果有的话)里搜一下 ``OBS Studio``。如果搜到了,最安全的方法是安装应用商店里的那个,因为通常来说发行版会管理好一切,开箱即用。 ### Flatpak(推荐) ```bash flatpak install com.obsproject.Studio ``` -### Snap(在 Ubuntu 下推荐) +### Snap ```bash sudo snap install obs-studio ``` @@ -63,9 +64,9 @@ OBS Studio 默认输出 1080p ,(视您的硬件)最高 6000 kbps 的视频 ## 使用 -点击**开始录制**或**开始直播**,在完成后点击**停止录制**或**停止直播**。 +点击 **开始录制** 或 **开始直播** ,在完成后点击** 停止录制** 或 **停止直播** 。 -如想暂停录制,点击 **停止录制** *旁边* 的暂停键以暂停。再点一下以继续录制,或点击**停止录制**来结束。 +如想暂停录制,点击 **停止录制** *旁边* 的暂停键以暂停。再点一下以继续录制,或点击** 停止录制** 来结束。 ## 高级 @@ -74,7 +75,7 @@ OBS Studio 默认输出 1080p ,(视您的硬件)最高 6000 kbps 的视频 -如果 OBS Studio 使用包管理器安装,安装 ``ffmpeg`` 。 +如果 OBS Studio 使用传统包管理器安装,安装 ``ffmpeg`` 。 ```bash sudo apt install ffmpeg # 或 @@ -111,7 +112,7 @@ flatpak install com.obsproject.Studio.Plugin.WaylandHotkeys 打开系统设置,导航至 **键盘** - **快捷键**,在列表里选择 **OBS Studio** 。 - + ## 关于更多 -- cgit v1.3 From a1b6f4b3825ca9aff69cdc7d5f88a5ec6657e724 Mon Sep 17 00:00:00 2001 From: sayo Date: Mon, 17 Aug 2026 04:52:46 -0400 Subject: fixed admonitions --- docs/applications/multimedia/obs_studio.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'docs/applications/multimedia') diff --git a/docs/applications/multimedia/obs_studio.md b/docs/applications/multimedia/obs_studio.md index 168f419..d9248be 100644 --- a/docs/applications/multimedia/obs_studio.md +++ b/docs/applications/multimedia/obs_studio.md @@ -85,7 +85,7 @@ sudo yum install ffmpeg 如果 OBS Studio 使用 Flatpak 或 Snap 安装,不用任何操作,依赖已经被管理好了。 -???- info "可是我看不到硬件加速的选项耶?" +??? info "可是我看不到硬件加速的选项耶?" 把输出模式改成 **高级** ,在 **直播** 和 **录像** 的视频编码器里选择 **"FFmpeg VAAPI"** 开头的选项。 ### Wayland 下的快捷键 -- cgit v1.3 From 8c510d8c54fa999377e072cadde3608c6bbe11af Mon Sep 17 00:00:00 2001 From: sayo Date: Mon, 17 Aug 2026 05:18:15 -0400 Subject: fixed format --- docs/applications/multimedia/obs_studio.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) (limited to 'docs/applications/multimedia') diff --git a/docs/applications/multimedia/obs_studio.md b/docs/applications/multimedia/obs_studio.md index d9248be..2227f92 100644 --- a/docs/applications/multimedia/obs_studio.md +++ b/docs/applications/multimedia/obs_studio.md @@ -85,7 +85,7 @@ sudo yum install ffmpeg 如果 OBS Studio 使用 Flatpak 或 Snap 安装,不用任何操作,依赖已经被管理好了。 -??? info "可是我看不到硬件加速的选项耶?" +??? question "可是我看不到硬件加速的选项耶?" 把输出模式改成 **高级** ,在 **直播** 和 **录像** 的视频编码器里选择 **"FFmpeg VAAPI"** 开头的选项。 ### Wayland 下的快捷键 @@ -119,4 +119,4 @@ flatpak install com.obsproject.Studio.Plugin.WaylandHotkeys - [官方网站](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 没有“中文官网”!** \ No newline at end of file + - [OBS Studio 完全新手指南](https://www.obs.com.cn/post/140.html): ``https://www.obs.com.cn/post/140.html`` ***这不是官网!OBS Studio 没有“中文官网”!** -- cgit v1.3 From 0771d5f844a1bda08a7dadd67d319a0eb277f4bc Mon Sep 17 00:00:00 2001 From: sayo Date: Tue, 18 Aug 2026 19:54:56 -0400 Subject: f__ked nvidia --- docs/applications/multimedia/obs_studio.md | 114 ++++++++++++++++++++++++----- 1 file changed, 94 insertions(+), 20 deletions(-) (limited to 'docs/applications/multimedia') diff --git a/docs/applications/multimedia/obs_studio.md b/docs/applications/multimedia/obs_studio.md index 2227f92..faaa745 100644 --- a/docs/applications/multimedia/obs_studio.md +++ b/docs/applications/multimedia/obs_studio.md @@ -1,5 +1,5 @@ # OBS Studio - + ![Markdown Logo](https://obsproject.com/assets/images/new_icon_small-r.png) @@ -14,10 +14,7 @@ OBS Studio 完全免费,灵活可定制,还有庞大的插件库和社区支 ## 安装 可以通过 [Flatpak](../../concepts/package_managers/flatpak.md) 和 Snap 安装 OBS Stuio,也可以通过传统包管理器直接安装 OBS Studio。 -???+ note "一键安装..." - 在应用商店(如果有的话)里搜一下 ``OBS Studio``。如果搜到了,最安全的方法是安装应用商店里的那个,因为通常来说发行版会管理好一切,开箱即用。 - -### Flatpak(推荐) +### Flatpak(推荐:AMD / Intel) ```bash flatpak install com.obsproject.Studio ``` @@ -27,7 +24,7 @@ flatpak install com.obsproject.Studio sudo snap install obs-studio ``` -### 包管理器 +### 包管理器(推荐:Nvidia) - Debian系: ```bash sudo apt install obs-studio @@ -70,27 +67,101 @@ OBS Studio 默认输出 1080p ,(视您的硬件)最高 6000 kbps 的视频 ## 高级 -### 硬件加速( AMD / Intel ) +### 硬件加速 ( AMD / Intel ) - +如果 OBS Studio 使用 Flatpak 或 Snap 安装,不用任何操作,依赖已经被管理好了。 如果 OBS Studio 使用传统包管理器安装,安装 ``ffmpeg`` 。 -```bash -sudo apt install ffmpeg -# 或 -sudo yum install ffmpeg -``` -您可能需要重启电脑。 -如果 OBS Studio 使用 Flatpak 或 Snap 安装,不用任何操作,依赖已经被管理好了。 +- 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,去你妈的。* +

——Linus Torvalds

+ +#### 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 都可用。 + +##### 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/)。 + + + +#### nouveau + +从 GeForce 8系( 8600 GT, 8800 GTX 等)到 **开普勒架构**的 GeForce 7系( 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 下的快捷键 + 如果 OBS Studio 使用 Flatpak 安装,安装 ``com.obsproject.Studio.Plugin.WaylandHotkeys`` 。 @@ -116,7 +187,10 @@ flatpak install com.obsproject.Studio.Plugin.WaylandHotkeys ## 关于更多 -- [官方网站](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 没有“中文官网”!** +- [官方网站](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 -- cgit v1.3 From a541df168696535251191e0a9b31a3fefb56bdef Mon Sep 17 00:00:00 2001 From: sayo Date: Tue, 18 Aug 2026 20:00:34 -0400 Subject: 什么年代了还在用传统包管理器 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/applications/multimedia/obs_studio.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'docs/applications/multimedia') diff --git a/docs/applications/multimedia/obs_studio.md b/docs/applications/multimedia/obs_studio.md index faaa745..d5b2c30 100644 --- a/docs/applications/multimedia/obs_studio.md +++ b/docs/applications/multimedia/obs_studio.md @@ -24,7 +24,7 @@ flatpak install com.obsproject.Studio sudo snap install obs-studio ``` -### 包管理器(推荐:Nvidia) +### 传统包管理器(推荐:Nvidia) - Debian系: ```bash sudo apt install obs-studio -- cgit v1.3 From 83af221a857ac5b79b5215be953adc9f05280bab Mon Sep 17 00:00:00 2001 From: sayo Date: Wed, 19 Aug 2026 06:36:14 -0400 Subject: flatpak hyperlink fix --- docs/applications/multimedia/obs_studio.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'docs/applications/multimedia') diff --git a/docs/applications/multimedia/obs_studio.md b/docs/applications/multimedia/obs_studio.md index d5b2c30..587f540 100644 --- a/docs/applications/multimedia/obs_studio.md +++ b/docs/applications/multimedia/obs_studio.md @@ -12,7 +12,7 @@ OBS Studio 同时是一款视频录制器和一款推流器。它还有“合成 OBS Studio 完全免费,灵活可定制,还有庞大的插件库和社区支持。 ## 安装 -可以通过 [Flatpak](../../concepts/package_managers/flatpak.md) 和 Snap 安装 OBS Stuio,也可以通过传统包管理器直接安装 OBS Studio。 +可以通过 [Flatpak](../apps.md#flatpak) 和 Snap 安装 OBS Stuio,也可以通过传统包管理器直接安装 OBS Studio。 ### Flatpak(推荐:AMD / Intel) ```bash -- cgit v1.3 From b9261788e5231a4b9d116fcac42566de1c26d396 Mon Sep 17 00:00:00 2001 From: sayo Date: Thu, 20 Aug 2026 00:43:36 -0400 Subject: added info on recent ffmpeg update breaking nvidia pascal & obs-wayland-hotkeys on bare-metal --- docs/applications/multimedia/obs_studio.md | 44 ++++++++++++++++++++++++++---- 1 file changed, 39 insertions(+), 5 deletions(-) (limited to 'docs/applications/multimedia') diff --git a/docs/applications/multimedia/obs_studio.md b/docs/applications/multimedia/obs_studio.md index 587f540..3a73f2a 100644 --- a/docs/applications/multimedia/obs_studio.md +++ b/docs/applications/multimedia/obs_studio.md @@ -91,7 +91,7 @@ OBS Studio 默认输出 1080p ,(视您的硬件)最高 6000 kbps 的视频 #### Nvidia 专有驱动 -!!! warning "专有软件(非自由软件)" +??? warning "专有软件(非自由软件)" Nvidia 专有驱动(`nvidia`)是[专有软件](https://www.gnu.org/proprietary/proprietary.html)。 ##### 传统包管理器 @@ -106,6 +106,12 @@ OBS Studio 默认输出 1080p ,(视您的硬件)最高 6000 kbps 的视频 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 专有驱动。这样的话,安装以下包裹: @@ -123,7 +129,7 @@ flatpak install org.freedesktop.Platform.VAAPI.nvidia 还需要安装 [从Nvidia驱动中提取的固件](https://nouveau.freedesktop.org/VideoAcceleration.html#firmware)。 -!!! warning "专有软件(非自由软件)" +??? warning "专有软件(非自由软件)" 上述“从Nvidia驱动中提取的固件”是[专有软件](https://www.gnu.org/proprietary/proprietary.html)。如果您的目标是完全自由的软件,nouveau目前还做不到。您可以考虑使用集成显卡进行硬件加速。 ???- info "安装过程..." @@ -160,8 +166,7 @@ flatpak install org.freedesktop.Platform.VAAPI.nvidia ### Wayland 下的快捷键 - - +#### Flatpak 如果 OBS Studio 使用 Flatpak 安装,安装 ``com.obsproject.Studio.Plugin.WaylandHotkeys`` 。 @@ -183,7 +188,36 @@ flatpak install com.obsproject.Studio.Plugin.WaylandHotkeys 打开系统设置,导航至 **键盘** - **快捷键**,在列表里选择 **OBS Studio** 。 - +#### 传统包管理器 + +##### 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 +``` + +##### Fedora + +启用第三方的 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)。 ## 关于更多 -- cgit v1.3 From 98076c5a1dc46d52f6c08c8343923d7b9fbfd6b7 Mon Sep 17 00:00:00 2001 From: sayo Date: Thu, 20 Aug 2026 03:00:32 -0400 Subject: instructions on manually compiling wayland hotkey plugin --- docs/applications/multimedia/obs_studio.md | 135 +++++++++++++++++++---------- 1 file changed, 87 insertions(+), 48 deletions(-) (limited to 'docs/applications/multimedia') 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 - + -![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` - - **安装固件** - - 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** 可以跳过。 + ##### 安装 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`` 。 @@ -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 源,安装 `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 "手动编译的方法" + + + ###### 安装编译时依赖 + - 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 -- cgit v1.3 From 882cd84ca5137c4ffbd47b3a77295184dacb21c5 Mon Sep 17 00:00:00 2001 From: sayo Date: Thu, 20 Aug 2026 03:11:03 -0400 Subject: fixed words --- docs/applications/multimedia/obs_studio.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) (limited to 'docs/applications/multimedia') diff --git a/docs/applications/multimedia/obs_studio.md b/docs/applications/multimedia/obs_studio.md index 7f30e52..cff91b4 100644 --- a/docs/applications/multimedia/obs_studio.md +++ b/docs/applications/multimedia/obs_studio.md @@ -84,7 +84,7 @@ OBS Studio 默认输出 1080p ,(视您的硬件)最高 6000 kbps 的视频 您可能需要重启电脑。 -??? question "可是我看不到硬件加速的选项耶?" +??? question "可是我看不到硬件加速的选项?" 把输出模式改成 **高级** ,在 **直播** 和 **录像** 的视频编码器里选择 **"FFmpeg VAAPI"** 开头的选项。 ### 硬件加速 ( Nvidia ) @@ -111,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 的其他软件,它们可能也需要跟着一起降级。通常您的包管理器会提醒您所有要降级的软件。 @@ -126,7 +126,7 @@ flatpak install org.freedesktop.Platform.VAAPI.nvidia 现在只有 VA-API 和 VDPAU 可用。要使用 NVDEC 和 NVENC,[安装 CUDA 工具包](https://docs.nvidia.com/cuda/cuda-installation-guide-linux/)。 - + #### nouveau -- cgit v1.3 From dc11db8feadae3e281f9f46fde2e06840790445c Mon Sep 17 00:00:00 2001 From: sayo Date: Thu, 20 Aug 2026 04:59:09 -0400 Subject: assuming 'EL10' is RHEL 10 --- docs/applications/multimedia/obs_studio.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) (limited to 'docs/applications/multimedia') diff --git a/docs/applications/multimedia/obs_studio.md b/docs/applications/multimedia/obs_studio.md index cff91b4..b05ac2c 100644 --- a/docs/applications/multimedia/obs_studio.md +++ b/docs/applications/multimedia/obs_studio.md @@ -197,9 +197,8 @@ cd rm -rf /tmp/obs-wayland-hotkeys-git ``` -##### Fedora +##### RedHat 系( RHEL 除外 ) - 启用第三方的 COPR 源,安装 `obs-studio-plugin-wayland-hotkeys`。 在终端运行: -- cgit v1.3 From 6c2eb39c1588ecf8059ec207b124a95ad2f5b64c Mon Sep 17 00:00:00 2001 From: sayo Date: Thu, 20 Aug 2026 17:26:09 -0400 Subject: fixed rhel + bug on kde debian --- docs/applications/multimedia/obs_studio.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) (limited to 'docs/applications/multimedia') diff --git a/docs/applications/multimedia/obs_studio.md b/docs/applications/multimedia/obs_studio.md index b05ac2c..785d5ce 100644 --- a/docs/applications/multimedia/obs_studio.md +++ b/docs/applications/multimedia/obs_studio.md @@ -197,7 +197,7 @@ cd rm -rf /tmp/obs-wayland-hotkeys-git ``` -##### RedHat 系( RHEL 除外 ) +##### RedHat 系 启用第三方的 COPR 源,安装 `obs-studio-plugin-wayland-hotkeys`。 @@ -243,7 +243,7 @@ sudo dnf install obs-studio-plugin-wayland-hotkeys #### 使用 -安装完成后启动 OBS Studio,您应该会看到一个设置快捷键的弹窗。 +安装完成后启动 OBS Studio,您应该会看到一个设置快捷键的弹窗。如果没有,可能需要注销后重新登录。 !!! info "注意" OBS 内置的快捷键设置没有效果,应该去系统设置里更改快捷键。 @@ -265,4 +265,4 @@ sudo dnf install obs-studio-plugin-wayland-hotkeys - 社区文档: - [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 + - [Linux CUDA 安装教程](https://docs.nvidia.com/cuda/cuda-installation-guide-linux/): `https://docs.nvidia.com/cuda/cuda-installation-guide-linux/` -- cgit v1.3