What's New

Bug fixes

• Fixed farman not restarting on Windows when you pressed "Restart farman" after updating a plugin.
• Fixed the Markdown viewer showing the whole document in large bold type, as if it were a heading, when you switched a document that starts with a heading to the source view.

Install plugins inside the app

• The new Settings → Plugins page lets you install, update and uninstall external plugins in one place. You no longer have to copy files into the plugin directory by hand.
• Drag and drop a plugin file onto the page, or pick one with "Install from File...", to install it.
• Official plugins can be installed or updated right from the list with "Install" / "Update". "Check for Updates" looks up the latest versions, and plugins with an update are marked with ❗ in bold.
• Installs, updates and uninstalls take effect the next time farman starts. Use the "Restart farman" button on the page to restart right away.
• You can also open this page from Help → "Plugins..." (Ctrl+Shift+P) or the toolbar. The Settings pages are now numbered 4. Plugins / 5. Viewer / 6. Archive, and so on.

Tips on startup

• farman now shows a usage tip once a day on startup, introducing shortcuts and easy-to-miss features one at a time.
• Browse the tips with "Previous" / "Next". Keys in the text follow your current keybindings.
• Open them any time from Help → "Tips...". To stop showing them on startup, uncheck the box at the bottom left of the dialog or in Settings → General.

Run copy and move in the background

• The progress dialog for copy and move now has a "Run in Background" button. A long copy or move keeps running while you go back to other work.
• While it runs, the status bar shows its progress. Click it to bring the progress dialog back, where you can also cancel.
• Only one operation can run in the background at a time. While it runs, file operations (copy, move, delete, rename and so on) on its source and destination directories are not allowed.
• The progress dialog no longer closes with Esc while an operation is running. Use Cancel to stop it.

Image viewer

• Click the copy button on the toolbar or press Cmd+C (Ctrl+C on Windows / Linux) to copy the displayed image to the clipboard. A rotated image is copied in the orientation you see.
• Animated images (GIF / WebP) can now be stepped frame by frame. Type a number into the frame box on the toolbar, or use its arrows or the , and . keys to move to the previous or next frame.
• Pausing an animation now stops on the current frame. A separate "Stop" button (S key) returns to the first frame.
• Copying an animated image copies the frame being displayed (playback is paused first).

Sort and filter

