Support
For VeloUtils for macOS.
Email support@veloutils.app with any question, bug or suggestion. VeloUtils is a one-person project, so a reply may take a few days, but every message is read.
Reporting a bug
Four things make a report actionable. Please include them if you can:
- Your macOS version — Apple menu › About This Mac.
- The VeloUtils version — VeloUtils › About VeloUtils.
- What you did, what you expected, and what happened instead.
- A small file that reproduces it, if the problem depends on the document. Send only a file you are happy to share — see the privacy policy for what the app itself does with your documents, which is nothing beyond reading them on your Mac.
Reporting a security issue
Send security reports to support@veloutils.app
with SECURITY in the subject line. Please do not post the detail publicly
until a fix has shipped. We will confirm receipt and tell you what we find.
Common questions
How do I save my edits?
You cannot, and that is deliberate for this version. VeloUtils opens and reads your files; it does not write back to them. The Markdown, JSON and Mermaid panes, and the inputs of the Encode / Decode and JWT tools, are editable so you can work on the text and see the result, but quitting the app discards those edits. Closing the window does not: Window › VeloUtils, a click on the Dock icon, ⌘O or opening a file brings the same window back, with its tool and its text. The one thing the app writes is the Mermaid tool's Export, which creates a new PNG or SVG at a location you pick.
To get your work out, use the Copy button in the JSON, CSV, Mermaid, Encode / Decode and JWT tools, or the one beside each row of the Timestamp tool. The Markdown editor has no Copy button — select the text and press ⌘C.
Which files can VeloUtils open?
| Markdown | .md, .markdown, .mdown,
.mkd, .mkdn, .txt, .text |
|---|---|
| JSON | .json |
| CSV | .csv, .tsv |
| Mermaid | .mmd, .mermaid |
Press ⌘O or use each tool's Open button. The Markdown, CSV and Mermaid tools also open a file you drag onto them, anywhere on the tool; the JSON tool does not. The Timestamp, Encode / Decode and JWT tools work on text you paste or type and open no files, so File › Open… is turned off while one of them shows.
Finder's Open With and open -a VeloUtils also work, and
switch the sidebar to the matching tool. Those routes cover the types VeloUtils
registers with macOS — Markdown, JSON, CSV, TSV, .mmd and
.mermaid. Plain .txt files are not registered, so open those
from inside the app.
Keyboard shortcuts
| ⌘O | Open a file in the active tool, in the tools that open files |
|---|---|
| ⌘⌥P | Markdown and Mermaid: hide or show the source pane |
| ⇧⌘F | JSON: switch the output to Format |
| ⌘F | Find in the editor that has focus. JSON: the toolbar search, which searches both panes. Markdown: whichever pane has focus |
| ⌘G / ⇧⌘G | Next and previous match. Markdown: in the preview |
| ⌘Z | Undo in any editor |
| ⌘C | CSV: copy the selected rows as tab-separated text |
| Pinch or drag | Mermaid: zoom and pan the diagram |
Does the app send my data anywhere?
No. The app has no account, no analytics and no server. The single exception is that the Markdown preview fetches a remote image if your own document references one, the same as a browser would.
This website is a separate matter: it counts visits anonymously, without cookies. The privacy policy covers both.
Why does a Mermaid diagram stay on screen when my source is broken?
Because that is more useful than a blank pane. VeloUtils validates the source before it renders, so a half-finished edit leaves the last good diagram in place, dimmed, while an error names the line to fix.
Which macOS do I need?
macOS 26.0 (Tahoe) or later, on Apple silicon or Intel.
Known limits
These are real and we would rather you heard them here than found them:
- The app cannot save changes back to a file. See above.
- The CSV grid stays comfortable to about 10,000 rows. Parsing a larger file is fast, but filtering and sorting it is done on every redraw.
- The Markdown renderer is hand-written rather than a full CommonMark implementation. Setext headings, reference-style links and footnotes are not supported.
- The JSON tool holds the whole document in memory and revalidates all of it as you type. It is not built for very large payloads.
- Opening several files at once from Finder loads only the first one.
- A very large Mermaid diagram is bounded by what the Mermaid library itself can lay out.
Licences
VeloUtils' own code is MIT-licensed. The bundled Mermaid library folds in 76 open-source packages; the full notices ship inside the app under Help › Acknowledgements.