LaoFeng-mouse/flyingmouse-format

★ 7,074⑂ 576

飞鼠格式 FlyingMouse Format - Windows 免费文件格式转换工具(离线可用,内置 FFmpeg/LibreOffice/Poppler/Tesseract)。图片/文档/表格/PPT/PDF/音视频/WPS 格式互转 + OCR + 批量转换;音频仅支持普通格式。作者:牢蜂(LaoFeng)|仅供个人免费使用,禁止商业售卖/转卖/套壳

About LaoFeng-mouse/flyingmouse-format

LaoFeng-mouse/flyingmouse-format is an open-source project on GitHub, mainly written in JavaScript. 飞鼠格式 FlyingMouse Format - Windows 免费文件格式转换工具(离线可用,内置 FFmpeg/LibreOffice/Poppler/Tesseract)。图片/文档/表格/PPT/PDF/音视频/WPS 格式互转 + OCR + It currently holds 7,074 stars and 576 forks with 66 open issues, and was last pushed on 2026-11-09 (repository created 2026-08-06).

Project Overview

Git Homed tracks it on the Video Trending board and on the AI Video Trending list.

GitHub Repository Details

Repository LaoFeng-mouse/flyingmouse-format · default branch main · size 8812 KB · watchers 11 · source: GitHub REST API and repository README

README

当前为 0.8.4 的 Office 长路径修复源码。商店 MSIX 候选已完成整体构建和本地验收,尚未安装、上传、提交认证或公开发布;公开最新版仍为 v0.8.3 Release,进度见 现役交接。
Candidate 0.8.4 fixes Office intermediate paths. Its Store MSIX has been fully rebuilt and locally validated; installation, upload, certification and public release have not occurred. The latest public Windows 10/11 x64 full release remains v0.8.3. See the current handoff.

FlyingMouse Format / 飞鼠格式

已发布的 0.8.3 包含 ICO、普通媒体、电子书安全、依赖兼容和 PDF/OCR 长路径修复,提供 Windows 10/11 x64 完整版。后续 Store 候选验证发现的 Office 中间路径问题已在 0.8.4 修复;新 MSIX 的深层 TEMP 实际转换与全载荷核验通过,尚无新公开下载或 NSIS。0.8.3 Store 候选已暂停交付,Lite、Win7 和 macOS 包未发布;既有 PDF/Word、OFD、Excel、CR2、资源预算与退出清理边界保留。
A mouse-themed, offline Windows file converter. / 一款鼠鼠主题、可离线使用的 Windows 文件格式转换工具。
作者 Author:牢蜂(LaoFeng)
> ⚠️ 非商用声明 Non-Commercial Notice:本软件仅供个人免费使用,禁止任何形式的商业售卖、转卖、套壳换皮重新发布(详见 LICENSE)。发现闲鱼/淘宝等渠道倒卖请告知作者,感谢!

Release CI Platform License

下载最新版 / Download · 问题反馈 / Issues

FlyingMouse Format mouse UI

中文

主要功能

渠道与使用范围:仅支持普通音乐格式转换,不支持其他音乐平台的加密特殊格式。请支持正版音乐,尊重创作者。音频版权归原作者/唱片公司,本工具与各音乐平台无任何关联。仅供个人免费使用,禁止商业售卖、转卖和套壳。

快速开始

2026-11-04 发布的 0.8.3 Windows 完整版已完成入口、Runtime 和 ASAR 整体重建,完整测试 1,368 通过、0 失败、11 条件跳过,生产与全量 npm 审计均为 0 告警;17 组实际界面场景及安装包载荷校验通过。这些结果属于 0.8.3;0.8.4 商店候选另行完成了整体构建、本地转换与包核验,尚未公开,独立结果见现役交接。

1. 在 v0.8.3 Release 下载 v0.8.3 对应系统的安装包:本次提供 Windows 10/11 x64 完整版。可用同页的 SHA256SUMS.txt 校验下载。 2. 安装并启动 FlyingMouse Format。 3. 拖入文件,选择目标格式并开始转换。 4. 选择保存位置;软件会记住目标格式与保存目录。

从源码运行:

主线要求 Node.js 22.13.0 或更新版本。在独立物理目录中执行 npm ci,安装结束会自动核验并应用四份已记录的兼容补丁,构建前再次检查;补丁内容与上游许可证见 依赖补丁说明。Windows 7 使用独立环境与锁文件。

源码仓库不包含体积较大的 FFmpeg、LibreOffice、Poppler 和 Tesseract 资源;普通用户请直接下载 Release 安装包。开发者从源码运行完整转换功能前,需要自行准备 bin/ 下的引擎资源。

Windows 10/11 x64 的 CR2 引擎另用 npm run restore:libraw 恢复。脚本从锁定的 LibRaw 与微软官方归档下载、校验 SHA-256 并解包到 bin/libraw,不会运行系统安装器。完整构建和验证步骤见 发布流程。

npm ci
npm run desktop

命令行示例:

