Rclone GUI — Cloud Explorer

한국어 | English

A multi-cloud file manager GUI application based on rclone. An open-source alternative that provides all the features of Air Explorer for free.

Overview

A native macOS desktop application that lets you manage multiple cloud storage services from a single interface, powered by rclone via librclone. Built with Swift and SwiftUI for a true Mac-native experience.

Installation

Users

1. Download RcloneGUI-x.x.x.dmg from the Releases page
2. Open the .dmg and drag the app to your Applications folder
3. Launch — done!

Requires macOS 14 (Sonoma) or later.

Developers

• macOS 14+ (Sonoma)
• Xcode 15+
• Go 1.21+ (for building librclone)

Architecture

┌──────────────────────────────────────────────────┐
│              RcloneGUI.app (.dmg)                 │
│  ┌────────────────────────────────────────────┐  │
│  │        SwiftUI + AppKit Frontend           │  │
│  │  ┌──────────┐      ┌──────────┐           │  │
│  │  │ Left     │      │ Right    │           │  │
│  │  │ Panel    │      │ Panel    │           │  │
│  │  └──────────┘      └──────────┘           │  │
│  │  ┌──────────────────────────────┐         │  │
│  │  │  Transfer Queue / Progress   │         │  │
│  │  └──────────────────────────────┘         │  │
│  └────────────────────────────────────────────┘  │
│  ┌────────────────────────────────────────────┐  │
│  │         Swift Packages                     │  │
│  │  ┌─────────────┐  ┌───────────────┐       │  │
│  │  │ FileBrowser  │  │ TransferEngine│       │  │
│  │  └──────┬──────┘  └──────┬────────┘       │  │
│  │  ┌──────┴─────────────────┴────────┐       │  │
│  │  │         RcloneKit (FFI)         │       │  │
│  │  └──────────────┬──────────────────┘       │  │
│  └─────────────────┼──────────────────────────┘  │
│  ┌─────────────────┴──────────────────────────┐  │
│  │  Frameworks/librclone.dylib                │  │
│  │  (Go C shared library — direct FFI call)   │  │
│  └────────────────────────────────────────────┘  │
└──────────────────────────────────────────────────┘

Key difference from v0.x: No more HTTP API server or separate rclone process. librclone is linked directly into the app, calling rclone functions via C FFI for lower latency and simpler deployment.

Features

1. Dual-Panel File Browser

• Side-by-side split panels for simultaneous browsing
• Drag and drop file transfer between panels
• Resizable panel divider
• Address bar with breadcrumb navigation and direct path input
• Multi-tab browsing — work with multiple locations simultaneously
• File table with sortable columns (name, size, date)
• Context menu (copy, cut, paste, rename, delete, new folder, properties, share link)
• Keyboard shortcuts (Cmd+C, Cmd+V, Cmd+X, Cmd+Delete, Cmd+A, Cmd+Shift+N, etc.)
• Drag and drop from Finder (file URL drop support)
• Quick Look preview (spacebar)
• Bookmarks — favorite frequently used paths (Cmd+D)
• File/folder thumbnail previews (inline, local images)
• Linked Browsing — synchronized folder navigation across both panels

2. Supported Cloud Services

• Supports all 70+ cloud storage services that rclone supports

Google Drive, OneDrive, Dropbox, Box, Mega, pCloud, Amazon S3, Azure Blob, Backblaze B2, Wasabi, DigitalOcean Spaces, Nextcloud, Owncloud, FTP, SFTP, WebDAV, and more

3. File Management

• Copy / Move / Delete / Rename
• Create folder
• Right-click context menu
• Bulk Rename (prefix, suffix, numbering, find/replace with preview)
• Share link generation (copy to clipboard)
• File hash comparison (MD5, SHA1 — select 2 files)
• Compress files (ZIP, local files)
• Preserve original dates on transfer (rclone default + settings toggle)
• Trash management (deletion history + clear)

4. Transfer

