Skip to content

Repository files navigation

Recoder

Logo

Recoder 是一款基于 Electron + Vue 3 的轻量桌面屏幕录制工具,支持选区录制、系统声音 / 麦克风录制、提词器等特性,录制完成后可直接预览并保存为 WebM/MP4 视频。

功能特性

  • 屏幕选区录制:通过全屏透明遮罩框选录制区域,支持多显示器
  • 录制倒计时:框选区域后提供 3 秒倒计时,便于准备
  • 系统声音录制:可选录制电脑播放的声音
  • 麦克风录制:可选录制麦克风输入,支持指定音频输入设备
  • 麦克风电平监测:录制前实时显示麦克风音量条,识别无声音 / 爆音
  • 音频混音:同时录制系统声音与麦克风时,通过 Web Audio API 混音为单条音轨
  • 提词器:录制时在屏幕顶部显示可滚动提词窗口,支持调整字号与滚动速度,并跟随主题切换;窗口已排除出屏幕捕获,不会出现在录像中;设置本地持久化,提词稿支持命名保存,可在历史面板中加载/重命名/删除;提词文本支持 # 标题、强调、--- 分隔等轻量排版;支持录制前预览与滚动进度条
  • 录制控制条:录制期间显示悬浮控制条,包含录制状态与计时器,可随时停止
  • 摄像头画中画:录制时在角落叠加摄像头小窗,支持选择设备、位置、大小与镜像
  • 录制背景:将录屏画面嵌入所选背景(纯色 / 渐变 / 图片 / 视频),支持调整边距与录制前预览合成效果
  • 录制暂停/继续:录制期间可随时暂停与继续,支持控制条按钮与全局快捷键(默认 Ctrl+Shift+P)
  • 实时预览与保存:停止后生成预览,可导出 MP4(H.264 + AAC)或 WebM 格式
  • 录制历史:自动保存到固定目录并生成历史列表(时长 / 时间 / 大小),支持播放、打开所在文件夹、删除
  • 明暗主题:支持浅色 / 深色主题切换,偏好保存在本地
  • 权限引导:麦克风 / 摄像头与屏幕采集权限显式请求、状态提示,被拒后可一键跳转系统设置

技术栈

环境要求

  • Node.js 18+(建议使用 LTS 版本)
  • npm(随 Node.js 安装)

快速开始

# 安装依赖
npm install

# 启动开发模式(启动 Vite 开发服务器并拉起 Electron)
npm run dev

截图

使用说明

  1. 启动应用,在主界面设置是否录制系统声音、是否录制麦克风(可选指定麦克风设备)。
  2. 如需提词器,开启提词器开关并输入提词内容,可调整字号与滚动速度。
  3. 点击「选择录制区域」,在屏幕遮罩上拖拽框选要录制的区域,确认后进入倒计时。
  4. 倒计时结束后开始录制,选区下方会出现带计时器的录制控制条,提词器窗口固定在屏幕顶部(已排除出捕获,不会录进视频)。
  5. 点击控制条上的「停止」结束录制,主窗口显示录制预览。
  6. 点击保存按钮,选择导出格式(MP4 / WebM)与保存位置,MP4 会自动完成转换。

构建说明

  • 主进程与各预加载脚本通过 vite-plugin-electron 构建到 dist-electron/,选区 / 控制条 / 提词器三个 HTML 窗口会在构建时复制到 dist-electron/
  • 打包配置位于 package.jsonbuild 字段:Windows 使用 NSIS 安装包,支持自定义安装目录。
  • MP4 转换依赖 ffmpeg-static 内置的 ffmpeg 二进制,打包时通过 asarUnpack 解包,确保可执行文件可正常调用。
  • 应用图标使用 public/logo.ico,同时应用于窗口与打包安装包。

TODO

录制体验

  • 录制中暂停/继续:MediaRecorder.pause/resume 就能做,改造成本低,录长视频很需要。
  • 快捷键控制:全局快捷键(开始/停止录制、暂停);提词器播放/暂停为窗口内快捷键(默认空格,聚焦时生效)。
  • 指定窗口录制:从"区域"升级到"跟随某个窗口",窗口移动录制区域也跟着动。
  • 摄像头画中画(PiP):录制时叠加摄像头小窗,主播/录课场景刚需。
  • 录制历史:列表(时长/时间/大小),支持播放、打开所在文件夹、删除(缩略图 / 重命名可后续补充)。
  • 自动保存到固定目录 + 录制后自动打开文件夹。

提词器增强

  • 设置持久化:字号/速度/窗口位置现在每次重开都是默认值,存到本地(localStorage 或配置文件)体验提升明显。
  • 录制中实时编辑文本:现在内容是开始前的快照,录制中改不了。
  • 镜像模式:对着摄像头讲话时,文字左右镜像,主播常用。
  • 录制前预览:不开始录制即可试用字号/速度。
  • 进度条/已读剩余提示:知道还差多少。
  • 透明度/字体选择:界面自由度更高。

工程/质量

  • 托盘常驻:最小化到托盘、托盘菜单一键开始/停止录制。
  • 导出增强:GIF、分辨率/帧率/码率设置(现在 ffmpeg 只做转码)。
  • 设置面板整合:把系统声音/麦克风/提词器/快捷键归到统一设置页并持久化。

About

桌面端轻量录屏器,开源,自用

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages