Repository navigation
Releases
Releases · BonitoCat/Ferret-File-Explorer
Ferret v3.1.1 - Pre-Release 4
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 --detachstarts Ferret in the background and gives the terminal back
Addons
- Paste handlers: actions with
location: pasterun when the user pastes and can handle the paste themselves or pass it on to Ferret (fe:pass).clipboard,extensionsandmultiplefilter 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) andfe:clipboard-image <file>, without needing xclip or wl-paste - Live forms:
fe:form-show livesends every change of a field to the script, andfe:field-setupdates fields, so one field can react to another (e.g. the format choice changes the file extension) - Text selection:
fe:field-selectputs 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
Addons
Dependencies
- New
dependencies:list inaddon.yaml. Each entry is a command to check for, with a package name per package manager (apt,dnf,pacman,zypper) or onepackagefor all. A plain name like- gitworks too. - When an addon is installed or updated, Ferret lists the missing programs and asks before installing them through
pkexecwith the detected package manager. You can also skip, or copy the matchingsudo …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_installruns. Uninstalling an addon never removes its packages.
Donation links
- New
donate:field inaddon.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
$Keyin text a script shows is replaced with the value from the addon'stranslations/<lang>.json, falling back from e.g.de-ATtodetoen.- This works in
fe:status,fe:message,fe:prompt,fe:confirm,fe:notify, thefe:choosequestion, 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(orfe:paste) sends the clipboard text back on stdin. Trailing line breaks are dropped; line breaks inside the text arrive as\nand backslashes as\\.fe:copy <text>copies text to the clipboard (\nfor line breaks).fe:copy-files <path> | …andfe:cut-files <path> | …put files on the clipboard, like Ctrl+C and Ctrl+X.
Working with files
fe:copy-to <folder> | <path> | …andfe:move-to …copy or move with Ferret's progress bar and conflict dialog, then replyyesorno.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_DIRis 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 isinfo, which doesn't count toward the problems badge.
Documentation
_docs/ADDONS.mdcovers 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 withfe:move-toand selected withfe: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
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 changingevent:click <id>: one of the service's status bar items was clickedevent:reply <text>/event:cancel: answers to dialogs the service openedevent:setting <id> <value>: a setting was changedevent: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 (\nfor 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 inaddon.yaml. Each entry hasname,path(~/supported),section(default: the addon name) andicon. 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.
iconcan be an image inside the addon folder or a built-in icon name.
Addon settings
- New
settings:list inaddon.yaml. Supported types:text,password,number(withmin/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 withevent:setting. fe:setting <id> <value>saves a value from a script.- Settings are stored in
addon_settings.jsonin 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 morefe:field <id> | <type> | <label> | <default>, thenfe: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
choicefields, mark the default with*.
- Cancelling closes stdin for normal scripts and sends
event:cancelfor services.
Lifecycle hooks
post_install,pre_uninstall,post_load,post_startandpre_close, with time limits where needed.FE_HOOKtells 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 withdone.- 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|offshows the thin loading bar above the file list.fe:confirm,fe:select <pattern>andfe: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_MODEtells 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.yamlmistakes- 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.mdis greatly expanded, with precise rules for every feature above.- The addon paragraph in
README.mdis 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
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
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
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
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
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
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
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)