Skip to content

Releases

Ferret v3.1.1 - Pre-Release 4

Pre-release

Choose a tag to compare

@BonitoCat BonitoCat released this 23 Oct 08:17

What's new

Sorting

  • Click a column header in list view (Name, Size, Type, Modified) to sort by it; click again to reverse the order
  • Grid view: choose the sort column and direction under View → Sort by

Changing protected files and folders

  • Creating, renaming, deleting, copying, moving, duplicating and linking in folders you don't have write access to now asks for your password and does it as admin; no need to switch to the root window first
  • One password prompt per operation, with a progress bar while it runs

Keyboard shortcuts

  • The Shortcuts window is now a real editor: click a shortcut and press new keys to change it, clear it, or reset it (one at a time or all at once)
  • If a shortcut is already used by something else, you get a popup asking if you want to cancel or remove it from the other shortcut
  • New Addons tab: change the shortcuts of your addons' actions too

Broken symlinks

  • Opening a link whose target no longer exists, or isn't reachable right now (e.g. the drive isn't plugged in), shows a message instead of creating the missing path
  • Broken links show the right icon (folder or file type instead of a gear) and are dimmed

Smaller improvements

  • In grid view, the whole highlighted box of a selected item can be clicked without deselecting it
  • Icons of cut items are now dimmed, not just their names
  • ferret -d / ferret --detach starts Ferret in the background and gives the terminal back

Addons

  • Paste handlers: actions with location: paste run when the user pastes and can handle the paste themselves or pass it on to Ferret (fe:pass). clipboard, extensions and multiple filter when they run, e.g. only for image data or one copied .png
  • Typed clipboard: fe:clipboard-types, fe:clipboard-files (with copy/cut), fe:clipboard-text <file> (exact text) and fe:clipboard-image <file>, without needing xclip or wl-paste
  • Live forms: fe:form-show live sends every change of a field to the script, and fe:field-set updates fields, so one field can react to another (e.g. the format choice changes the file extension)
  • Text selection: fe:field-select puts the cursor into a text field and selects all of its text, the name without the extension, or any range

Fixes

  • Remote folders (SMB, WebDAV, SFTP …) no longer freeze the window while they load
  • Bookmarks and devices in the sidebar show up right away, even while a network server is slow or unreachable
  • The CLI sidebar is no longer empty
  • Previews for files on remote folders work now
  • Remote bookmarks connect automatically when opened
  • Deleting large files shows a progress bar instead of freezing until finished now
  • Faster startup

Ferret v3.1.1 - Pre-Release 3

Pre-release

Choose a tag to compare

@BonitoCat BonitoCat released this 20 Oct 15:55

Addons

Dependencies

  • New dependencies: list in addon.yaml. Each entry is a command to check for, with a package name per package manager (apt, dnf, pacman, zypper) or one package for all. A plain name like - git works too.
  • When an addon is installed or updated, Ferret lists the missing programs and asks before installing them through pkexec with the detected package manager. You can also skip, or copy the matching sudo … command.
  • A skipped or failed installation never blocks the addon. Missing programs are shown in Manage Addons, which has a new Install Dependencies… button, and are reported in Addon Problems.
  • Dependencies are handled before post_install runs. Uninstalling an addon never removes its packages.

Donation links

  • New donate: field in addon.yaml: one link or a list. Each link is shown as its site's icon next to the addon in Manage Addons, and clicking it opens the page in the browser.
  • Only links to Ko-fi, PayPal, Patreon, GitHub Sponsors, Buy Me a Coffee, Liberapay and Open Collective are accepted. Other links are ignored and reported in Addon Problems, and the addon store rejects addons that contain them.

Translations in scripts

  • $Key in text a script shows is replaced with the value from the addon's translations/<lang>.json, falling back from e.g. de-AT to de to en.
  • This works in fe:status, fe:message, fe:prompt, fe:confirm, fe:notify, the fe:choose question, form titles and field labels, status bar text and tooltips, progress texts, and the last stderr line of a failed script.
  • Paths, ids, choice values and replies are never translated.