node cli.js capabilities --json
node cli.js targets example.pdf --json
node cli.js convert input.docx --to pdf --output output.pdf --json
node cli.js convert a.png b.png --to webp --output-dir converted --json
node cli.js images-to-pdf 1.jpg 2.jpg --output album.pdf --json
node cli.js merge-pdfs a.pdf b.pdf --output merged.pdf --json

安装版也可直接调用应用入口:macOS 使用 FlyingMouse Format.app/Contents/MacOS/FlyingMouse Format --cli ...,Windows 使用 FlyingMouse Format.exe --cli ...。在软件顶部点击“接入 Agent”,会检索已存在的 ~/.codex/skills、~/.claude/skills、~/.agents/skills(Windows 对应用户目录)并在确认后安装或更新 skill;不会自动创建未安装产品的目录。

通用测试与打包命令(不会因阅读本文自动执行):

npm test
npm run dist

Windows 版本选择

0.8.4 已构建并本地验收商店 MSIX 候选,尚未上传或发布。本轮未生成标准 NSIS FlyingMouse Format-Setup-0.8.4-x64.exe 或 Win7 派生包 FlyingMouse Format-Setup-0.8.4-win7-x64.exe;这些名称仅为构建目标。以下 0.8.3 记录保留其原发布与构建状态。

Windows 7 兼容版是 Legacy 构建,不会降低标准版依赖。其 Electron 22 已停止上游安全维护,并包含无法在 Windows 7 上直接升级的已知依赖风险;PDF.js 动态代码执行已通过 isEvalSupported: false 缓解,但仍只建议离线处理可信文件。v0.8.3 的验收进度以修复记录为准;Win7 构建及真实 Windows 7 SP1 x64 设备仍待验收。Windows 安装包均未签名,SmartScreen 可能提示。

macOS 版本选择

macOS 构建目标为 macOS 11 及更新版本,未签名且未公证,可能触发 Gatekeeper。0.8.3 发布源码及 0.8.4 候选的 macOS x64/arm64 引擎与代码 CI 均已通过,但两个版本均未构建或发布 macOS 安装包,真实 Mac 设备仍待验收;CI 不能替代安装包与设备验收。

Win7 Legacy 构建命令:

npm run dist:win7

Win7 staging 使用专用 win7-package-lock.json 和 npm ci 重建;推荐使用 Node.js 22 LTS(构建脚本接受 18–22,其他主版本会在改动 staging 前拒绝)。构建脚本会绑定子进程到当前 Node、以 Unicode 安全方式复制源码、锁定 staging manifest/lockfile,并校验本地 builder 与打包资源没有越过各自允许的根目录或经过 junction/符号链接。

仅需检查 staging 时可运行 node scripts/build-win7.js --prepare-only;它不会打包。完整构建会重新准备 staging。

English

Highlights

Build scope: ordinary audio conversion only; encrypted proprietary music-platform formats are not supported. Please support artists and respect copyright. Audio copyrights belong to their respective artists/labels; this tool is not affiliated with any music platform. Free for personal use only; commercial resale or repackaging is prohibited.

Quick start

The 0.8.3 Windows full build released on November 4, 2026 has a rebuilt launcher, Runtime and ASAR. Validation recorded 1,368 passing tests, zero failures and 11 conditional skips, zero production/full npm audit findings, 17 GUI scenarios, and verified installer payloads. These results apply to 0.8.3. The 0.8.4 Store candidate has separate rebuild, local conversion and package verification results in the current handoff; it has not been publicly released.

1. Download the Windows 10/11 x64 full installer from v0.8.3 Release. Verify it with the accompanying SHA256SUMS.txt if desired. This release does not include new Lite, Win7, macOS or Microsoft Store packages. 2. Install and launch FlyingMouse Format. 3. Drop in files, choose a target, and convert. 4. Choose a save location. The app remembers both the target preference and save folder.

The source repository excludes the large FFmpeg, LibreOffice, Poppler, and Tesseract bundles. Regular users should install the Release build. Developers need to provide the corresponding resources under bin/ for the complete conversion feature set.

The main development environment requires Node.js 22.13.0 or newer. Run npm ci in a physical project directory: installation verifies and applies four documented compatibility patches, and packaging verifies them again. See the patch notice for changes and upstream licenses. Win7 keeps its separate environment and lockfile.

CLI examples:

node cli.js capabilities --json
node cli.js targets example.pdf --json
node cli.js convert input.docx --to pdf --output output.pdf --json
node cli.js convert a.png b.png --to webp --output-dir converted --json
node cli.js images-to-pdf 1.jpg 2.jpg --output album.pdf --json
node cli.js merge-pdfs a.pdf b.pdf --output merged.pdf --json

Packaged builds accept the same commands after --cli: use FlyingMouse Format.app/Contents/MacOS/FlyingMouse Format --cli ... on macOS or FlyingMouse Format.exe --cli ... on Windows. “Connect to Agent” discovers existing Codex, Claude, and generic Agent skill directories and installs the bundled lightweight wrapper after confirmation.

Choose a Windows build

The 0.8.4 Store MSIX candidate has been built and locally validated, but not uploaded or released. This round did not produce the standard NSIS target FlyingMouse Format-Setup-0.8.4-x64.exe or the Legacy target FlyingMouse Format-Setup-0.8.4-win7-x64.exe. The 0.8.3 entries below retain their original release and build status.

