Repository navigation
Relay Shelf 1.1.0 — file actions and automation
Pre-releaseRelay Shelf 1.1.0 prerelease
New file workflows
- Save named destination folders and copy selected files into them with collision-safe filenames.
- Capture a region or window using macOS screenshot selection.
- Extract text from images and PDFs using fast on-device Vision OCR with the default English language model.
- Resize, convert and compress images, and strip source image metadata.
- Merge PDFs in a chosen order or create a PDF from images.
- Dock floating shelves at either screen edge and reopen the last floating shelf, including after restart.
- Run an installed macOS Shortcut with selected files and collect its output.
Select files and choose File actions for image, PDF, OCR, destination, and Shortcut workflows. Screenshot capture is also available through the Add menu, command palette, and menu bar.
Responsiveness and storage
Media processing uses system frameworks with sequential background work and bounded decoding. Existing shelf data loads with an empty saved-destination list. Generated media is stored as new app-managed copies. In-flight source protection covers concurrent operations and shelf cleanup.
Docking suspends the 60-second floating-shelf idle timeout. Screenshot capture temporarily hides Relay Shelf windows, then restores their presentation. Escape cancels screenshot selection.
Verification
All ten native test suites passed. Native regression suites cover old-state migration, concurrent destination copies, source retention, ordered PDF output, managed-output cleanup, docking/history, screenshot visibility, media processing, real OCR, and controlled screenshot/Shortcut subprocesses. The media suite passed 249 assertions. Media tests include all eight image orientations, transparency, metadata removal, bounded input failures, and cancellation cleanup.
Live native UI checks passed for image resize and conversion, OCR, metadata removal, image-to-PDF, user-ordered PDF merging, destination management/copying, docking, and installed Shortcut listing. Cross-application drag delivery remains pending manual verification. Screenshot capture needs macOS Screen Recording permission. The installed-app permission-denial guidance was verified. Shortcut execution tests use controlled fixtures.
Download
Requires Apple Silicon and macOS 14 or newer. Runtime testing used macOS 27.2. This app is ad-hoc signed and unnotarized, so macOS may block the download from opening.
Extract Relay-Shelf-macOS.zip and move Relay Shelf.app into Applications. The source archive contains the MIT-licensed source and build instructions. Place both ZIP files beside SHA256SUMS.txt and check them with the following command.
shasum -a 256 -c SHA256SUMS.txt