• Fixed temporary settings (applied without "Override defaults for this directory") appearing as the defaults when the dialog was reopened.
• When the dialog opens with settings that differ from the defaults, it now says whether they are saved or temporary, and which items differ.
• The sort / filter line under each pane now starts with [Default] / [Temporary] / [Custom] (saved for this directory), so you can tell which settings are in effect. It also shows how dot files are handled (Dot-first / Dot-ignored).
• With "Sort dot files first" turned off, dot files are now sorted by their name without the leading "." (.bashrc sorts among the b's).

Cursor movement in text fields

• In single-line fields such as Rename, New, Create Archive, Bulk Rename and the search name pattern, Up now moves the cursor to the start and Down to the end. Hold Shift to extend the selection.
• In file names, Down before the "." stops just before it, and Up after the "." also stops just before it. The search name pattern is space-separated, so Down jumps to the start of the next pattern.
• You can turn this off under Settings → General ("Move cursor by delimiter with Up/Down in text fields"). It is on by default.

Rename

• When several files are selected, Rename (r) now renames them one by one in order (it used to rename only the cursor row). The title shows progress such as "(1 / 3)", and cancelling stops the rest.
• The Bulk Rename template field is now a drop-down of past templates. The last 10 templates you used are remembered (the default and duplicates are not). Press Down with the cursor at the end to open the history.

Size display

• Settings → Behavior "List Display" is now "Display Formats", and sizes outside the file list (selection total, disk free space, transfer progress, properties, preview, viewer and search results) can be shown as Bytes, KB/MB/GB (1000) or KiB/MiB/GiB (1024). The default is KB/MB/GB.
• The selection total, which was shown in KiB/MiB, now follows this setting.

Settings

• The viewer display mode (in the main window / separate windows) has moved from the "Behavior" page to the "Viewer" page.
• Check boxes on the "General" and "Behavior" pages are laid out in two columns so they are easier to scan.

Log pane

• Click the log pane to focus it, then press Cmd+C (Ctrl+C on Windows / Linux) to copy the selected text to the clipboard. Cmd+A (Ctrl+A) selects the whole log.

Bug fixes

• Fixed the right-click menu of the log pane, path fields and other text fields appearing in English on Windows / Linux even when the UI was set to Japanese.
• Fixed the selected row in the lists on the settings pages (Plugins, Viewer and so on) not being highlighted across the whole row on Windows.
• Fixed the Size column in search results using the OS language for its units (such as "36 バイト") even when the UI was set to English.

Overwrite confirmation for copy and move

• The overwrite dialog has a new "Apply this choice to all remaining conflicts" check box (Alt+A, ⌥A on macOS). Tick it and press OK, and the rest of that copy or move uses the same choice (overwrite / rename / skip) without asking again. If you chose "Rename to", the remaining conflicts are named with the auto-rename template. The choice lasts only for that operation and is not saved in Settings.
• "Skip this file" used to cancel the whole operation. It now skips just that file and carries on. Skipped files still count toward the progress, so the operation finishes at 100%.
• The Source / Destination rows in the dialog are now aligned with the heading for easier reading.

Disk space in the status bar

• The status bar was showing disk space as GiB (1024-based) values. It now shows GB (1000-based) values. Note that the free space is what the OS reports as actually free; it does not include the "purgeable" space that macOS counts in "Available".

Bug fixes

• Fixed the disk usage in the status bar showing a doubled percent sign, such as "23%% used".
• Fixed the "(⌥O)" hint on the Search button disappearing while a search was running and after it finished.
• Fixed a typo in the Japanese label of "Sync Active Pane to Other" in the View menu.

New "Archive" tab in Settings

• You can now see every supported archive format in one list and turn each one on or off. Built-in formats and formats provided by archive plugins appear in the same list.
• "Details..." on each row lets you change the file patterns and the defaults used when creating an archive (compression level, encryption method, file name encoding). Formats that farman cannot create show no creation settings.
• The temporary extraction directory, the number of password attempts, and the maximum nesting depth for archives inside archives are all configurable here.

More archive formats

• Added 7-Zip, RAR, ISO9660, Microsoft Cabinet, xar / pkg, cpio, ar / Debian package, and TAR combined with Zstandard / LZ4 / LZMA / lzip / compress.
• A single file compressed with gzip, bzip2, xz, LZMA, Zstandard, LZ4 or compress can now be opened as an archive containing one entry.
• The added formats are enabled by default. Turn off any you do not need in Settings → Archive.

Settings reorganized

• The "Plugins" tab is gone. Viewer plugins are now managed in the new "Viewer" tab, and archive plugins in the "Archive" tab.
• "Allow loading external plugins" and the plugins directory moved to the "General" tab.
• In both lists you can toggle a row directly with its checkbox, or switch everything at once with "Enable all".

File patterns

• Viewers and archives used different names and formats for the same thing. They are now both "File patterns", and in addition to plain extensions you can write:
  • mp4 … an extension (as before)
  • *.tar.gz … a compound extension
  • Makefile … a file with no extension
• Extensions you added or removed in the settings did not always affect which viewer was chosen. They now take effect as written.
• The built-in defaults are now written in pattern form (*.png) as well. Your existing settings are converted automatically on upgrade.

Archives

• Archives inside archives now open with Enter, to any depth (the depth limit is configurable). Backspace or ".." walks back out one level at a time.
• The per-format "File name encoding" setting is now actually used when reading entry names — useful for older zips without the UTF-8 flag, where auto-detection guesses wrong.
• The "Temporary directory" and "Password attempts" settings are now applied as well (a change to the temporary directory takes effect at next start).

Search can now find directories

• The search dialog has a new "Search for" option: files only (as before), directories only, or both.
• With "directories only", the size and content filters are disabled, since neither means anything for a directory.
• Going to a result no longer enters a directory. The pane moves to its parent and puts the cursor on it, so you can see where it was found.

Extracting without a wrapper directory

• The extract dialog has a new "Create a directory named after the archive" option. Turn it off to extract straight into the output path; farman used to always create that directory. It stays on by default.
• The initial state of that check box comes from Settings → Archive, so you can make direct extraction the default if you prefer it.

Dialogs

• Dialog shortcut keys (Alt, or ⌥ on macOS) were reviewed across the whole app so that the same function uses the same key — O for OK, X for Cancel, C for Close, N for Name, and so on.
• Dialogs that previously had keys only on OK and Cancel (Sort & Filter, Bulk Rename, Directory Compare, Properties and others) now let you reach every field by keyboard.
• The Create File, Create Directory, Delete and Rename dialogs now show the path they act on, so you can tell which directory is affected without looking away.
• In Properties, the last component of the path is an editable field: change it there to rename. The separate "Name" row is gone.
• Sort & Filter now uses the same three-way choice as Search (files only, directories only, or both) instead of two "only" check boxes.
• To encrypt a new archive, tick "Encrypt". The password fields are enabled only while it is ticked; an empty password used to mean "no encryption".
• Properties now shows sizes in "bytes" rather than "B".

File list operations

• "Copy Path" now copies the paths of all selected files at once (previously it copied only the item under the cursor).
• Added an action that copies just the file names instead of the paths (default shortcut Shift+Ctrl+C, Shift+Cmd+C on macOS).
• The separator used when copying several entries is configurable: comma, comma + space, or a newline (LF / CRLF / CR). Settings → Behavior → File Operations.
• After a copy, move, delete or rename, the status bar briefly shows what was done in place of the current path. The duration is configurable, and 0 turns the notice off.
• Changed what gets selected when renaming: for files, everything up to the last dot ("photo.tar.gz" selects "photo.tar"); for directories, the whole name (dots in a directory name are not an extension).

Other

• The About box now shows the build number, commit ID and build date, which makes it easier to identify the exact build when reporting a problem.

Bug fixes

• Fixed the English What's New dialog being cut off partway through, and made Markdown rendering in general immune to the same kind of truncation.
• With every viewer plugin disabled, only the binary viewer used to open. Now nothing opens at all.
• Fixed the month and year in the date picker being unreadable against their background.
• On macOS, the Alt (⌥) shortcuts shown on dialog labels, check boxes and radio buttons did nothing when pressed. They now work — including "Move to Trash" in the delete confirmation and "Overwrite" / "Rename to" in the overwrite dialog.
• Fixed "Open With Viewer..." (Ctrl+Enter, Cmd+Enter on macOS) on a file inside an archive: it showed empty content or failed to open.

3D model viewer (FBX) support

With the external plugin farman-plugin-3d, farman can now display .fbx 3D models inside the app.

• Supports textures (external and embedded), skeletal animation, multiple materials, a floor grid, wireframe display, and bone (skeleton) display.
• Rotate, pan, and zoom with the mouse or keyboard.
• The plugin is not bundled with farman. Download the build for your OS, place it in the viewers/ folder of farman's external plugin directory, turn on "Allow loading external plugins" under Settings > Plugins, then restart farman.
• FBX is supported first; other formats such as obj / glTF are planned.

Directory sizes in the Size column (computed in the background)

• The file list can now compute the recursive total size of directories in the background and show it in the Size column.
• Directories now always show "<DIR>" in the Type column (regardless of whether directory-size calculation is enabled).
• Off by default. Enable it under Settings > Behavior > Directory Size.
• Choose "Recompute every time" or "Cache for a period", and set how long the cache stays valid (a change to a directory's timestamp always triggers a recompute).
• Force a recompute with the toolbar button or Ctrl+Shift+R.
• Not computed while the Size column is hidden.

Binary viewer improvements

• Rewritten with custom rendering so gigabyte-class files open quickly and display correctly all the way to the end: only the visible rows are read instead of loading the whole file.
• Added jump-to-hex-address. The maximum valid address is shown next to the input, and out-of-range addresses are rejected as you type.
• Added search. Toggle between hex and text with radio buttons; hex input follows the display unit ("12 34 56" for 1-byte, "1234 5678" for 2-byte, endian-aware). Press Enter or Next / Prev to search forward / backward. Hits are highlighted in both the hex and text columns. Shortcuts: Cmd/Ctrl+F to focus search, Cmd+G / F3 find next, Cmd+Shift+G / Shift+F3 find previous, Cmd/Ctrl+J to focus the address field, Cmd/Ctrl+1-4 to change the unit, Cmd/Ctrl+E to toggle endianness, and Cmd/Ctrl+Shift+E to focus the encoding.

Customizable viewer shortcuts

• The keyboard shortcuts of each bundled viewer (Text / CSV·TSV / Markdown / PDF / Image / Binary / Media) — toggles, zoom, focus search, unit switch, and so on — can now be reassigned per viewer from the main settings (Settings → Keybindings).
• The same key can map to a different action in a different viewer; conflicts are detected within a viewer.
• Shortcuts of external viewer plugins (such as the 3D model viewer) can be edited from the same screen.
• The list can get long, so a filter box at the top lets you quickly find entries by command name, assigned key, or viewer name.
• Navigation keys (close with Esc/Enter, Enter / Shift+Enter in the search field, cursor movement, etc.) stay fixed.

Localized viewer names and title-bar display

• Bundled viewer names now follow the UI language (e.g. "テキストビュアー" in Japanese), so the Plugins settings list is consistent.
• While a viewer is open, the title bar shows "farman — <viewer name>".

Bug fixes

• Fixed an issue where the cursor on the last file could be scrolled out of view after returning from an inline viewer to the file list.
• Fixed an issue where the last row could fail to render after scrolling near the end of a large file.

Other

• Stability improvements and bug fixes

Archive plugin support

farman can now load external plugins beyond viewers. The archive formats farman can open can be extended later through external plugins, including plugins written by third parties.

• Archives in an added format can be browsed and extracted just like zip / tar: you can step inside them and take files out.
• These plugins are not bundled with farman; users who need them download and install them separately.

External plugin loading is now opt-in

External plugins are native code and run with the same privileges as farman. For safety, external plugin loading is now off by default.

• Turn on "Allow loading external plugins" under Settings > Plugins to load plugins from the external plugin directory on the next launch (bundled plugins are always enabled).
• Only enable plugins from sources you trust.

LZH (LHA) archive plugin released

As the first one, a separate external plugin for opening .lzh / .lha archives is now available.

• Browse inside the archive and extract files (Japanese Shift-JIS file names are handled; read-only).
• Download the plugin for your OS and place it in the archives/ folder of farman's external plugin directory, turn on "Allow loading external plugins" under Settings > Plugins, then restart farman. See the plugins page for details.

Monospace default font for the binary and text viewers

The default font of the binary viewer (hex dump) and the text viewer is now a true monospace font (macOS = Menlo, Windows = MS Gothic, Linux = DejaVu Sans Mono), so columns line up correctly.

• This is the default for new installations. If you already use farman, pick a font under each viewer's "Font" setting, or use "Restore defaults" to get the new default font.

Adjusted default fonts on Windows

On Windows, the general UI font is now MS UI Gothic, and the overall font size is unified to 9pt (the address bar, file list, and viewers keep their existing fonts, only resized to 9pt). This is the default for new installations.

Improved video viewer full screen

Fixed video full screen not working correctly (the video did not expand to the whole screen, and Esc did not exit). While in full screen, moving the mouse now shows a translucent control panel (play/pause, stop, seek, loop, volume) at the bottom of the screen.

Other

• Show "width × height" while resizing the window by dragging
• The "Name" column of the file list now stretches with the window width
• macOS: fixed buttons with kanji labels looking different from others
• Windows: fixed garbled Shift-JIS (CP932) Japanese file names inside zip / lzh archives
• Stability improvements and bug fixes

Redesigned Properties Dialog

File / folder properties are now consolidated into a single dialog.

• Review name, location, size, modified date, and created date together
• Multi-selection shows aggregated total size and item count
• Edit the modified date and attributes (permissions) in place
• Owner / group are shown with both name and ID; the name is editable only when it is common across the selected files (hidden on Windows)

"Open With Viewer..." Built from Plugins

The "Open With Viewer..." menu is now generated automatically from the registered plugins. Viewers that previously didn't appear in the list, such as the video / audio viewer, can now be chosen from all installed viewers.

Status Bar in External Viewers

Viewers opened in a separate window now show the same status information as the inline view. The media viewer shows a summary of the format / codec / resolution / duration.

Other Changes

• Fixed Markdown documents containing raw HTML being truncated partway
• On network / removable drives, where the Trash is unavailable, "Move to Trash" is now disabled so only permanent deletion is offered
• Fixed the delete-confirmation dialog layout breaking with long file names
• Fall back to home / root when the initial startup directory does not exist
• Fixed 0-byte files getting stuck on "Loading" in the binary viewer
• Stability improvements and bug fixes

Video / Audio Viewer

Play videos (mp4 / mov / webm / mkv, etc.) and audio files (mp3 / flac / wav, etc.) directly inside farman with the V key. Seeking, volume, looping, and fullscreen are supported.

Viewers Are Now Plugins

The bundled viewers (Text / Image / PDF / CSV / Markdown / Binary / Media) have been migrated to dynamically loaded official plugins.

• User-built external viewer plugins (.dylib / .so / .dll) can be loaded
• Per-extension Viewer Associations now also apply in Inline mode

New "Plugins" Settings Page

Everything plugin-related now lives in one place: the plugins directory, the installed plugin list (load status) with enable/disable toggles, and Viewer Associations. Help → Plugins... (toolbar button / shortcut available) opens the page directly.

What's New Dialog

After an update, farman shows this dialog once on first launch. You can reopen it any time via Help → What's New...

Other Changes

• Removed the SHA-256 hash option from directory compare in favor of the fast default comparison
• Stability improvements and bug fixes