Host-Tools v2.1

Amiberry Host Tools v2.1

This release expands Host Tools from three core commands into a broader host integration toolkit for Amiberry.

New tools

• host-path prints the host-side path for existing Amiga paths.
• host-reveal reveals files in Finder or the host file manager.
• host-notify sends desktop notifications from AmigaOS.
• host-edit opens files in the configured host editor or platform opener.
• host-clip copies text to the host clipboard or prints clipboard contents.
• host-info reports basic host OS, shell, editor, opener, and clipboard backend details.

Improvements

• host-run now maps host dispatch success to Amiga return code 0 and reports dispatch failure as an error.
• Shell argument quoting was hardened for spaces, empty strings, single quotes, and overlong commands.
• URL handling now avoids Amiga volume lookups for non-slash schemes such as mailto:, magnet:, tel:, and data:.
• Path translation buffers were expanded and checked to avoid silent truncation on long host paths.
• host-multiview now returns a nonzero status if opening a path or URL fails.
• Builds now use the sacredbanana/amiga-compiler:m68k-amigaos image and package all tools via the Makefile.
• Source files and build metadata now carry GPL-3.0-or-later SPDX notices.

Amiberry compatibility

• Native Code execution must be enabled in Amiberry.
• The tools remain usable with older Amiberry builds, but full status reporting and long-path truncation protection require the newer Amiberry host trap fixes merged after v2.1 development.
• Status-aware tools (host-reveal, host-notify, host-clip, and host-info) use the new HostShell_Status trap when available and fall back to timeout-based completion detection otherwise.

Download

Download Host-Tools-v2.1.lha from the assets below, extract it, and copy the binaries to C: or another directory in your AmigaOS path.

If you find Amiberry useful and want to support ongoing development, donations are welcome at https://ko-fi.com/midwan.

Full Changelog: v2.0...v2.1

Host-Tools v2.0

What's New in v2.0

Bug Fixes

• Fix "Please insert volume" requester on macOS — URLs passed to host-run and host-multiview no longer trigger an AmigaOS volume requester (#4)
• Fix potential buffer overflow in host-run — shell quoting logic (append_quoted) rewritten with correct bounds checking
• Fix incorrect pointer type in host-run — ExecuteOnHost was called with &command instead of command

Improvements

• host-run now propagates exit codes — enables IF WARN / IF ERROR in Amiga scripts
• host-multiview now officially supports URLs — updated help text and documentation
• host-shell now supports ? for usage info — consistent with the other tools
• Filename buffers increased from 256 to 1024 bytes to handle long host paths
• Compiler warnings enabled — -Wall -Wextra added to catch issues early
• make debug target — builds with -DDEBUG for development
• Version strings centralized — version and date defined once in the Makefile

CI/CD

• Fixed CI triggers — workflow was referencing main but the repo uses master
• Replaced third-party release action with built-in gh CLI — no more external dependencies

Upgrading

Drop-in replacement for v1.9. Copy the binaries to C: as usual.

Host-Tools v1.9

Full Changelog: v1.8...v1.9

Host-Run v1.7

Further improve handling of filename parameters that contain spaces.
They are now escaped properly using backslashes on Linux.

Note: This requires the latest Amiberry update (2024-08-24 or newer) to function as it should!

Host-run v1.6

Minor improvements, to handle filenames with spaces and other symbols better.

host-run v1.5

With this update, host-run is now able to detect retrieve the full pathname for parameters that are files or directories under AmigaOS.
This works for relative paths, absolute paths, paths within assigns or no paths at all (just specifying a filename in the current directory).
It works best in combination with the latest Amiberry version (dated 2021-02-03 or newer), in order to also support filenames with spaces.

Update: host-multiview v1.0 has been added as a binary release as well.

host-run v1.4

• Added "?" parameter, to show usage
• Added version information
• Added missing struct in header
• Added Makefile for gcc compile
• Added VSCode tasks to compile using gcc docker

host-run v1.3

This version of host-run includes an important change:

• The "&" character is no longer added at the end of the command passed to the emulator. This is handled by the emulator itself from now on, to allow host-run to be more portable across different platforms.

Note: Requires Amiberry v3.4 or later

host-run v1.2

Changes in this version:

• Make sure the buffer is cleared in the beginning, to avoid having junk characters in the command when running through IconX

host-run v1.1

Changes since the previous version:

• Fixed bug #1 : the command buffer wasn't cleared after using it, causing subsequent runs from the same stack to re-run the previous commands on top of the new ones.