Clipboard

  • fe:clipboard (or fe:paste) sends the clipboard text back on stdin. Trailing line breaks are dropped; line breaks inside the text arrive as \n and backslashes as \\.
  • fe:copy <text> copies text to the clipboard (\n for line breaks).
  • fe:copy-files <path> | … and fe:cut-files <path> | … put files on the clipboard, like Ctrl+C and Ctrl+X.

Working with files

  • fe:copy-to <folder> | <path> | … and fe:move-to … copy or move with Ferret's progress bar and conflict dialog, then reply yes or no.
  • fe:trash <path> | … moves files to the trash, so they can be restored.
  • fe:reveal <path> | … opens the files' folder and selects them, refreshing first if the folder is already open.
  • fe:terminal [folder] opens the user's terminal, in the current folder by default.
  • FE_TEMP_DIR is a private folder for each run, deleted when the script exits, even after Cancel.

Notifications and logging

  • fe:notify <text> shows a desktop notification with the addon's name and icon. Without a notification service, the text goes to the status bar instead.
  • fe:log [info|warning|error] <text> writes to the addon log. The default level is info, which doesn't count toward the problems badge.

Documentation

  • _docs/ADDONS.md covers all of the above.
  • New example addon examples/addons/image-tools: convert, resize and strip metadata from images, plus image info. It uses dependencies, settings, forms and progress bars.
  • New example addon examples/addons/pdf-tools: merge, compress, split and extract pages from PDFs with Ghostscript. Results are made in $FE_TEMP_DIR, moved in with fe:move-to and selected with fe:reveal. Compressing can move the originals to the trash, and long runs end with a desktop notification.

Changes

  • Long file names in the icon view. View → File Names in Icon View offers up to 2 lines, up to 3 lines (the new default), or full names. With longer names, each row grows to fit its tallest name. In 2- and 3-line mode, the selected file always shows its full name.
  • The window title shows the current folder instead of "Ferret", so windows can be told apart in Alt+Tab and the taskbar. Special places and renamed network places use their sidebar names, such as "Persönlicher Ordner", "Dateisystem" or "Papierkorb", and in dual-pane mode the title follows the active pane.

Fixes

  • Addon status messages (fe:status) and addon error messages were replaced right away when the folder refreshed, so they were often never visible. They now stay for at least 4 seconds.

Ferret v3.1.1 - Pre-Release 2

Pre-release

Choose a tag to compare

@BonitoCat BonitoCat released this 20 Oct 09:50

Addons

Background services

  • Addons can define a service: script that starts with the window and keeps running in the background.
  • Ferret sends events to the service on stdin:
    • event:navigate <path>: at start and whenever the folder changes (also when switching split panes)
    • event:selection <paths>: tab-separated, sent 150 ms after the selection stops changing
    • event:click <id>: one of the service's status bar items was clicked
    • event:reply <text> / event:cancel: answers to dialogs the service opened
    • event:setting <id> <value>: a setting was changed
    • event:close: the service should exit now
  • Services stop when the window closes or the addon is disabled or uninstalled. After event:close, Ferret waits up to 2 s, then sends SIGTERM and finally SIGKILL.
  • "Reload Addons" (both the menu entry and the button in Manage Addons) restarts services.
  • A crashed service is not restarted automatically. A non-zero exit code is reported in Addon Problems, and its status bar items and sidebar places are removed.
  • Events go through a buffer, so Ferret never blocks on a slow service. If it falls more than 500 events behind, the oldest are dropped.
  • Services run in the addon folder with FE_SERVICE=1.

Status bar items

  • fe:statusbar <id> <text> adds or updates an item at the right of the status bar, shown with the addon's icon. Empty text removes it.
  • fe:statusbar-tooltip <id> <text> sets a tooltip (\n for line breaks).
  • Clicking an item sends event:click <id> to the addon's service. If the addon has no service, the click runs the action with the same id.

Sidebar places

  • New places: list in addon.yaml. Each entry has name, path (~/ supported), section (default: the addon name) and icon.
  • fe:place <section> | <name> | <path> [| <icon>] adds or updates an entry. fe:place-remove <section> [| <name>] removes entries.
  • Each addon section can be collapsed on its own, and all addon sections move together when the sidebar sections are dragged.
  • icon can be an image inside the addon folder or a built-in icon name.

