Repository avatar
Other Tools
v0.1.1
active

swirvo

io.github.Nabarup1/swirvo

Convert files, run 59 PDF/document tools and read text (OCR) locally on Windows. Nothing uploaded.

Documentation

Swirvo icon

Swirvo

Drag. Tap. Convert. A fast, private file converter and PDF toolkit for Windows.
Everything runs on your PC: no upload, no account, no telemetry.

Download for Windows · Watch the 50-second demo · Features · For AI assistants · Build from source

The Swirvo wheel: tap Shift while dragging a file and drop it on a format

How it works

  1. Start dragging any file: in File Explorer, on the desktop, anywhere.
  2. Tap a key while you hold it: Shift for formats, Ctrl for tools, Alt for actions.
  3. Drop it on a wedge. The result is saved next to the original, usually before you've let go of the mouse. Your original is never changed.

No dialog, no app to open, no website to upload to.

What it can do

The Board is the full workspace behind the wheel. Drop in a whole folder, give every file its own target format and convert them all at once, in parallel across your CPU cores. Search any format or tool with Ctrl+F.

The Board converting a folder of files, each to its own format

About 96 formats (138 file extensions)

CategoryHighlights
ImagesPNG, JPG, WebP, TIFF, BMP, GIF, ICO, TGA, QOI; also opens SVG, JPEG XL, HEIC, AVIF, PSD and camera RAW
DocumentsPDF, DOCX, ODT, RTF, EPUB, Markdown, HTML, TXT. PDF → Word rebuilds the layout (fonts, columns, tables, pictures). Word, Excel and PowerPoint → PDF without Office installed, optionally as PDF/A or tagged PDF
DataXLSX, CSV, TSV, JSON, YAML, TOML, XML, NDJSON; PDF tables → Excel
MediaMP4 → MP3 and other audio through Windows' built-in media engine; video compression to a target size; FFmpeg is used automatically if you have it
OtherFonts (TTF, OTF, WOFF, WOFF2), subtitles (SRT, VTT, ASS), archives (ZIP, TAR, GZ, XZ, BZ2, ZST; 7Z, RAR and ISO through Windows)

59 tools, 35 of them for PDF:

  • PDF: merge; split by page, every N pages, at bookmarks, by size or into your own page ranges; rotate; pick, reorder and delete pages; pages → images; compress; page numbers; header and footer; Bates numbering; watermark; password protect and unlock (AES-256); trim, crop, resize; N-up and booklet; remove hidden data; repair; bookmarks from headings; save pictures and attachments; OCR to make scans searchable; redaction that removes the text, not just covers it; grayscale; form fields to a spreadsheet, fill forms per row, flatten; compare; digital signatures with your own certificate, and verifying them; PDF/A.
  • Word: compress, clean author and tracked changes, find and replace, save pictures, word count, mail merge.
  • Images: resize, fit 1920, rotate, flip, compress, strip GPS and camera info, images → one PDF.
  • Video: save a frame, compress to a size.
  • Files: extract archives, test an archive, SHA-256 checksum, to ZIP, copy text (with OCR for photos and scans).

Live previews: watermark, crop, redaction, page numbers and more show the result before you save. Drag the watermark where you want it; crop every page or just one.

Live preview of a watermark on a PDF

Private and safe by design

  • Nothing leaves your PC. No network code, no account, no ads, no analytics. See the privacy policy.
  • Originals are never modified. Results are new files, written atomically, never overwriting anything.
  • Sandboxed conversions. Every conversion runs in a separate worker process with a memory cap, so a damaged file can't take the app down.
  • No admin rights needed, no drivers, no services. Uses what Windows already has (OCR, image codecs, Media Foundation, tar.exe) instead of bundling big libraries.

Download

Get the latest release:

  • Windows 10 (1809 or later) and 11, x64: Swirvo-<version>-windows-x64.zip. Unzip, double-click Swirvo.exe, and it offers to install itself for your user (Start menu, Settings → Apps, start with Windows; no admin). The Swirvo icon appears in the notification area.
  • Linux x64: swirvo-cli-<version>-linux-x64.tar.gz, the swirvo command-line tool. The Linux desktop app (wheel and Board) isn't ready yet.

"Windows protected your PC"? The downloads aren't code-signed yet, so SmartScreen warns about them. Click More info → Run anyway. A Microsoft Store version, signed by Microsoft, is on the way.

Command line

swirvo convert report.pdf --to docx
swirvo tool pdf-merge a.pdf b.pdf
swirvo tools photo.jpg
swirvo formats --supported

Use it from AI assistants (MCP)

Claude Desktop: download Swirvo-<version>.mcpb from the latest release and double-click it. That's it.

