Skip to content

Ferret v3.1.1 - Pre-Release 3

Pre-release
Pre-release

Choose a tag to compare

@BonitoCat BonitoCat released this 20 Oct 15:55
· 14 commits to avalonia-upgrade since this release

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.