The Windows 7 package is a Legacy build and does not downgrade the standard build. Electron 22 no longer receives upstream security maintenance, and other known legacy dependency risks cannot be upgraded without dropping Windows 7. PDF.js dynamic evaluation is disabled as a mitigation, but this build should remain offline and process trusted files only. See the current handoff for this source branch's validation; Win7 builds and physical Windows 7 SP1 x64 acceptance remain pending. The published Windows installer is unsigned and may trigger SmartScreen.

Choose a macOS build

macOS builds target macOS 11 or newer and are unsigned and unnotarized, so Gatekeeper may warn. The 0.8.3 release source and 0.8.4 candidate passed macOS x64/arm64 engine and code CI, but neither version has a built or released macOS installer. Physical Mac acceptance remains pending; CI does not replace package or device validation.

Win7 Legacy build command:

npm run dist:win7

The Win7 staging tree is rebuilt with its dedicated win7-package-lock.json via npm ci. Node.js 22 LTS is recommended (host majors 18–22 are accepted; other majors fail before staging changes). The script binds child processes to the active Node, copies sources safely on Unicode paths, binds the staged manifest/lockfile, and rejects local builder or packaged resources that escape their allowed roots or traverse junctions/symlinks.

Use node scripts/build-win7.js --prepare-only only to inspect staging without packaging. A complete build prepares staging again.

Supported formats / 支持格式

| Category / 类别 | Input / 输入 | Output / 输出 | |---|---|---| | Images / 图片 | jpg, png, webp, avif, tiff, gif, bmp, svg, ico, tga, heic, heif, cr2, cr3, crw, nef, arw, dng, raf, rw2, orf, pef, srw, 3fr, erf, fff, iiq, kdc, mef, mrw, x3f | png, jpg, webp, avif, tiff, gif (动图), ico (16–256 px), pdf, txt (OCR), mp4, webm | | Text / 文本 | txt, md, html, json, csv, log, xml, yaml | txt, md, html, json, csv, pdf, docx, epub | | E-book / 电子书 | epub, mobi | txt, md, epub (mobi→epub 实验性) | | Word/WPS | doc, docx, odt, rtf, wps, wpt, wpd | pdf, docx, odt, rtf, txt, html, md | | OFD | ofd | pdf;支持基本文字、PNG/JPEG 图片和矢量路径;复杂签章、裁剪等未实现内容明确报错,逐页检查意外空白 / basic text, PNG/JPEG and paths; unsupported content is rejected and unexpected blank pages are checked | | Excel/WPS | xls, xlsx, xlsm, ods, csv, tsv, et, ett | pdf, xlsx, xls, ods, csv, html | | PPT/WPS | ppt, pptx, odp, dps, dpt | pdf, pptx, odp, html, png, jpg (逐页转图 zip) | | PDF | pdf | xlsx, docx, txt, html, png, jpg, split/解密 PDF | | Audio / 音频 | mp3, wav, flac, m4a, aac, ogg, opus, wma | mp3, wav, flac, m4a, ogg, aac, opus, wma | | Video / 视频 | mp4, mov, mkv, webm, avi, m4v, wmv, flv | mp4, webm, mkv, mov, gif, mp3, wav, flac, m4a, ogg, aac, opus, wma | | ZIP / 压缩包 | zip | pdf (图片合并) | | Any file / 任意文件 | any | zip |

Privacy and security / 隐私与安全

License / 许可证

非商用许可 Non-Commercial License — 作者:牢蜂(LaoFeng)。

完整条款见 LICENSE。/ Full terms in LICENSE.

发现任何渠道倒卖本软件,欢迎通过 GitHub Issues 联系作者举报。

Support / 支持

FlyingMouse Format is free, offline, and has no ads. If it helped you, you can buy Mouse a dried fish — completely optional. / 飞鼠格式免费、离线、无广告。如果它帮到了你,欢迎请鼠鼠吃根小鱼干,纯自愿。

WeChat payment QR / 微信收款码

GitHub Stars & Activity

7,074Stars
576Forks
66Open issues
JavaScriptLanguage

GitHub Popularity

GitHub stars7,074
Forks576
Open issues66
Primary languageJavaScript
LicenseNOASSERTION
Stars gained today0
Created2026-08-06
Last pushed2026-11-09

Trending History

Trending statusnot on today's boards

Related GitHub Projects

1

alyssaxuu / screenity

JavaScript★ 18,998⑂ 0
→
2

lemomo-ai / lemo-opuscar

JavaScript★ 17,510⑂ 0
→
3

aandrew-me / ytDownloader

JavaScript★ 10,694⑂ 0
→
4

kaomei / stickman-video-director

JavaScript★ 6,696⑂ 0
→
5

vvo / gifify

JavaScript★ 6,331⑂ 0
→
6

darkzOGx / youtube-automation-agent

JavaScript★ 5,250⑂ 0
→
7

spite / ccapture.js

JavaScript★ 3,782⑂ 0
→
8

Kagami / ffmpeg.js

JavaScript★ 3,462⑂ 0
→

More Trending Repositories