FlyingMouse Format
Use the bundled wrapper at scripts/flyingmouse-format.js. It locates the FlyingMouse Format application configured by the in-app “Connect to Agent” action and invokes its CLI.
Workflow
Check available targets before an unfamiliar conversion:
node scripts/flyingmouse-format.js targets <file> --jsonConvert one or more independent files:
node scripts/flyingmouse-format.js convert <files...> --to <format> --output-dir <directory> --jsonMerge images into one PDF:
node scripts/flyingmouse-format.js images-to-pdf <images...> --output <result.pdf> --jsonMerge PDFs:
node scripts/flyingmouse-format.js merge-pdfs <pdfs...> --output <result.pdf> --jsonInspect the connected application's engines and limits:
node scripts/flyingmouse-format.js capabilities --jsonUse
toolDetails.libreoffice.statusandtoolDetails.pdfStructurewhen available. Office preparation may be pending while other conversions remain available; the Lite edition omits the advanced scanned-table engine. Check runtime targets and limits before selecting a conversion, because the connected application may be an older installation.
Conversion expectations
- When the connected app exposes these targets, SRT, VTT, ASS and SSA can convert between each other or export TXT; images can use OCR to create DOCX or Markdown, and PDFs can export Markdown.
- Image OCR outputs editable text. PDF Markdown may retain simple headings and tables, but these outputs do not guarantee the original layout or illustrations. Multi-page TIFF OCR processes each page; animated image input uses the first frame and returns a warning.
- Read
outputs[].warningsalongsideoutputs[].pathand communicate review, layout, subtitle-style or timing-loss warnings to the user. Do not describe a successful output with warnings as a verified exact reproduction. - With
--json, conversion failures are reported on stderr with a nonzero exit code. PreserveerrorCodefor diagnosis; do not hide low OCR confidence, missing-engine or resource-limit errors with an unverified success claim.
Options
- Video:
--video-codec h264|h265|av1 - PDF:
--pdf-action encrypt|decrypt --password <password> - Prefer
--jsonand readoutputs[].pathfrom stdout. - Never echo or log a PDF password.
- Preserve the user's requested output directory and do not overwrite existing files without permission.
If the wrapper reports that FlyingMouse Format is missing, ask the user to open the application and use “Connect to Agent” again.