Skip to content
x0b edited this page Oct 6, 2019 · 9 revisions

Documentation

RcloneExplorer is an Android application that integrates cloud providers using rclone for cloud storage and Android platform interfaces for local storage.

Table of Contents

Basic Setup

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.

Adding local storage (SAF)

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.

Selecting a storage location

  1. Select "Add Storage". The system file manager will open.
  1. 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.
  1. Select a storage location by tapping the drawer item. Then, tap "SELECT " on the bottom to give rcloneExplorer access to this storage location.

My SD card or internal storage is not displayed in the list

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.

App Compatibility

Note that storage provided by third party apps can currently not be correctly read by the internal rclone and is therefore inaccessible.

RcloneExplorer 1.10 feature preview

Accessing cloud content from other apps (VCP)

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.

App Compatibility

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.

  • 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.
    • MediaInfo - worked with mp3, mp4 and mkv
    • VLC - worked with mp3, mp4 and mkv
    • Excel - works: xlsx (readonly)
    • Firefox - does not work at all
    • Google Fotos - works: png
    • Word - works: docx (readonly)
    • ZArchiver - does not work at all (tested zip, 7z)
  • Total Commander - file browsing only, no read/write operations
Open A Single File (Intent#ACTION_OPEN_DOCUMENT)
Create A Single File (Intent#ACTION_CREATE_DOCUMENT)
  • (none)