RSAF

RSAF is an Android document provider for the wonderful rclone. It allows any app that supports Android's Storage Access Framework (SAF) to access remote files via rclone's backends.

RSAF is not itself a file manager, but any file manager supporting SAF, including the one built into Android (Settings -> Storage -> Documents), can make use of it.

Features

- Supports Android 9 and newer - Supports all rclone remote backends, including those that require OAuth 2.0 - Supports importing and exporting the rclone configuration file - Supports random reads - Supports server-side copy/move for rclone backends implementing this feature - Supports client applications that request access to a file descriptor - Supports client applications that open entire directories with ACTION_OPEN_DOCUMENT_TREE - Supports pretending to be local storage for apps that block remote SAF roots - No required permissions besides network access

File operation semantics

When creating, renaming, copying, or moving a file/directory, RSAF will add a counter to the filename to try and avoid conflicts (eg. file(1).txt) if the target path already exists. This matches the Storage Access Framework's behavior for local files, though RSAF extends this to copying/moving instead of just file creation/renaming. However, this feature cannot be implemented in a completely foolproof way. If two client applications try to create files with the same name at the same time, they still might end up clobbering each other's data, even with the added counter.

Usage

1. Download the latest APK.

2. Import an existing rclone configuration or configure one from scratch within RSAF.

3. That's it! The configured remotes are now available via the Storage Access Framework.

License

GNU General Public License v3.0