# Pika

> GNOME Wayland 原生录屏工具

## Docs

- [Pika](https://hungtcs.github.io/pika-linux): Pika 是 GNOME Wayland 下的原生录屏工具：选区录制、系统声音与麦克风、MP4 与 GIF/APNG 输出，采集走桌面门户和 PipeWire，编码尽量用硬件加速。
- [安装](https://hungtcs.github.io/pika-linux/install): 在 Fedora 上用 RPM 安装 Pika，或者从源码构建两半组件；含系统要求、构建依赖、运行时依赖，以及 Flatpak 的现状说明。
- [使用](https://hungtcs.github.io/pika-linux/usage): 顶栏菜单、选区的拖拽与吸附、键盘与右键操作、工具条上的格式与音频开关、全局快捷键，以及三种停止录制的方式和输出文件的位置。
- [设置](https://hungtcs.github.io/pika-linux/settings): Pika 全部配置项及其对应的 dconf 键名：快捷键、视频帧率与分辨率、系统声音与麦克风、动图参数、输出目录，以及如何用 gsettings 直接改。
- [工作原理](https://hungtcs.github.io/pika-linux/architecture): 为什么 Pika 必须拆成 GNOME Shell 扩展和独立录制进程两半，两者如何通过 D-Bus 通信，门户采集与 GStreamer 编码管线是怎么搭起来的。
- [排查](https://hungtcs.github.io/pika-linux/troubleshooting): 菜单变成安装指引、收到扩展未启用的通知、每次录制都弹授权框、管线起不来、扩展改了代码不生效 —— 这些常见问题分别是什么原因，怎么处理。