-
-
Notifications
You must be signed in to change notification settings - Fork 0
FAQ
This page covers the most common questions about Unifyl, organized by category. If your question is not answered here, check the specific feature wiki pages for detailed documentation.
- Installation and System Requirements
- Getting Started
- Free vs Pro
- Keyboard Shortcuts
- File Operations
- Search and Filtering
- Cloud and Remote Connections
- AI Features
- Performance
- Updating
- Licensing
- Privacy and Security
- Developer Tools
- Customization
A: Unifyl requires:
- macOS 14 Sonoma or later
- Apple Silicon (M1, M2, M3, M4 series) is recommended and optimized for, but Intel Macs are also supported
- At least 4 GB of RAM (8 GB or more recommended for AI features)
- 150 MB of disk space for the application itself; additional space for AI model files
A: Yes. Unifyl supports Intel Macs running macOS 14 Sonoma or later. However, Apple Silicon Macs provide significantly better performance for AI features (which leverage the Neural Engine) and general file operations.
A: Download the latest .dmg file from the official website or purchase through the Mac App Store. For the direct download version:
- Open the .dmg file
- Drag Unifyl to your Applications folder
- Launch Unifyl
- On first launch, macOS may ask you to confirm opening an app from an identified developer -- click Open
A: This usually means macOS Gatekeeper is blocking the app. Right-click the app in Finder and select "Open" to bypass the initial Gatekeeper check. If that does not work, try:
xattr -cr /Applications/Unifyl.appThis removes extended attributes that Gatekeeper uses.
A: Press Cmd+2 for dual pane or Cmd+1 for single pane. You can also use View > Layout > Dual Pane from the menu.
A: Press Cmd+T to create a new tab in the active panel. Close a tab with Cmd+W.
A: Press Cmd+Shift+P to open the Command Palette. Type any command name or action to quickly access it.
A: The function key bar mirrors the Total Commander convention:
- F3: View / Hex Editor
- F4: Edit
- F5: Copy
- F6: Move
- F7: New Folder
- F8: Delete These can be customized in Settings > Key Bindings.
A: The Free tier includes: single/dual pane layout, basic search and filter, FTP/SFTP (basic), ZIP browsing, bookmarks, Command Palette, inline terminal, file history, checksum verification, file permissions editor, and Git status badges.
A: Unifyl Pro is a one-time purchase of $39.99. There is no subscription.
A: Yes. New users receive a 14-day free trial of all Pro features. No credit card required.
A: Yes, the 14-day trial gives you full access to all Pro features. Pro-only features show a lock overlay after the trial expires.
A: Contact support through the LemonSqueezy order page for educational and non-profit pricing inquiries.
A: Up to 3 Macs per license. You can deactivate a device from Settings to free up a slot for a new machine.
A: This is a known interaction between macOS input methods and keyboard shortcuts. When using the Korean IME:
- Shortcuts that use letter keys (e.g.,
Cmd+C) should work regardless of input method - If a shortcut is not responding, press
Cmd+Spaceto switch to the English input source, perform the shortcut, then switch back - Function keys (F1-F12) and modifier-only shortcuts work in all input methods
- You can customize shortcuts in Settings > Key Bindings to use combinations that work better with Korean IME
A: Go to Settings > Key Bindings. Unifyl supports remapping of 120+ commands. The KeyBindingManager includes conflict detection to warn you when two commands share the same shortcut.
A: Press Return (Enter) to rename a file, following the macOS Finder convention. This is different from Windows, where Enter opens a file.
A: Press Cmd+Delete to move selected files to the Trash (macOS standard). Press F8 for the Total Commander-style delete.
A: Press Space to toggle Quick Look preview, just like in Finder.
A: Yes. Press Cmd+Z to undo the last file operation. Unifyl tracks file operations with full undo/redo support:
- Copy: Undo removes the copied files
- Move: Undo moves files back to their original location
- Delete (to Trash): Undo restores files from the Trash
- Rename: Undo reverts to the original name
A: Yes. Cloud drives that are mounted locally (Google Drive, Dropbox, OneDrive, iCloud Drive) work like regular directories. For remote connections (S3, SFTP, etc.), drag and drop between the local and remote panels to upload/download.
A: Smart Folder lets you collect files from multiple directories into a virtual folder for batch operations:
- Browse to any directory and add files to the Smart Folder cart
- Repeat for files in other directories
- Open the Smart Folder panel to see all collected files
- Perform batch operations (copy, move, rename, etc.) on all collected files at once
A: Yes. Active file operations appear in the Operation Queue bar at the bottom. Click the pause button to pause, and the resume button to continue. You can also set speed limits.
A: Just extract it normally (F8, right-click โ Extract, or navigate into the archive and press F5 on selected files). Unifyl detects encrypted archives automatically and shows a password prompt before running the extractor. Supports WinZip AES, LZMA, and PKZIP 5.1+ formats via the bundled 7zz binary โ no need to install p7zip via Homebrew.
If you enter the wrong password, the prompt re-opens with "Incorrect password. Please try again." so you can retry without navigating back.
A: Yes. Drag the files from one panel and drop them onto the archive file (.zip, .7z, .tar.*) in the other panel. The archive row highlights during the drag, and the dropped files are added at the archive root. Works for external drags from Finder too.
A: Some archive tools package HWP / Numbers / Keynote / Pages documents as a same-named folder (e.g. X.hwp/X.hwp) inside the zip. Unifyl's wrapper-folder unwrap detects this pattern on extraction and flattens it automatically so you get a single file at the destination. If the wrapper folder contains multiple real user files, Unifyl leaves it intact to avoid data loss.
For HWPX files (2010+ XML-based Hancom format), LibreOffice cannot natively convert to PDF. If Hancom Office or Polaris Office v9+ is installed, the conversion error dialog offers an "Open in <app>" button that opens the HWPX in that app where you can use File โ Export as PDF directly.
A: Select files, then use File > Compress or right-click > Compress. Supported formats include ZIP, 7-Zip, TAR, GZ, BZ2, XZ, and ZSTD. Password-protected archives are supported for ZIP and 7z.
A: Yes. Double-click an archive file to enter it as if it were a folder. You can browse, copy files out, and navigate the archive structure. Supported formats: ZIP, 7-Zip, TAR, GZ, BZ2, XZ, RAR, ZSTD.
A:
-
Filter (
Cmd+F): Filters the current file list by name in real-time (only shows matching files in the current directory) - Search: Searches for files by name across subdirectories
- Content Search: Searches inside file contents (text files, PDFs, etc.)
- Advanced Search: Multi-criteria search with conditions (name, size, date, type, etc.)
A: Regular search matches exact text in filenames or content. Semantic Search understands meaning -- searching for "vacation photos" can find files named "Hawaii_Trip_2024" even though the words do not match. This requires the AI index to be built (Pro feature).
A: FTP and basic SFTP (password authentication) are available in the Free tier. All other protocols (FTPS, WebDAV, SMB, AFP, NFS) and cloud providers require Pro.
A: Create a new connection in the Connections panel, select SFTP, enable "Use Key Auth", and provide the path to your private key file (e.g., ~/.ssh/id_rsa). Pro tier required for key authentication.
A: Yes. iCloud Drive is automatically detected and appears in the Cloud Drives section of the Connections panel. It is accessed through its local mount point and is available in the Free tier.
A: No. All AI processing runs locally on your Mac using Apple's CoreML and Neural Engine. No file content, metadata, or usage data is transmitted to any server. See the AI Features page for details.
A: No. Unifyl uses on-device models that are included with the application. No cloud API keys (OpenAI, Google, etc.) are needed.
A: AI performance depends on your hardware:
- Apple Silicon M1+: Best performance via Neural Engine
- Intel Macs: Slower, uses CPU fallback
- First-time indexing may take a while; subsequent searches use cached indexes
- Check Settings > AI Models to adjust processing priority
A: The AI models require approximately 200-500 MB of disk space. The vector index size depends on the number of indexed files (approximately 1 KB per file).
A: Unifyl is optimized to handle 100,000+ files in under 0.5 seconds. If you experience slowness:
- Check if the folder is on a network drive (network latency adds overhead)
- Hidden files and Git status checks add slight overhead; disable if not needed
- Try disabling thumbnail generation for very large directories
- Ensure your Mac has sufficient free RAM
A: Unifyl targets under 150 MB for base memory usage. Memory may increase with:
- Multiple open tabs and panels
- Thumbnail caching for large directories
- AI vector indexes loaded in memory
- Active file operations Close unused tabs and panels to reduce memory usage.
A: Unifyl targets 95%+ of native file copy speed. If copies seem slow:
- Check if there is a speed limit configured in the Queue Manager
- Ensure the operation queue is not overloaded with many concurrent operations
- For network transfers, bandwidth is typically the bottleneck
A: Unifyl uses the Sparkle framework for automatic updates:
- On launch, Unifyl checks for updates in the background
- When an update is available, a notification appears
- Click "Install Update" to download and install
- The app restarts after updating
- You can check manually via Unifyl > Check for Updates
A: Yes. Go to Settings > General and uncheck "Automatically check for updates." You can still check manually via the menu.
A: Mac App Store updates are handled by macOS automatically. Open the App Store and check the Updates tab.
A: This typically means macOS is blocking Sparkle's installer helper under the App Management permission introduced in macOS Sonoma.
- Open System Settings โ Privacy & Security โ App Management.
- Turn ON the toggle next to Unifyl (if absent, click + and add
/Applications/Unifyl.app). - Quit Unifyl completely (Cmd+Q).
- Relaunch and try Check for Updates again.
Starting with v1.0.3, Unifyl displays a dedicated dialog with a one-click "Open System Settings" button whenever this specific Sparkle error occurs.
A: This was a specific bug in v1.0.4 (build 5) where the menu item's enabled state was never published correctly after the initial KVO read. Users on build 5 need to download v1.0.4 build 6 or newer manually from the releases page because the broken button blocks Sparkle from reaching the fix. Fixed permanently in all subsequent builds.
A: Yes, update to v1.0.5 immediately. v1.0.4 shipped with LemonSqueezy Test-store credentials, so clicking "Upgrade to Pro" showed a checkout page with an orange "Test mode is currently enabled" banner, and no real card could complete the purchase. v1.0.5 corrects this โ purchases now process normally. If you attempted to buy on v1.0.4, no charge was made on your card.
A: Your license key is stored securely in the macOS Keychain, encrypted at rest. It is not stored in a plain text file or in UserDefaults.
A: Yes. Each license supports up to 3 simultaneous activations. If you need to move a license to a new Mac, deactivate it on the old device first.
A: If the Keychain was migrated (e.g., via Time Machine), your license is preserved. If not, simply re-enter your license key. This counts as a new activation.
A: Unifyl validates your license on each launch. If you are offline, a 30-day grace period applies from the last successful validation. After 30 days, Pro features are locked until you can connect to the internet.
A: Yes. Unifyl offers a 14-day Pro trial โ every Pro feature is fully unlocked, no credit card required. Start the trial from Settings โ License โ Start Free Trial. The trial timestamp is stored in the macOS Keychain (not UserDefaults), and a wall-clock ratchet prevents extending the trial by rolling the system clock backward.
A: A promotional code PRODUCTHUNT offers 25% off for Product Hunt launch week visitors (valid through 2026-05-13, limited to 100 uses). Apply at the LemonSqueezy checkout page.
A: No. Unifyl does not collect analytics, usage telemetry, crash reports, or any personal data. The only network communication is:
- License validation with LemonSqueezy (sends only the license key)
- Update checks with the Sparkle update server (sends only the app version)
- Cloud/remote connections that you explicitly configure
A: Yes. All communication with the LemonSqueezy API uses HTTPS (TLS 1.2+). Your license key is stored in the macOS Keychain, which is encrypted.
A: Unifyl requests file access permissions as needed using Security-Scoped Bookmarks. Full Disk Access is not required for basic operations but may be needed for:
- Accessing restricted directories
- App Uninstaller support file detection
- Process File Map
A: The inline terminal supports these variables:
-
$F= Full file path -
$D= Current directory -
$S= All selected file paths -
$f= Filename with extension -
$n= Filename without extension -
$e= File extension
A: Yes. Go to Settings > Terminal to select your preferred shell (zsh, bash, fish, etc.).
A: Right-click a log file and select "Open in Log Viewer", or use Developer > Log Viewer. The viewer tails the file in real time (like tail -f) with color-coded log levels and filtering.
A: Go to Settings > Appearance or use View > Theme. Unifyl includes 12 built-in presets (Classic Navy, Midnight, Nord, Solarized, etc.) and supports custom themes via the Theme Editor.
A: Yes. Custom themes can be exported as .ultratheme files and shared with other Unifyl users.
A: Use View > Font Size or Cmd+Plus/Cmd+Minus to adjust the font size.
A: Yes. Go to Settings > Icons to choose between different icon themes, including the default system icons and custom icon sets.
A: Workspaces save the entire panel layout (tabs, paths, pane arrangement). Use Automation > Save Workspace to save the current layout, and Automation > Load Workspace to restore it.
๐ฌ๐ง English ยท ๐ฐ๐ท ํ๊ตญ์ด (Korean)
- Dual-Pane Navigation
- File Operations
- Selection
- Search and Filter
- Multi-Rename
- Archive Virtual Folders
- Tags
- Keyboard Shortcuts
- Command Palette
- Smart Folders