Repository navigation
v1.7.0
Tossy v1.7.0 Release Notes
Release Tag: v1.7.0
Release Target: macOS 14.0+ (Apple Silicon & Intel)
License: GPL-3.0 (Standalone, zero external dependencies)
Download ZIP: Tossy-1.7.0-macOS.zip
Highlights
Tossy v1.7.0 introduces native macOS Finder right-click context menu and Quick Action conversion integration, allowing direct single-click and batch conversions directly from Finder:
-
Finder Right-Click Context Menu & Quick Actions ("Convert with Tossy >"):
- Convert any image, video, or audio file directly from Finder without having to manually open the application.
- Right-click any file selection in Finder and access Quick Actions:
- Images:
Convert to PNG,Convert to JPEG,Convert to WebP,Convert to JPEG XL - Video:
Convert to MP4,Convert to WebM - Audio:
Convert to MP3,Convert to FLAC,Convert to WAV
- Images:
-
Dedicated Finder Integration Tab in Settings:
- Added a new Finder tab in Settings (Cmd+,).
- Single-click "Install Quick Actions in Finder" button that automatically creates and configures native
.workflowservice packages in~/Library/Services/and refreshes the macOS services cache. - Configurable action behavior picker:
- Silent Background Conversion: Converts files in the background next to originals (or default output directory) without interrupting active windows.
- Open in Tossy Batch Queue: Launches and focuses Tossy with selected files pre-loaded in the batch conversion queue.
-
Headless Silent Background Conversion Engine:
- Executes multi-threaded batch conversion jobs in the background using the configured concurrency limits.
- Triggers native macOS User Notifications displaying converted file count, megabytes saved, and quick Finder reveal actions.
- Plays completion audio chimes when enabled in settings.
-
System Services & Custom
tossy://URL Scheme:- Registered system
NSServicesproviders inInfo.plistfor system-wide service availability. - Added
tossy://convert?format=[ext]&files=[paths]URL scheme support for integration with macOS Shortcuts, Automator, Raycast, and shell automation scripts. - Added CLI conversion arguments (
--convert <files...> --format <ext> [--silent]).
- Registered system
Detailed Changes & Improvements
1. Finder & macOS System Integration
- FinderIntegrationManager: Manages installation, status verification, and uninstallation of native Quick Action bundles in
~/Library/Services/. - HeadlessConversionWorker: Thread-safe background worker orchestrating parallel conversion jobs across ImageConverter, VideoConverter, and AudioConverter without requiring UI rendering.
- AppDelegate NSServices Provider: Implemented pasteboard extraction handlers for system service invocations.
2. Settings & Customization
- Added
FinderIntegrationTabinSettingsView.swiftwith live status indicators, install/uninstall actions, and supported format reference grid. - Added
finderActionBehaviorandenabledFinderFormatssettings persistence inAppSettings.
3. Packaging & Clean Distribution
- Packaged clean distribution zip with native macOS metadata preservation via
ditto:dist/Tossy-1.7.0-macOS.zip(22.9 MB). - Code-signed recursively across all bundled dynamic libraries, command line utilities (
ffmpeg,cwebp,cjxl), and app bundle.
Installation & Opening on macOS
- Download
Tossy-1.7.0-macOS.zipfrom the releases page. - Unzip and drag
Tossy.appto your/Applicationsfolder. - Open Tossy, navigate to Settings (Cmd+,) > Finder, and click "Install Quick Actions" to activate Finder right-click integration.
- First Launch Note (Gatekeeper):
- Because Tossy is distributed outside the Mac App Store: Right-click
Tossy.appin/Applications> select Open > click Open (macOS remembers this permanently). - Alternatively, run
xattr -cr /Applications/Tossy.appin Terminal.
- Because Tossy is distributed outside the Mac App Store: Right-click