Other assistants: swirvo mcp turns Swirvo into a local MCP server, so Claude Desktop, Claude Code, Cursor, VS Code and other AI assistants can convert files, run the PDF tools and read documents (with OCR) on your PC. No API key, nothing uploaded, originals never touched.

{
  "mcpServers": {
    "swirvo": {
      "command": "swirvo",
      "args": ["mcp"]
    }
  }
}

Tools: convert_files, run_tool, extract_text, list_tools, list_formats, detect_format. Listed in the official MCP Registry as io.github.Nabarup1/swirvo; a Claude plugin with a usage skill is in plugin/. Setup for each client: docs/19.

Build from source

Rust (stable, 2024 edition) on Windows or Linux:

cargo build --release -p swirvo-cli
cargo run -p swirvo-cli -- convert photo.png --to webp

The Windows app (swirvo-agent, shipped as Swirvo.exe) builds natively on Windows with the MSVC toolchain:

cargo build --release -p swirvo-platform-win -p swirvo-cli

From WSL, scripts/build-windows-exe.sh builds a standalone dist/Swirvo/ using the Windows-side Visual Studio Build Tools. Releases are built by GitHub Actions from a version tag.

Checks: cargo fmt --all, cargo clippy --workspace --all-targets --all-features -- -D warnings, cargo test --workspace, cargo deny check. See CONTRIBUTING.md and PROJECT_GUIDE.md.

How it's built

A Rust workspace with its own engines and its own UI toolkit (no web view):

CrateWhat it does
crates/formatsFormat registry and content detection (signature trie, container probes, text sniffing)
crates/graphConversion planner: Dijkstra per quality preset over a capability graph, with route explanations
crates/wheelWheel geometry, hit-testing, gesture state machine, frecency with stable slots (property-tested)
crates/enginesPure-Rust engines: images, PDF, the PDF → DOCX layout rebuilder, the DOCX/XLSX/PPTX → PDF layout engines, data, fonts, archives, plus the Windows OS engines
crates/jobsParallel batches, the tools, never-overwrite naming, atomic commits, the sandboxed worker
crates/render, crates/uiThe wheel renderer and a small immediate-mode UI toolkit on tiny-skia
crates/boardThe Board, the page picker and the live previews
crates/platform/winThe Windows app: Raw Input triggers, the OLE drag probe, the layered wheel window, tray, installer
crates/cliThe swirvo command-line tool and the MCP server (swirvo mcp)

Design docs:

DocWhat's inside
01 · Product specPersonas, principles, ways to invoke the app, the catalog of conversions, tools and actions
02 · UX & UI specWheel anatomy, gestures, state machine, motion, accessibility, screens, design tokens
03 · System architectureProcess model, crate layout, job lifecycle, workers and sandboxing, storage, security
04 · AlgorithmsFormat detection, conversion planning, frecency, radial hit-testing, scheduling, PDF reconstruction
05 · Conversion enginesTechniques per category, default settings, the engine matrix with licences
06 · Platform integrationThe Windows gesture pipeline, overlay compositing; the Linux plan for X11 and Wayland
07 · Performance, testing & releaseLatency budgets, test strategy, fuzzing, CI
08 · Roadmap & risksPhases and risk register
10 · Formats & conversionsEvery format and conversion, and how each is done
11 · Tools & featuresTools and actions on the wheels and the Board
12 · Board & UIThe Board, the page picker, the UI toolkit
13 · PDF reconstructionPDF → DOCX that keeps the layout
16 · DOCX → PDFThe built-in Word layout engine
17 · PDF and document toolsCompress, stamps, pages, protection, clean-up, the options system
19 · AI assistants (MCP)swirvo mcp: tools and setup for Claude Desktop, Claude Code, Cursor, VS Code

Licence

  • The app (the official downloads and the Microsoft Store version) is free to use, at home and at work: EULA.md.
  • The source code is available under the PolyForm Noncommercial License 1.0.0: you may read, build, change and share it for any noncommercial purpose. Commercial use of the code needs a separate licence from the author; ask through Issues.
  • The name Swirvo and its logo are not licensed for use by others: TRADEMARKS.md.
  • Open-source components keep their own licences, listed in THIRD-PARTY-NOTICES.txt with every download.

Product and format names (Microsoft Word, Excel, PowerPoint, Windows, PDF and others) belong to their owners and are used only to describe compatibility. Swirvo isn't affiliated with or endorsed by any of them.

Made by Nabarup Ghosh.

MCPB
https://github.com/Nabarup1/swirvo/releases/download/v0.1.1/Swirvo-0.1.1.mcpb
Install Command
# mcpb: https://github.com/Nabarup1/swirvo/releases/download/v0.1.1/Swirvo-0.1.1.mcpb