• Transfer queue with real-time progress tracking (1-second polling)
• Transfer history (Active / Completed / Errors tabs)
• Pause / Resume all transfers (bandwidth throttle)
• Stop / Restart individual and all transfers
• Transfer restart from history (copyOrigins tracking)
• Resizable transfer panel
• Multi-threaded transfer speed optimization (configurable streams)
• Time-based bandwidth limit scheduling (per-hour rules)
• Detailed transfer reports (summary + clipboard copy)

5. Sync & Backup

• Mirror — full replication from source to target (sync/sync)
• Mirror Updated — copy only changed files (sync/copy)
• Bidirectional sync (Bisync)
• Sync profile management (save/load/delete)
• Sync execution logs
• Custom sync rules (exclude/include/size/age rule builder)
• Filter rules (ExcludeRule applied to sync operations)

6. Scheduling & Automation

• Task scheduler (custom interval in minutes)
• Enable/disable individual tasks
• Background execution (menu bar resident)
• CLI mode support (list, remotes, copy, move, mkdir)
• Schedule logging (disk persistence + export)

7. Encryption

• rclone crypt remote setup (password, salt, filename encryption, directory name encryption)
• Encrypted cloud-to-cloud transfer (via crypt remote)

8. Search

• BFS streaming search across all connected clouds (concurrent, incremental results)
• Multi-cloud simultaneous search
• Cloud filter toggles (select which remotes to search)
• Filtering: file type, file size range
• Filtering: date range, path

9. Account Management

• Unlimited account connections per service
• Multiple accounts for the same service
• Add account — dynamic provider-specific config fields
• Edit account — rename and edit config values
• Delete account (with confirmation)
• Provider search (filter by name/description)
• Local credential storage (via rclone config)
• Account import/export (JSON config dump)

10. Settings

• rclone options GUI (transfers, checkers, multi-thread-streams, buffer-size, etc.)
• Bandwidth limit (bwlimit)
• Persistent settings with auto-save (debounced)
• Restore defaults
• Multi-language support (Korean / English)
• App restart on language change

11. Security

• App lock with password (Keychain storage)
• Touch ID unlock
• Lock screen with shake animation on wrong password

12. Cloud Mount

• Mount cloud storage as local drive (rclone mount)
• Unmount
• Active mount list

13. Storage Pooling

• Union remote creation (pool multiple remotes)
• Storage quota display in status bar

14. Additional Features

• Online media playback (AVKit, cloud files temp-downloaded)
• Cloud storage quota check (per-remote detailed view with progress bars)

Roadmap

v1.2.0 — Tier 1: Pro Features

• Finder Services integration (right-click → "Upload to RcloneGUI")
• Resume interrupted transfers (checkpoint + auto-retry, max 3)
• Onboarding flow (first-time user guide, 3-step wizard)
• Smart error recovery (auth/quota/network/404/rate-limit classification)

v1.3.0 — Tier 2: Integration

• URL scheme (rclonegui://open, mount, sync, upload)
• Shortcuts integration (List Remotes, List Files, Copy File, Create Folder)
• Quick Upload (sidebar button + NSOpenPanel)
• Keyboard navigation (Enter/Delete/↑↓←→/Space/Tab)

v1.4.0 — Tier 3: Polish

• Spotlight integration (CoreSpotlight indexing + result click)
• Smart duplicate detection (size + MD5 cross-cloud scan)
• File versioning & history (operations/stat)
• Large directory performance (file count bar + drawingGroup)

v2.0.0 — Tier 4: Vision

• AI-powered file organization & search
• Local folder ↔ Cloud real-time sync (Dropbox-style)
• Collaboration (team folders, permissions)

Tech Stack

• Language: Swift
• UI: SwiftUI + AppKit
• State Management: @Observable (macOS 14+)
• rclone Integration: librclone (C shared library via FFI)
• Project Structure: Swift Package Manager (RcloneKit, FileBrowser, TransferEngine)
• Minimum OS: macOS 14 (Sonoma)
• Version: 1.4.4

Getting Started

# Build librclone
./scripts/build-librclone.sh

# Open in Xcode
open RcloneGUI.xcodeproj

# Build and run
# Cmd+R in Xcode

# Run automated tests (188 tests)
./scripts/run-tests.sh

License

MIT License