Addon settings

  • New settings: list in addon.yaml. Supported types: text, password, number (with min/max), bool, choice, file, folder.
  • New Settings… button in Manage Addons, with Reset to defaults, Cancel and Save.
  • Values reach scripts as FE_SETTING_<ID> environment variables. A running service is notified of changes with event:setting.
  • fe:setting <id> <value> saves a value from a script.
  • Settings are stored in addon_settings.json in Ferret's data folder, survive updates, and are deleted on uninstall.

New dialogs

  • fe:choose <question> | opt1 | opt2 …: up to 6 options are shown as radio buttons, more as a drop-down. The reply is the chosen option.
  • Forms: fe:form <title>, then one or more fe:field <id> | <type> | <label> | <default>, then fe:form-show.
    • The reply is one tab-separated line in field order.
    • File and folder fields have a "…" button that opens Ferret's own picker.
    • For choice fields, mark the default with *.
  • Cancelling closes stdin for normal scripts and sends event:cancel for services.

Lifecycle hooks

  • post_install, pre_uninstall, post_load, post_start and pre_close, with time limits where needed.
  • FE_HOOK tells the script which hook is running.

Progress, loading and pickers

  • fe:progress … shows a progress bar. Its variants set the maximum, title, text, status and current item, or remove the bar with done.
  • Several running operations (addons and file copies) are shown as tabs you can switch between with the arrows. Copies now run in parallel.
  • Cancel sends SIGTERM to the script and everything it started, and kills them 3 s later if they are still running.
  • fe:loading on|off shows the thin loading bar above the file list.
  • fe:confirm, fe:select <pattern> and fe:pick <path> (finishes a file picker with that path).
  • modes: controls where an addon or action appears: explorer, file/folder/save picker, all pickers, or everywhere. FE_MODE tells the script which one it runs in.

Error reporting

  • New Addons → Addon Problems… dialog, plus a warning badge in the status bar (or next to the file name box in pickers).
  • It lists:
    • failed scripts, with their stderr output
    • scripts that failed to start
    • addon.yaml mistakes
    • unknown or invalid fe: lines
    • hooks that timed out
    • crashed services
  • The list has Copy All and Clear buttons.

New environment variables

Variable Value
FE_HOME_DIR your home folder
FE_CACHE_DIR ~/.cache (or $XDG_CACHE_HOME)
FE_DATA_DIR ~/.local/share/fe (or $XDG_DATA_HOME/fe)
FE_SERVICE 1 inside a background service
FE_SETTING_<ID> the value of each addon setting
FE_MODE explorer, file-picker, folder-picker or save-picker
FE_HOOK name of the running hook

Documentation

  • _docs/ADDONS.md is greatly expanded, with precise rules for every feature above.
  • The addon paragraph in README.md is updated.

Changes

  • Paste as symlink is now Ctrl+Alt+V (was Ctrl+Shift+V), to match Alt for dropping as a symlink. Ctrl+Shift+V in the file list now pastes normally.
  • Ctrl+Shift+V pastes in text boxes.
  • "Copy path to clipboard" works for files too. It copies all selected paths, or the current folder if nothing is selected.
  • Rubber-band selection starts on the first click, even when that click switches to the other pane, and the switching click keeps the existing selection.

Fixes

  • Firefox (and other apps using the portal file picker) showed no files when the filter used character classes like *.[jJ][sS][oO][nN].
  • A drag preview could get stuck after a script prompt dialog appeared.
  • Unselected files could stay gray after deselecting them.
  • Double-clicking opened the selected item instead of the one under the mouse. This made Ctrl+double-click open the wrong folder, and double-clicking empty space could open something.
  • Addon scripts whose background child processes kept stdout open could hang Ferret's exit handling.
  • Entering folders with the Enter key no longer worked

Ferret v3.1.1 - Pre-Release 1

Pre-release

Choose a tag to compare

@BonitoCat BonitoCat released this 19 Oct 18:38
d866c50

Ferret (GUI)

Added

  • New prompt window accessible to addons for user input

Changed

  • Updated Avalonia version to 12
    • Drag and drop is now implemented via the native Avalonia functions

Fixed

  • Drag and drop bugs when alt + tabbing

