From dd8e4cf471574937ca9fe4dcbaf7bd26893d6996 Mon Sep 17 00:00:00 2001 From: 42-good <182339984+42-good@users.noreply.github.com> Date: Fri, 14 Aug 2026 16:22:38 +0800 Subject: docs: 完成了关于git的介绍 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/applications/git.md | 90 +++++++++++++++++++----------------------------- 1 file changed, 35 insertions(+), 55 deletions(-) (limited to 'docs/applications') diff --git a/docs/applications/git.md b/docs/applications/git.md index ad481a6..1e0cf67 100644 --- a/docs/applications/git.md +++ b/docs/applications/git.md @@ -4,93 +4,73 @@ [官网](https://git-scm.com/) -## 概述 +## 什么是Git -Git是一个Git是一个免费开源自由的分布式版本控制软件,Git采用[GPL-V2协议](https://opensource.org/license/GPL-2.0)发布,是软件开发中的常用软件,当然Git不单单可以用来软件开发,只要涉及版本控制,使用Git就是个不错的选择。 +Git是一个Git是一个免费开源自由的分布式版本控制软件,Git采用[GPL-V2协议](https://opensource.org/license/GPL-2.0)发布,是软件开发中的常用软件,当然Git不单单可以用来软件开发,只要涉及版本控制,使用Git就是个不错的选择 -## 使用方法 +## Git的诞生 -### 克隆仓库 +自从Linus于1991年发布Linux的第一个版本并且公开源代码开始,每天都有来自全世界的程序员给Linux贡献代码,这就产生了一个问题,如果新添加的代码存在问题该如何回退到之前的版本,如何管理代码,如何决定那些代码进入最终版本,也就是版本控制的问题,在1991~2001年期间Linux的维护工作的大量时间都花在了提交补丁和保存归档的繁琐事务上,在2002年Linux使用BitKeeper来管理版本,BitKeeper是一个闭源付费的软件,但其开发公司与Linux团队达成了协议,让Linux团队免费使用BitKeeper,但Linux的开发社区依旧对BitKeeper不满,所以社区试图破解BitKeeper的协议,被发现后,BitKeeper的开发公司收回了Linux团队的免费使用权,Linus在此情况下自己写出了Git并公开源代码发布,有趣的是BitKeeper在2016以Apache2.0协议开源,不过其已经停止开发 -``` -git clone http://example.com/example.git -``` +## Git的使用 -### 创建初始化一个Git仓库 +**由于本文档面向新手所以只介绍Git的本地仓库版本管理,不涉及远程仓库的使用** -#### 从空的目录创建 +- 使用以下命令创建初始化一个Git仓库 ``` -mkdir 文件夹名称 -cd 文件夹名称 -git init -``` - -> `mkdir 文件夹名称` 用于创建文件夹 -> -> `cd 文件夹名称` 进入您刚刚创建的文件夹 +#mkdir用于创建文件夹 -#### 在已有项目中创建 +mkdir 文件夹名称 -> 确保您当前位于您的项目目录中 (使用`pwd`命令确认,`cd`命令用于进入一个文件夹) +#cd用于切换目录 +cd 文件夹名称 -``` git init -``` -### 将修改的文件推送到仓库创建一个版本 +``` -#### 加入暂存区 +- 使用以下命令将修改的文件推送到本地仓库创建一个版本 ``` -git add 修改的文件 -``` +#git add命令会把文件放入暂存区 -> `add`意为`添加`,用于将文件加入暂存区 +git add 修改的文件 -#### 提交暂存区 +#您可以不加-m参数,Git会打开一个图形界面让您填写信息 +#git commit 将缓存区的文件放入本地仓库 -``` git commit -m "这一次提交的介绍" -``` -???+ tip "不带`-m`参数" - 您可以不加`-m`参数,Git会根据您当前的`EDITOR`环境变量打开一个编辑器让您填写信息 +``` - 您可以使用`echo $EDITOR`得知当前编辑器是什么 +- 使用使用以下命令查看所有版本 - `git commit` 将缓存区的文件放入本地仓库 +``` +git log -> `commit`意为`提交` +#如果您想要一个更加简洁的界面 -### 查看所有版本 +git log --oneline -``` -git log ``` -???+ tip "如果您想要一个更加简洁的界面" - `git log --oneline` +- 使用以下命令回退版本 -### 回退版本 +``` +#哈希值使用git log查看,是一串很长的文本,哈希值是独一无二的 +#git reflog可以查看您所有的操作,包括您删除的版本的哈希值 +#git reset默认使用--mixed参数,这会删除本地仓库和缓存区的文件,而--hard参数会删除本地仓库和缓存区和工作区的文件,--soft参数只删除本地仓库的文件 +#更推荐您使用默认参数 -- `git log` 查看commit历史,每一个提交都具有一个独一无二的哈希值 -- `git reflog` 可以查看您所有的操作,包括您删除的版本的哈希值 -- `git reset --mixed` 这是默认使用参数,会删除本地仓库和缓存区的文件 -- `git reset --hard` 会删除本地仓库和缓存区和工作区的文件 -- `git reset --soft` 只删除本地仓库的文件 +git reset 版本的哈希值 -> 更推荐您使用默认参数 -> -> `git reset 版本的哈希值` +``` +## 视频教程 -## 关于更多 +[一小时Git教程](https://www.bilibili.com/video/BV1HM411377j/) +[蛋老师的Git教程](https://www.bilibili.com/video/BV1r3411F7kn/) +[Git的原理解析](https://www.bilibili.com/video/BV11z4y1X79p/) -由于我们的专门性限制,我们建议您去其他专门教程深入的的学习git。 -1. [Pro Git Book](https://git-scm.com/book/zh/v2) -2. [菜鸟教程](https://www.runoob.com/git/git-tutorial.html) -3. [一小时Git教程](https://www.bilibili.com/video/BV1HM411377j/) -4. [蛋老师的Git教程](https://www.bilibili.com/video/BV1r3411F7kn/) -5. [Git的原理解析](https://www.bilibili.com/video/BV11z4y1X79p/) -- cgit v1.3 From 0f32f01425c85987e795f3945a87b0d1c31f652b Mon Sep 17 00:00:00 2001 From: sayo Date: Sat, 15 Aug 2026 22:36:29 -0400 Subject: initial commit on obs-studio --- docs/applications/vai/obs_studio.md | 73 +++++++++++++++++++++++++++++++++++++ mkdocs.yml | 2 + 2 files changed, 75 insertions(+) create mode 100644 docs/applications/vai/obs_studio.md (limited to 'docs/applications') diff --git a/docs/applications/vai/obs_studio.md b/docs/applications/vai/obs_studio.md new file mode 100644 index 0000000..4afed02 --- /dev/null +++ b/docs/applications/vai/obs_studio.md @@ -0,0 +1,73 @@ +# OBS Studio + + +![md 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 + ``` + + + +## 配置 + +### 录制屏幕 +我们需要添加一个屏幕捕捉源。在 OBS 窗口下方的 **来源** 中,点击 **+** 号,选择 **屏幕采集(Pipewire)** ,点击 **OK** 。电脑可能会问您诸如 “是否允许该应用录制屏幕” 的问题,选择允许。现在您应该可以在新弹出的窗口上看到目前屏幕的内容,点击 **OK** 来保存设定。 + + + +### 视频质量 +OBS Studio 默认输出 1080p ,最高 2500 kbps 的视频。若要更改输出画质,前往 OBS 窗口的右下角,点击 **设置**,在弹出的窗口的左侧栏目中点击 **视频**,将右侧的 **输出分辨率** 改为想要的值。再点击左侧栏目的 **输出**,将右侧的 **视频比特率** 改为想要的值,点击右下角的 **完成**。 + + + +## 使用 + +点击**开始录制**或**开始直播**,在完成后点击**停止录制**或**停止直播**。 + +如想暂停录制,点击 **停止录制** *旁边* 的暂停键以暂停。再点一下以继续录制,或点击**停止录制**来结束。 + + + + +## 关于更多 + +- [官方网站](https://obsproject.com/) + + \ No newline at end of file diff --git a/mkdocs.yml b/mkdocs.yml index 31d70fd..8fe8113 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -177,6 +177,8 @@ nav: - applications/ssh.md - applications/git.md - applications/openclaw.md + - 视频,音频与图像编辑: + - applications/vai/obs_studio.md - 开发相关: - applications/programming/cpp.md - applications/programming/python.md -- cgit v1.3 From 910efecf9166becb30730307f9e4043642d72882 Mon Sep 17 00:00:00 2001 From: sayo Date: Sun, 16 Aug 2026 05:09:58 -0400 Subject: removed sarcasm on coc and j4w --- docs/applications/vai/obs_studio.md | 21 +-------------------- 1 file changed, 1 insertion(+), 20 deletions(-) (limited to 'docs/applications') diff --git a/docs/applications/vai/obs_studio.md b/docs/applications/vai/obs_studio.md index 4afed02..b179d23 100644 --- a/docs/applications/vai/obs_studio.md +++ b/docs/applications/vai/obs_studio.md @@ -1,5 +1,4 @@ # OBS Studio - ![md Logo](https://obsproject.com/assets/images/new_icon_small-r.png) @@ -10,16 +9,12 @@ OBS Studio 同时是一款视频录制器和一款推流器。它还有“合成 OBS Studio 完全免费,灵活可定制,还有庞大的插件库和社区支持。 - - ## 安装 可以通过 Flatpak,Snap 等安装 OBS Stuio,也可以通过包管理器直接安装 OBS Studio。 !!! info "注意" 应该先在发行版提供的应用商店里搜一下 ``OBS Studio``。如果搜到了,最安全的方法是安装应用商店里的那个,因为通常来说发行版会管理好一切,开箱即用。 - - ### Flatpak(推荐) ```bash flatpak install com.obsproject.Studio @@ -29,7 +24,6 @@ flatpak install com.obsproject.Studio ```bash sudo snap install obs-studio ``` - ### 包管理器 - Debian系: @@ -41,33 +35,20 @@ sudo snap install obs-studio sudo yum install obs-studio ``` - - ## 配置 ### 录制屏幕 我们需要添加一个屏幕捕捉源。在 OBS 窗口下方的 **来源** 中,点击 **+** 号,选择 **屏幕采集(Pipewire)** ,点击 **OK** 。电脑可能会问您诸如 “是否允许该应用录制屏幕” 的问题,选择允许。现在您应该可以在新弹出的窗口上看到目前屏幕的内容,点击 **OK** 来保存设定。 - - ### 视频质量 OBS Studio 默认输出 1080p ,最高 2500 kbps 的视频。若要更改输出画质,前往 OBS 窗口的右下角,点击 **设置**,在弹出的窗口的左侧栏目中点击 **视频**,将右侧的 **输出分辨率** 改为想要的值。再点击左侧栏目的 **输出**,将右侧的 **视频比特率** 改为想要的值,点击右下角的 **完成**。 - - ## 使用 点击**开始录制**或**开始直播**,在完成后点击**停止录制**或**停止直播**。 如想暂停录制,点击 **停止录制** *旁边* 的暂停键以暂停。再点一下以继续录制,或点击**停止录制**来结束。 - - - ## 关于更多 -- [官方网站](https://obsproject.com/) - - \ No newline at end of file +- [官方网站](https://obsproject.com/) \ No newline at end of file -- cgit v1.3 From 48b83d12b91d29c479ef2e1dd474157f68964079 Mon Sep 17 00:00:00 2001 From: sayo Date: Sun, 16 Aug 2026 07:31:53 -0400 Subject: many new features on obs_studio.md --- docs/applications/vai/obs_studio.md | 85 +++++++++++++++++++++++++++++++++---- 1 file changed, 76 insertions(+), 9 deletions(-) (limited to 'docs/applications') diff --git a/docs/applications/vai/obs_studio.md b/docs/applications/vai/obs_studio.md index b179d23..a1b6ecc 100644 --- a/docs/applications/vai/obs_studio.md +++ b/docs/applications/vai/obs_studio.md @@ -1,19 +1,20 @@ # OBS Studio -![md Logo](https://obsproject.com/assets/images/new_icon_small-r.png) +![Markdown Logo](https://obsproject.com/assets/images/new_icon_small-r.png) + +全称:Open Broadcaster Software,开源广播软件(直译) ## 概述 -全称:Open Broadcaster Software,开源广播软件(直译) -OBS Studio 同时是一款视频录制器和一款推流器。它还有“合成器”的功能,允许将多个输入源合并到同一个输出中————然后发送到视频流服务器或保存为文件。 +OBS Studio 同时是一款视频录制器和一款推流器。它还有“合成器”的功能,允许将多个输入源合并到同一个输出中——然后发送到视频流服务器或保存为文件。 OBS Studio 完全免费,灵活可定制,还有庞大的插件库和社区支持。 ## 安装 -可以通过 Flatpak,Snap 等安装 OBS Stuio,也可以通过包管理器直接安装 OBS Studio。 +可以通过 Flatpak 和 Snap 安装 OBS Stuio,也可以通过包管理器直接安装 OBS Studio。 -!!! info "注意" - 应该先在发行版提供的应用商店里搜一下 ``OBS Studio``。如果搜到了,最安全的方法是安装应用商店里的那个,因为通常来说发行版会管理好一切,开箱即用。 +???+ info "注意" + 应该先在应用商店(如果有的话)里搜一下 ``OBS Studio``。如果搜到了,最安全的方法是安装应用商店里的那个,因为通常来说发行版会管理好一切,开箱即用。 ### Flatpak(推荐) ```bash @@ -38,10 +39,27 @@ sudo snap install obs-studio ## 配置 ### 录制屏幕 -我们需要添加一个屏幕捕捉源。在 OBS 窗口下方的 **来源** 中,点击 **+** 号,选择 **屏幕采集(Pipewire)** ,点击 **OK** 。电脑可能会问您诸如 “是否允许该应用录制屏幕” 的问题,选择允许。现在您应该可以在新弹出的窗口上看到目前屏幕的内容,点击 **OK** 来保存设定。 +在 **来源** 中,点击 **+** 号,选择 **屏幕采集(Pipewire)** ,点击 **OK** 。 + +???+ info "如果收到了弹窗..." + 桌面管理器可能会问您诸如 “是否允许该应用录制屏幕” 的问题,选择允许。这是安全的,只有 OBS Studio 能看见屏幕上的内容。 + +现在您应该可以在新弹出的窗口上看到目前屏幕的内容,再点击一次 **OK** 来保存设定。 ### 视频质量 -OBS Studio 默认输出 1080p ,最高 2500 kbps 的视频。若要更改输出画质,前往 OBS 窗口的右下角,点击 **设置**,在弹出的窗口的左侧栏目中点击 **视频**,将右侧的 **输出分辨率** 改为想要的值。再点击左侧栏目的 **输出**,将右侧的 **视频比特率** 改为想要的值,点击右下角的 **完成**。 +OBS Studio 默认输出 1080p ,(视您的硬件)最高 6000 kbps 的视频。 + +#### 更改输出分辨率 +若要更改输出分辨率,点击右下角的 **设置**,在设置的左侧栏目中点击 **视频**,将右侧的 **输出分辨率** 改为想要的值,点击右下角的 **完成**。 + +#### 更改输出比特率 +前往 **设置**,点击左侧栏目的 **输出**,将右侧的 **视频比特率** 改为想要的值,点击右下角的 **完成**。 + +### 快捷键 + +前往 **设置**,左侧栏目的 **快捷键**,点击项目后的输入框,在键盘和/或鼠标(是的,可以绑定鼠标侧键)按下你想要设置的键。 +???+ note "不工作?" + 如果快捷键在 OBS 窗口外不工作,很有可能您使用 Wayland 显示服务器。OBS 无法在后台访问键盘,这是 Wayland 为了安全而作出的限制。有利用 Wayland 原生接口的插件,参阅 [**Wayland 下的快捷键**](.#wayland) 章节。 ## 使用 @@ -49,6 +67,55 @@ OBS Studio 默认输出 1080p ,最高 2500 kbps 的视频。若要更改输出 如想暂停录制,点击 **停止录制** *旁边* 的暂停键以暂停。再点一下以继续录制,或点击**停止录制**来结束。 +## 高级 + +### 硬件加速( 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/) \ No newline at end of file +- [官方网站](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 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 +++++++++++++++++++++++++++++ docs/applications/vai/obs_studio.md | 121 ----------------------------- mkdocs.yml | 4 +- 3 files changed, 123 insertions(+), 123 deletions(-) create mode 100644 docs/applications/multimedia/obs_studio.md delete mode 100644 docs/applications/vai/obs_studio.md (limited to 'docs/applications') 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 diff --git a/docs/applications/vai/obs_studio.md b/docs/applications/vai/obs_studio.md deleted file mode 100644 index a1b6ecc..0000000 --- a/docs/applications/vai/obs_studio.md +++ /dev/null @@ -1,121 +0,0 @@ -# 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 diff --git a/mkdocs.yml b/mkdocs.yml index 8fe8113..105b16f 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -177,8 +177,8 @@ nav: - applications/ssh.md - applications/git.md - applications/openclaw.md - - 视频,音频与图像编辑: - - applications/vai/obs_studio.md + - 多媒体处理: + - applications/multimedia/obs_studio.md - 开发相关: - applications/programming/cpp.md - applications/programming/python.md -- 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') 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') 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 7f7a0239bb06f2427285be264b8c1776d789833f Mon Sep 17 00:00:00 2001 From: sayo Date: Sun, 16 Aug 2026 12:34:30 -0400 Subject: fixed docs/applications/git.md --- docs/applications/git.md | 90 +++++++++++++++++++++++++++++------------------- 1 file changed, 55 insertions(+), 35 deletions(-) (limited to 'docs/applications') diff --git a/docs/applications/git.md b/docs/applications/git.md index 1e0cf67..ad481a6 100644 --- a/docs/applications/git.md +++ b/docs/applications/git.md @@ -4,73 +4,93 @@ [官网](https://git-scm.com/) -## 什么是Git +## 概述 -Git是一个Git是一个免费开源自由的分布式版本控制软件,Git采用[GPL-V2协议](https://opensource.org/license/GPL-2.0)发布,是软件开发中的常用软件,当然Git不单单可以用来软件开发,只要涉及版本控制,使用Git就是个不错的选择 +Git是一个Git是一个免费开源自由的分布式版本控制软件,Git采用[GPL-V2协议](https://opensource.org/license/GPL-2.0)发布,是软件开发中的常用软件,当然Git不单单可以用来软件开发,只要涉及版本控制,使用Git就是个不错的选择。 -## Git的诞生 +## 使用方法 -自从Linus于1991年发布Linux的第一个版本并且公开源代码开始,每天都有来自全世界的程序员给Linux贡献代码,这就产生了一个问题,如果新添加的代码存在问题该如何回退到之前的版本,如何管理代码,如何决定那些代码进入最终版本,也就是版本控制的问题,在1991~2001年期间Linux的维护工作的大量时间都花在了提交补丁和保存归档的繁琐事务上,在2002年Linux使用BitKeeper来管理版本,BitKeeper是一个闭源付费的软件,但其开发公司与Linux团队达成了协议,让Linux团队免费使用BitKeeper,但Linux的开发社区依旧对BitKeeper不满,所以社区试图破解BitKeeper的协议,被发现后,BitKeeper的开发公司收回了Linux团队的免费使用权,Linus在此情况下自己写出了Git并公开源代码发布,有趣的是BitKeeper在2016以Apache2.0协议开源,不过其已经停止开发 +### 克隆仓库 -## Git的使用 +``` +git clone http://example.com/example.git +``` -**由于本文档面向新手所以只介绍Git的本地仓库版本管理,不涉及远程仓库的使用** +### 创建初始化一个Git仓库 -- 使用以下命令创建初始化一个Git仓库 +#### 从空的目录创建 ``` -#mkdir用于创建文件夹 +mkdir 文件夹名称 +cd 文件夹名称 +git init +``` -mkdir 文件夹名称 +> `mkdir 文件夹名称` 用于创建文件夹 +> +> `cd 文件夹名称` 进入您刚刚创建的文件夹 -#cd用于切换目录 -cd 文件夹名称 +#### 在已有项目中创建 -git init +> 确保您当前位于您的项目目录中 (使用`pwd`命令确认,`cd`命令用于进入一个文件夹) +``` +git init ``` -- 使用以下命令将修改的文件推送到本地仓库创建一个版本 +### 将修改的文件推送到仓库创建一个版本 -``` -#git add命令会把文件放入暂存区 +#### 加入暂存区 +``` git add 修改的文件 +``` -#您可以不加-m参数,Git会打开一个图形界面让您填写信息 -#git commit 将缓存区的文件放入本地仓库 +> `add`意为`添加`,用于将文件加入暂存区 -git commit -m "这一次提交的介绍" +#### 提交暂存区 +``` +git commit -m "这一次提交的介绍" ``` -- 使用使用以下命令查看所有版本 +???+ tip "不带`-m`参数" + 您可以不加`-m`参数,Git会根据您当前的`EDITOR`环境变量打开一个编辑器让您填写信息 -``` -git log + 您可以使用`echo $EDITOR`得知当前编辑器是什么 -#如果您想要一个更加简洁的界面 + `git commit` 将缓存区的文件放入本地仓库 -git log --oneline +> `commit`意为`提交` +### 查看所有版本 + +``` +git log ``` -- 使用以下命令回退版本 +???+ tip "如果您想要一个更加简洁的界面" + `git log --oneline` -``` -#哈希值使用git log查看,是一串很长的文本,哈希值是独一无二的 -#git reflog可以查看您所有的操作,包括您删除的版本的哈希值 -#git reset默认使用--mixed参数,这会删除本地仓库和缓存区的文件,而--hard参数会删除本地仓库和缓存区和工作区的文件,--soft参数只删除本地仓库的文件 -#更推荐您使用默认参数 +### 回退版本 -git reset 版本的哈希值 +- `git log` 查看commit历史,每一个提交都具有一个独一无二的哈希值 +- `git reflog` 可以查看您所有的操作,包括您删除的版本的哈希值 +- `git reset --mixed` 这是默认使用参数,会删除本地仓库和缓存区的文件 +- `git reset --hard` 会删除本地仓库和缓存区和工作区的文件 +- `git reset --soft` 只删除本地仓库的文件 -``` +> 更推荐您使用默认参数 +> +> `git reset 版本的哈希值` -## 视频教程 -[一小时Git教程](https://www.bilibili.com/video/BV1HM411377j/) -[蛋老师的Git教程](https://www.bilibili.com/video/BV1r3411F7kn/) -[Git的原理解析](https://www.bilibili.com/video/BV11z4y1X79p/) +## 关于更多 +由于我们的专门性限制,我们建议您去其他专门教程深入的的学习git。 +1. [Pro Git Book](https://git-scm.com/book/zh/v2) +2. [菜鸟教程](https://www.runoob.com/git/git-tutorial.html) +3. [一小时Git教程](https://www.bilibili.com/video/BV1HM411377j/) +4. [蛋老师的Git教程](https://www.bilibili.com/video/BV1r3411F7kn/) +5. [Git的原理解析](https://www.bilibili.com/video/BV11z4y1X79p/) -- 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') 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') 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') 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') 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') 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') 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') 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') 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') 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') 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