---
title: Pika
description: Pika 是 GNOME Wayland 下的原生录屏工具：选区录制、系统声音与麦克风、MP4 与 GIF/APNG 输出，采集走桌面门户和 PipeWire，编码尽量用硬件加速。
---

Pika 用来录制 GNOME Wayland 桌面的整块屏幕或一块选区。采集走桌面门户和 PipeWire，
编码在有硬件支持时自动使用硬件加速。

## 功能

- 选区支持窗口、顶栏与 dock 吸附
- 输出 MP4 视频，或 GIF、APNG 动图
- 可录制系统声音与麦克风，混成一条音轨
- 视频与动图各有独立的帧率和分辨率上限
- 全局快捷键

## 它由两半组成

| 组件 | 职责 |
| --- | --- |
| GNOME Shell 扩展 | 全部界面：顶栏指示器、选区遮罩、录制取景框、设置窗口 |
| 录制进程 | 门户权限协商、PipeWire 收帧、GStreamer 编码 |

**两半必须配套安装。** 这不是打包偷懒，是被平台逼出来的 ——
Wayland 不允许应用绘制浮层或决定窗口位置，界面只能做在合成器里；
而 GJS 是单线程的，和合成共用一个主循环，H.264 编码绝不能跑在里面。
详见[工作原理](/architecture)。

## 开始

- [安装](/install) —— RPM、从源码构建
- [使用](/usage) —— 选区操作、工具条、快捷键
- [设置](/settings) —— 全部配置项
- [排查](/troubleshooting) —— 装完没反应、每次都弹授权框之类的问题