Skip to content

karilaa-dev/rclone-mount-magisk

Repository files navigation

Cloud Storage Mounter for Magisk (prev: rclone-mount)

Version _time_stamp_ _time_stamp_

Mount and sync your cloud storage on your Android device using rclone & fusermount3, providing virtually limitless storage expansion with support for dozens of cloud providers.


Supported Android Versions

Android Version API Level Status
Android 11+ API 30+ Fully supported (uses fusermount3)
Android 7-10 API 24-29 Supported (legacy fusermount)
Android 5-6 API 21-23 May work, not officially tested

Note: This module requires Magisk 20.0+, KernelSU, or APatch.

Features

  • Support for arm, arm64, & x86 (64bit too)
  • Huge list of supported cloud storage providers
  • Apps with ability to specify paths can access the remotes at /mnt/cloud/.
  • Most file explorers work just fine (read more on this).
  • Mount points use names of remote(s) in rclone.conf
  • Specify custom rclone params for each remote via /sdcard/.rclone/.REMOTE.param
  • Access remotes via HTTP or (S)FTP clients, or bind the remotes to /sdcard/Cloud/REMOTE (recommended to read this).
  • Support for Work Profiles.

Recent Changes

v1.15

  • Updated for Android 11+ (API 30+) compatibility
  • Upgraded from fusermount to fusermount3 for modern Android support
  • Updated all binaries to latest versions:
    • rclone v1.72.1
    • fusermount3 (from fuse3)
    • inotifywait (latest from Termux)
    • libandroid-support.so (latest from Termux)
  • Added GitHub Actions for automated binary updates and releases

For full changelog, see CHANGELOG.md.

Configuration

  1. Copy your rclone.conf file (if you have one already) to /sdcard/.rclone/rclone.conf (can always be generated later.)
  2. Add custom params at /sdcard/.rclone/.[global/REMOTE].param (if needed)
  3. Install the module via Magisk Manager
  4. Run rclone config via term if additional setup required
  5. All your rclone mount points will show up under /mnt/cloud/ & /storage/cloud/ or /sdcard/cloud/

For more detailed configuration of rclone please refer to official documentation

Known Issues

  • VLC takes a long time to load media as it opens file in write mode when using it's internal browser.

    a. Create remote type alias for media dirs in rclone.conf and specify CACHEMODE=off in /sdcard/.rclone/.ALIASNAME.param

  • Encrypted devices can not mount until unlock

  • Encrypted rclone.conf causes reboots

  • High cpu/mem in some apps with storage perms (issue #9)

  • The fusermount3 bin may not be compatible on all devices (see thread)

Disclaimer

  • Neither the author nor devs will be held responsible for any damage/data loss that may occur during use of this module.
  • While we have done our best to make sure no harm will come about, no guarantees can be made.
  • Keep in mind the binaries included in this project are BETA quality (at best), which may cause unforseen issues.

Always check this document before updating to new releases as significant changes may occur.

Credits

Original Projects

Contributors & Resources

About

Rclone mount module for Magisk (API 30+ update)

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages