-
Notifications
You must be signed in to change notification settings - Fork 161
Home
RcloneExplorer is an Android application that integrates cloud providers using rclone for cloud storage and Android platform interfaces for local storage.
When you open up rcloneExplorer for the first time, rcloneExplorer will ask you import a rclone configuration file (rclone.conf
) or create a new one by adding a remote with (+). A "remote" is a single configured cloud location in rclone.
There are various types of remotes and rcloneExplorer supports all storage remotes and most of the meta-remotes like crypt that encrypts other remotes and union that combines multiple remotes. You can see all supported remote types on rclone.org. Note that you can only configure some types inside of the app, but you can always import a configuration to allow more remote types.
Keep in mind that rclone does not supports all features on all remotes (see optional feature matrix)- and for larger file operations, you need both a stable network connection and enough battery.
Feature Quality: Beta, data loss can occur but generally shouldn't.
Starting in Android 10, applications no longer have direct access to user-visible file storage. As a result, rclone can no longer access your files using standard Linux file APIs and your "local" remotes won't be very useful.
Starting in version 1.9.0, rcloneExplorer features a new storage frontend/backend system that uses the Storage Access Framework, an Android 4.4+ system for managing file and file tree-like content. You must enable this feature in Settings
> File Access
>Enable SAF Client Preview
. Then you can add any SAF-accessible storage location using Add Storage
.
This will launch the system's file manager, allowing you to grant access to any storage location.
- Select "Add Storage". The system file manager will open.
- Open the left hand drawer ☰. A list of storage locations be shown, depending on whether your system has a hardware SD card or a USB drive attached.
- Select a storage location by tapping the drawer item. Then, tap "SELECT " on the bottom to give rcloneExplorer access to this storage location.
On some devices, not all accessible storage locations are displayed by default. When the system file manager opens, you can tap on the right hand menu: ⋮
And then select "Show internal storage". Afterwards, all storage locations should be visible.
Note that storage provided by third party apps can currently not be correctly read by the internal rclone and is therefore inaccessible.
Full Tree Access (Intent#ACTION_OPEN_DOCUMENT_TREE)
- Android: access Internal Storage, SD cards, USB drives
- exFAT/NTFS for USB by Paragon Software - does not work.
Feature Quality: Preview, data loss is expected!
In addition to to reading local storage via the Storage Access Framework, rcloneExplorer version 1.10.0+ can allow other apps to access files on your cloud remotes from within those apps. You must enable this feature in Settings
> File Access
>Enable Content Provider Preview
. Other apps can then be granted access to cloud files, just like rcloneExplorer uses these interfaces to access local content.
Generally, all apps should be compatible if they have implemented SAF correctly, but the ones below were actually tested.
However, most applications seem to expect only disk-based files and therefore don't work correctly with streamed files like rcloneExplorer provides. Android 8 and above work much better here since we can hook into the system's fuse layer and make even cloud files seem like actual files.
Full Tree Access (Intent#ACTION_OPEN_DOCUMENT_TREE)
- DocumentsUI ("Files" app on Android 10, "Downloads" on previous versions). Unless your file explorer proxies the file to the opening application, you have to use this to get correct permissions for the opening application.
- Total Commander - file browsing only, no read/write operations
Open A Single File (Intent#ACTION_OPEN_DOCUMENT)
- OneDrive - upload unstable
- Google Drive - upload fails
Create A Single File (Intent#ACTION_CREATE_DOCUMENT)
- (none)