-
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 3-day free trial of all Pro features. No credit card required.
A: Yes, the 3-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: 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: 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: 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.