Ferret v3.1.0

Choose a tag to compare

@BonitoCat BonitoCat released this 19 Oct 16:05
d866c50

Ferret (GUI)

Added

  • Bulk renaming of selected items
  • Extracting into a folder
  • Copying the path of the current folder or file into the clipboard
  • A built-in Addon Store to browse officially verified addons
    • Addons can be submitted in the addons repo and will show up in Ferret if accepted
  • An 'Open as root' option when opening a root owned folder
  • Pathbar commands (e.g. cmd -> opens the terminal; select *.png -> selects all png files)
    • New commands can also be added through addons
  • New icons for multiple file types
  • Thumbnail previews for .svg and .ico files
  • The ability to change the icon for a specific file type to any image
  • Pasting a folder / file as a symlink
  • A confirmation prompt before emptying the trash or restoring items from it
  • An "About Ferret" menu option in the "Help" section for more information

Changed

  • A new "Open with..." interface
    • The "Open with..." menu now shows options it considers sensible for a specific file type

Fixed

  • Fixed a freeze when you tried to create or edit a file on an SMB connection when you had insufficient permissions
  • Network locations that can't report their free space no longer show "0 B free" in the status bar

Known Issues

  • Alt-tabbing doesn't work when dragging a folder / file
  • Alt-Tab may behave incorrectly while Ferret is open (not yet confirmed to be caused by Ferret, but it's likely)

Ferret v3.0.0

Choose a tag to compare

@BonitoCat BonitoCat released this 17 Oct 19:51
21f3301

Ferret (GUI)

Added

  • A GUI version of fe called "Ferret"
  • UI and features inspired by "Nemo"
  • Addons: Add your own right-click and menu entries that run scripts, see the Addon guide

fe (CLI)

Added

  • Sidebar with places, bookmarks, devices and networks
    • Ctrl + Left / Ctrl + S to focus it (Ctrl + S keeps the current pane as target)
    • Enter opens, mounts drives or reconnects servers, F8 unmounts
    • Shift + ↑/↓ reorders items, Ctrl + Shift + ↑/↓ reorders whole sections; the order is saved between sessions
  • Network tab in the sidebar to browse servers
  • Remote connections are saved and can be reconnected from the sidebar
  • Open with… (Alt+O) with an "Always open .xyz with" option
  • (#51) Type a name to jump to the first matching item
  • Reworked properties window: live folder size and contents, owner and group names, readable permissions, volume info, default app

Changed

  • The path is now shown in a single top bar with the path of the currently selected pane
  • The path bar shows the name of a connection or drive instead of its long mount path
  • Renaming a file selects only its name, not the extension
  • Hidden files are shown by default; Ctrl + H is remembered between sessions
  • Restyled input prompts
  • Folders load in the background with a "Loading…" hint
  • Long names are shortened with "…" instead of just cutting off

Fixed

  • (#25) fe reading input when it shouldn't
  • Cursor blinking staying off after closing fe

GUI + CLI

Added

  • A new shared architecture that allows for more frontends ( like a web UI) in the future
  • Connecting to remote locations (SFTP, SMB, FTP, WebDAV)

Ferret v3.0.0 - Pre-Release 2

Pre-release

Choose a tag to compare

@BonitoCat BonitoCat released this 17 Oct 02:38

Ferret (GUI)

Added:

  • A german translation
  • When moving or copying files encounter conflicts, a new prompt will appear to handle the issue

fe (CLI)

Added:

  • You can now reorder sidebar items by pressing Shift + ↑/↓ and reorder whole sections by pressing Ctrl + Shift + ↑/↓

GUI + CLI

Changed:

  • Clearer error messages when connecting to a server fails

Fixed:

  • WebDAV connections should work now instead of throwing an error
  • Sidebar order is now saved between sessions

Ferret v3.0.0 - Pre-Release 2

Pre-release

Choose a tag to compare

@BonitoCat BonitoCat released this 16 Oct 08:52

Ferret (GUI)

Added:

  • Reworked properties window with tabs: General (rename, live folder size and contents, image dimensions, free space), Permissions (owner, group and others access, executable, octal mode, setuid/setgid/sticky, apply to enclosed items), Open With (choose and set default app), Details (inode, size on disk, MD5/SHA-1/SHA-256)
  • Folder colors with 12 presets and a custom color picker
  • Prompt when opening scripts: Run in Terminal, Show Content, Cancel, Run
  • Path bar scroll buttons when it overflows, deeper folders stay visible after going up, current folder highlighted
  • Sidebar sections can be collapsed and reordered by dragging their headers
  • F6 switches between panes, Ctrl+W closes the second pane or the window
  • Up/Down arrow navigation in grid view
  • Recover files

Changed:

  • Grid view spreads items across the full width
  • New icons for executables and .deb packages
  • Drag and drop works without selecting first; dropping into a folder now only works when dropping onto its icon
  • Long names are now ellipsed in list view

Optimization:

  • Much faster startup (up to 15s before when an external drive was mounted)
  • Loading large folders (especially with images) should now no longer stall the entire UI and load quicker

Fixed:

  • Sidebar jumping back to the top on refresh or navigation
  • Item names no longer centered after closing a context menu
  • Previous item staying highlighted after quick search or toggling the second pane
  • Setting a default app for one file type (e.g. .slnx) changing it for all text files
  • Alt+Enter opening the item instead of its properties
  • Underscores missing in the path bar
  • Connecting to an already mounted server failing
  • Snap and loop devices showing up under Devices

fe (CLI)

Added:

  • Sidebar with places, bookmarks, devices and network (F9 to toggle, remembered between sessions)
    • Ctrl+Left / Ctrl+S to focus it (Ctrl+S keeps the current pane as target)
    • Enter opens, mounts drives or reconnects servers; Delete removes, F7 connects, F8 unmounts
  • Remote connections are saved and can be reconnected from the sidebar
  • Open with… (Alt+O) with an "Always open .xyz with" option
  • (#51) Type a name to jump to the first matching item
  • Reworked properties window: live folder size and contents, owner and group names, readable permissions, volume info, default app

Changed:

  • Hidden files are shown by default; Ctrl+H is remembered between sessions
  • Restyled input prompts
  • Folders load in the background with a "Loading…" hint
  • Long names are now ellipsed instead of just cutting off

Fixed:

  • Long names no longer wrapping to the next line
  • Freezes when opening remote or large folders
  • Items cascading to the left in some terminals such as Rider's (please confirm, works for me)
  • Cursor blinking staying off after closing fe; terminal settings are now also restored after a crash or closing

Known Issues

  • Under sudo, mounted network locations of the normal user don't show in the sidebar
  • Folder colors don't follow folders when they are renamed or moved
  • The order of items within a sidebar section isn't saved yet
  • Log files seem to be encrypted weirdly

Ferret v3.0.0 - Pre-Release 1

Pre-release

Choose a tag to compare

@BonitoCat BonitoCat released this 12 Oct 08:45

Added:

  • GUI version of fe called "Ferret"
  • A first bare bones version of remote paths
  • A new shared architecture that allows for more front ends like a web ui in the future

Fixed:

  • (#25) Fixed an issue where fe would read input when it shouldn't be

Known Issues:

  • Ferret takes a long time to open
  • Remote paths are weird in the terminal and sometimes don't work

Terminal File-Explorer v2.1.0

Choose a tag to compare

@BonitoCat BonitoCat released this 24 Mar 14:14

Added:

  • (#54) Added page up and page down functionality to scroll page wise
  • Added a new property window (Shift + Enter)
  • Added a scroll bar
  • Added the ability to open a new fe window with higher privileges (Shift + O)

Optimization:

  • File types are now detected significantly quicker, shortening load times massively

Changes:

  • Switched the old "--More--" text out with the new scroll bar and up / down arrows on the left side of the screen. This allows for showing more files at once.

Fixed:

  • (#50) Fixed fe freezing when searching while folder contents were still loading
  • (#52) Fixed the metadata / property window not rendering correctly when resizing the terminal window
  • (#53) Fixed .mov files not being recognized as video files
  • (#55) Fixed fe remembering copy and cut files even if no instance was opened (could lead to accidental moving of files)
  • Opening files now finally works on every major OS again (Windows and MacOS feedback required)