FEATURES & SUPPORT

Put your file workflow
back in order.

Find, inspect, edit, move. VeloFiler is a dual-pane file manager for macOS that handles local files and SSH servers with the same keyboard-driven flow.

macOSDual paneVim keysOne-time purchase US$9.99

AT A GLANCE

One screen, no interruptions

VeloFiler is more than a file list: previews, remote connections, text editing and quick notes all share a single operation model.

Dual pane + Vim keys

Compare both sides while you work: j/k/h/l, Tab, marking, copy and move — all keyboard-first.

Instant previews

Check images, video, audio, PDF, Office, Markdown and code before opening anything. Grid view (i) shows the whole folder as thumbnails.

Local and SSH feel the same

Just pick a Host from ~/.ssh/config. Remote listing, previews, renames and transfers all happen in the same window.

QUICK START

These four steps are all you need

01
Move
j/k to move between rows, h to go to the parent, l or Enter to open.
02
Inspect
P toggles the preview, i switches list ⇄ grid (thumbnails). Press Space to play or pause video.
03
Connect
gs opens the SSH host picker; once connected, copy and move files between the remote and your local pane.
04
Take notes
gN creates a note, gn lists them. Everything autosaves, with history.

FEATURES

Feature overview

From everyday file chores to inspection work in development and content production.

File operations

New files and folders, rename, trash, copy, move, paste and undo. For long names, gP shows the full path.

Works on local and SSH remotes alike

Previews

Markdown renders GFM tables, task lists, footnotes, math, Zenn syntax, Mermaid and highlighted code — entirely locally. Video, audio, PDF and Office use macOS Quick Look.

Large SSH files are streamed

SSH / SFTP

Uses your existing SSH setup via ssh-agent or IdentityFile. Idle disconnects reconnect automatically before your next action, and editing, creating, renaming and deleting on the remote are supported.

Up to 3 reconnect attempts · Password prompts and ProxyJump are not supported

Built-in text editor

Switch Standard / Vim input with Ctrl-Shift-V. Japanese IME, search, undo/redo, and editing of both local and SSH files.

Your editor choice is saved to settings

Built-in notes

Create, edit, rename, delete and keep history across multiple notes. Notes are Markdown with autosave; the first line becomes the title, or pin one with r.

Location, history size and autosave interval are configurable

Settings & permissions

config.toml controls fonts, editor mode, note location and more. External folders such as Dropbox trigger the standard macOS permission prompt on first access.

Absolute paths / ~ / paths relative to the config file

Grid (thumbnail) view

Toggle list ⇄ grid with i. JPEG, PNG, HEIC, WebP and more are shown in EXIF orientation; j/k steps through every file, ↑/↓ moves by row, ←/→ sideways. Columns adapt to pane width.

View mode is remembered per pane

Cloud storage

gc or :cloud detects iCloud Drive plus Dropbox, Google Drive and OneDrive sync folders. Select one to open it in the active pane.

macOS asks for permission on first access

KEY REFERENCE

Key cheat sheet

VeloFiler is keyboard-first, but the main actions are always visible in the status bar and the ? help.

Key	Action	Key	Action
`j / k`	Move down / up	`Tab`	Switch pane
`h / l`	Parent / open	`Enter`	Enter folder / preview
`P`	Toggle preview	`Space`	Play / pause video
`gs / gS`	SSH connect / disconnect	`gP`	Show full path
`i`	List ⇄ grid view	`gc`	Go to cloud storage
`gn / gN`	Notes list / new note	`?`	Help

The complete key map is always available inside the app via the ? help.

FAQ

Frequently asked questions

Can I keep my notes in Dropbox?

Yes. Set directory = "~/Dropbox/VeloFilerNotes" under [notes] in the config file. macOS will ask for folder access once.

Are Vim settings separate for files and notes?

Yes. Regular files use editor_mode, notes use [notes].editor_mode. Switching with Ctrl-Shift-V inside a note saves the default for notes only.

Does SSH support password authentication?

Currently VeloFiler uses ssh-agent or a passphrase-free IdentityFile. Password/passphrase prompts and ProxyJump are not supported.

Will the SSH connection drop when idle?

Connectivity is checked before each operation, and a dropped session reconnects automatically (up to 3 attempts). Read operations such as listing and previews retry once after reconnecting. For safety, writes and deletes that may have partially completed are never retried automatically.

How do I report a bug?

Please leave a review on the “VeloFiler” App Store page. Including your macOS version, the last action you took, and whether it involved local files or SSH makes investigation much easier. For purchase or refund questions, use Apple’s Report a Problem. Never include private keys, passwords or personal data.