# pear-rec

**Repository Path**: xiguapi027/pear-rec

## Basic Information

- **Project Name**: pear-rec
- **Description**: pear-rec(梨子 rec) 是一个跨平台的截图、录屏、录音、录像软件。
- **Primary Language**: TypeScript
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 160
- **Forks**: 48
- **Created**: 2023-05-24
- **Last Updated**: 2025-09-09

## Categories & Tags

**Categories**: multimedia

**Tags**: Electron, React, vite

## README

<p align="center">
  <img src="https://027xiguapi.github.io/pear-rec/logo.png"  height="120">
  <h1 align="center">pear-rec</h1>
</p>
<p align="center">
<img src="https://img.shields.io/github/stars/027xiguapi/pear-rec" alt="stars">
<img src="https://img.shields.io/badge/react-v18-blue" alt="react">
<img src="https://img.shields.io/badge/electron-v26-blue" alt="electron">
<img src="https://img.shields.io/badge/nestjs-v3-blue" alt="nestjs">
<img src="https://img.shields.io/badge/-TypeScript-blue?logo=typescript&logoColor=white" alt="typescript">
<img src="https://img.shields.io/badge/-Vite-blue?logo=vite&logoColor=white" alt="vite">
</p>

---

## README

[中文](README.zh-CN.md) | [English](README.md) | [Deutsch](README.de-DE.md)

## 📖 简介

> pear-rec 是一款**开源、免费**和功能强大的截屏、录屏和录音软件，适用于多个平台和各种使用场景。它提供了简单易用的界面和丰富的功能，使用户能够轻松记录屏幕活动、录制音频和截取屏幕截图。无论是在教育、工作还是娱乐中，pear-rec都能为用户提供便捷和高效的录制工具。
>
> pear-rec(梨子 rec) 是一个跨平台的截图、录屏、录音、录像、录制(动图)gif、查看图片、查看视频、查看音频和修改图片的软件，目前提供了 Windows 、Linux 和 macOS [免费下载](https://github.com/027xiguapi/pear-rec/releases)。
>
> 更多功能和 api 可以查看[官网(https://027xiguapi.github.io/pear-rec)](https://027xiguapi.github.io/pear-rec) 或 [https://xiguapi027.gitee.io/pear-rec](https://xiguapi027.gitee.io/pear-rec)

## 🧱 架构

<img src="https://027xiguapi.github.io/pear-rec/imgs/webav.png" />

> pear-rec(梨子 rec) 的跨平台是基于 `electronjs`,前端是基于 `reactjs`,截图、录屏、录音、录像、录制(动图)gif 等功能是基于 `webrtc` 和 `webcodecs` 的一个项目。

## 🖖 Vue

社区人员基于 `vue` 实现的截图功能 👉 [electron-screenshort](https://github.com/yejimeiming/electron-screenshort).

## 🌰 例子

[网页](https://pear-rec-xiguapi.vercel.app/)

## 🧲 下载地址

> gitee: https://gitee.com/xiguapi027/pear-rec
>
> github: https://github.com/027xiguapi/pear-rec

## 🔨 源码运行&编译

编译需要`nodejs`和`pnpm`环境

```
nodejs >= 18
pnpm: 8
```

### 开始

```shell
# 拷贝代码
git clone https://gitee.com/xiguapi027/pear-rec.git
# 进入项目
cd pear-rec
# 安装依赖
pnpm install
# 调试页面
pnpm run dev:web
# 调试服务
pnpm run dev:server
# 调试软件
pnpm run dev:desktop
# 运行页面
pnpm run start:web
# 运行软件
pnpm run start:desktop
# 编译软件
pnpm run build:desktop
# 清除 node_modules
pnpm run clear
```

## 🥰 功能

<center>
  <img src="https://027xiguapi.github.io/pear-rec/assets/home.7d9162cb.jpg" />
</center>

已经勾选的功能是开发过程最新功能，但可能还没发布在最新版本

- [x] 动图(gif.js)
  - [x] 录制
  - [x] 编辑
- [x] 截图(react-screenshots)
  - [x] 框选裁切
  - [x] 框选大小位置可调整
  - [x] 取色器
  - [x] 放大镜
  - [x] 画笔（自由画笔）
  - [x] 几何形状（边框填充支持调节）
  - [x] 高级画板设置
  - [x] 图像滤镜（支持局部马赛克模糊和色彩调节）
  - [x] 自定义框选松开后的操作
  - [x] 以图搜图
  - [x] 扫描二维码
  - [ ] 快速截取全屏到剪贴板或自定义的目录
  - [ ] 截屏历史记录
  - [ ] 窗口和控件选择（使用 OpenCV 边缘识别）
  - [ ] 长截屏
  - [ ] 多屏幕
- [x] 录屏(WebRTC)
  - [x] 录制全屏
  - [x] 截图
  - [x] 自定义大小
  - [x] 静音
  - [ ] 按键提示
  - [ ] 光标位置提示
  - [ ] 录制栏
  - [ ] 流写入
- [x] 录音(WebRTC)
  - [x] 录音设置
  - [x] 查看录音
  - [x] 下载录音
  - [ ] 编辑录音
- [x] 录像(WebRTC)
  - [ ] 自定义比特率
- [x] 图片预览(viewerjs)
  - [x] 放大
  - [x] 缩小
  - [x] 拖拽
  - [x] 翻转
  - [x] 钉上层
  - [x] 查看
  - [x] 下载
  - [x] 打印
  - [ ] ocr
  - [x] 查看列表
  - [x] 以图搜图
  - [x] 扫描二维码
- [x] 图片编辑(tui-image-editor)
- [x] 视频预览(plyr)
- [x] 音频预览(aplayer)
- [x] 基本设置
  - [x] 用户 uuid
  - [x] 保存地址
  - [x] 开机自启动
  - [x] 国际化(中、英、德)
  - [x] 服务设置
  - [x] 快捷键设置
  - [x] 重置设置

## 🌍 国际化(I18n)

- [x] 简体中文
- [x] 英语
- [x] 德语

## 👇 Download

| 系统 | Windows | Linux | Macos |
| --- | --- | --- | --- |
| 链接 | [下载](https://github.com/027xiguapi/pear-rec/releases) | [下载](https://github.com/027xiguapi/pear-rec/releases) | [下载](https://github.com/027xiguapi/pear-rec/releases) |

## 👨‍👨‍👦‍👦 反馈和交流

我们推荐使用 [issue](https://github.com/027xiguapi/pear-rec/issues) 列表进行最直接有效的反馈，也可以下面的方式

- qq 群

<p align="center">
  <img src="https://027xiguapi.github.io/pear-rec/imgs/pear-rec_qq_qrcode.png" />
</p>

## 🤝 开源协议

[pear-rec(梨子 rec) 可在 Apache License V2 下使用。](LICENSE)

[开源项目礼节](https://developer.mozilla.org/zh-CN/docs/MDN/Community/Open_source_etiquette)