GitPlanet

Cheap and reliable Node.js hosting starts at $3/month, and $1/month static HTML hosting

Created with love in Canada, visit hostnodejs.com today

Feel like to post an Ad? Learn Details
All Projects → VR-25 → fbind

VR-25 / fbind

Licence: GPL-3.0 License
A versatile Android mounting utility for folders, EXT4 images, LUKS/LUKS2 encrypted volumes, regular partitions and more.

Programming Languages

shell
77523 projects

Labels

androidfusestoragefoldermountmagiskcryptsetupsdcardbind-mountsdcardfsfoldermount

Projects that are alternatives of or similar to fbind

Infinit
The Infinit policy-based software-defined storage platform.
Stars: ✭ 363 (+764.29%)
Mutual labels:  fuse, storage
fuse-nfs-crossbuild-scripts
fuse-nfs for windows using dokany
Stars: ✭ 35 (-16.67%)
Mutual labels:  fuse, mount
Moosefs
MooseFS – Open Source, Petabyte, Fault-Tolerant, Highly Performing, Scalable Network Distributed File System (Software-Defined Storage)
Stars: ✭ 1,025 (+2340.48%)
Mutual labels:  fuse, storage
k2hftfuse
File transaction by FUSE-based file system
Stars: ✭ 30 (-28.57%)
Mutual labels:  fuse, mount
ipfs-api-mount
Mount IPFS directory as local FS.
Stars: ✭ 16 (-61.9%)
Mutual labels:  fuse, mount
py-hdfs-mount
Mount HDFS with fuse, works with kerberos!
Stars: ✭ 13 (-69.05%)
Mutual labels:  fuse, mount
magisk-module-template-eviltheme
Magisk Module Template with built in EVilTheme Patcher
Stars: ✭ 25 (-40.48%)
Mutual labels:  magisk
kubernetes
Quobyte / Kubernetes integration (DEPRECATED - use Quobyte CSI)
Stars: ✭ 24 (-42.86%)
Mutual labels:  storage
LocationReportEnabler
Enable Google Location History in regions not available.
Stars: ✭ 41 (-2.38%)
Mutual labels:  magisk
Kvpbase
Scalable, simple RESTful object storage platform, written in C#
Stars: ✭ 43 (+2.38%)
Mutual labels:  storage
benji
📁 This library is a Scala reactive DSL for object storage (e.g. S3/Amazon, S3/CEPH, Google Cloud Storage).
Stars: ✭ 18 (-57.14%)
Mutual labels:  storage
cgroupfs
Cgroupfs provides an emulated /proc/meminfo, /proc/cpuinfo... for containers
Stars: ✭ 28 (-33.33%)
Mutual labels:  fuse
gobazel
gobazel is a tool to help golang bazel developers to map bazel's folder structure to golang's standard folder structure, through FUSE (thus only works for Linux and MacOS users).
Stars: ✭ 28 (-33.33%)
Mutual labels:  fuse
hermitage-skeleton
Hermitage Skeleton
Stars: ✭ 16 (-61.9%)
Mutual labels:  storage
golddrive
Windows ssh network drive
Stars: ✭ 30 (-28.57%)
Mutual labels:  mount
lockbox-datastore
Experimental Data Storage module for Firefox Lockbox project, not being actively developed
Stars: ✭ 26 (-38.1%)
Mutual labels:  storage
ddrive
A lightweight cloud storage system using discord as storage device written in nodejs
Stars: ✭ 25 (-40.48%)
Mutual labels:  storage
ioBroker.backitup
Backitup enables the cyclical creation of backups of an IoBroker / Homematic installation
Stars: ✭ 43 (+2.38%)
Mutual labels:  mount
redis-fs
Mount a Redis database as a filesystem using fuse.
Stars: ✭ 76 (+80.95%)
Mutual labels:  fuse
Wireless SD
A SD card reader which let's wireless data transfer for any device which supports FTP
Stars: ✭ 47 (+11.9%)
Mutual labels:  sdcard
View All Similar Projects ➔

fbind

DESCRIPTION

fbind is a versatile mounting utility for folders, disk images, LUKS/LUKS2 encrypted volumes, regular partitions and more.

LICENSE

Copyright (C) 2017-2021, VR25 @ xda-developers

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.

DISCLAIMER

Always read/reread this reference prior to installing/upgrading this software.

While no cats have been harmed, the author assumes no responsibility for anything that might break due to the use/misuse of it.

To prevent fraud, do NOT mirror any link associated with this project; do NOT share flashabe zips! Share official links instead.

WARNING

fbind uses fsck, mount, umount and other low level programs that may cause data corruption/loss. The author assumes no responsibility under anything that might break due to the use/misuse of this software. By choosing to use/misuse it, you agree to do so at your own risk!

PRE-REQUISITES

  • Android or Android-based OS rooted with Magisk
  • cryptsetup (for encryption, optional)
  • Terminal emulator (or adb shell) and/or text editor

Note: executables such as cryptsetup can be placed in /data/adb/vr25/bin/ (with proper permissions) instead of being installed system-wide.

CONFIG SYNTAX

bind_mount <target> <mount point> Generic Bind-mount

e.g., bind_mount $extsd/loop_device/app_data/spotify /data/data/com.spotify.music

extsd_path <path> Use path as extsd.

e.g., extsd_path /mnt/mmcblk1p2

from_to <source> <dest> Wrapper for bind_mount <$extsd/[path]> <$intsd/[path]>

e.g., from_to WhatsApp .WhatsApp

int_extf <path> Bind-mount the entire user 0 (internal) storage to $extsd/<path> (implies obb). If <path> is not supplied, .fbind is used.

e.g., int_extf .external_storage

intsd_path <path> Use path as intsd.

e.g., intsd_path /storage/emulated/0

loop <disk image> <mount point> Mount a disk image, a.k.a., loop device. fsck -fy (adaptive) is implied.

e.g., loop $extsd/loop.img $intsd/loop

noAutoMount Disable on boot auto-mount.

obb Wrapper for bind_mount $extobb $obb

obbf <package name> Wrapper for bind_mount $extobb/<package name> $obb/<package name>

e.g., obbf com.mygame.greatgame

part [-o <mount option...>] <[block device[--L[,password]]]> <mount point> ["fsck <option...>"] Auto-mount a partition. The --L flag is for LUKS/2 volume, opened manually by running any fbind command. The filesystem is automatically detected. The defaut mount options are rw and noatime. e2fsck -fy is always used for supported filesystems.

e.g.,

part /dev/block/mmcblk1p1 /mnt/_sdcard

part -o nodev,noexec,nosuid /dev/block/mmcblk1p1 /mnt/_sdcard

permissive Set SELinux mode to permissive.

prefix=<path> Sets emulated storage path prefix (excluding emulated/*).

e.g., prefix=/mnt/runtime/full

An alternative to modifying the config is running prefix=/mnt/runtime/full fbind --remount

remove <target>>Auto-remove stubborn/unwanted file/folder from $intsd & $extsd.

e.g., remove Android/data/com.facebook.orca

target <path> Wrapper for bind_mount <$extsd/[path]> <$intsd/[same path]>

e.g., target Android/data/com.google.android.youtube

CONFIG EXAMPLES

# All OBBs to $extsd/Android/obb/
obb

# Select OBBs to $extsd/Android/obb/
obbf com.somegame.greatgame

# $intsd/target/ to $extsd/sameTarget/
#  For non-media folders only
target TitaniumBackup

# $intsd/someFolder/ to $extsd/.someFolder/
#  Prevents duplicate media
from_to DCIM .fbind/DCIM
from_to Pictures .fbind/Pictures
from_to WhatsApp .fbind/WhatsApp

# Multiuser -- user11/someFolder/ to $extsd/someFolder/
bind_mount $extsd/someFolder ${intsd/%0/11}/someFolder

# Mount a partition and use it as $extsd
part /dev/block/mmcblk1p2 /mnt/p2
extsd_path=/mnt/p2

TERMINAL COMMANDS

Usage:
  fbind (wizard)
  fbind [option...] [argument...]

-a|--auto-mount
Toggle auto-mount on boot (default: enabled).

-b|--bind-mount <target> <mount point>
Bind-mount folders not listed in config.txt.
SDcarsFS read and write runtime paths are handled automatically.
Missing directories are created accordingly.
e.g., fbind -b /data/someFolder /data/mountHere

-c|--config [editor] [option...]
Open config.txt w/ [editor] [option...] (default: vim|vi|nano).
e.g., fbind -c nano -l

-C|--cryptsetup [option...] [argument...]
Run cryptsetup [option...] [argument...].

-f|--fuse
Toggle FUSE usage for emulated storage (default: off).

-h|--help
List all commands.

-l|--log [editor] [option...]
Open service.log w/ [editor] [option...] (default: more|vim|vi|nano).
e.g., fbind -l

-m|--mount [egrep regex]
Bind-mount matched or all (no arg).
e.g., fbind -m "Whats|Downl|part"

-M|--move [ext. regex]
Move matched or all (no args) to external storage.
Only unmounted folders are affected.
e.g., fbind -M "Download|obb"

-Mm [egrep regex]
Same as "fbind -M [arg] && fbind -m [arg]"
e.g., fbind -Mm

-r|--readme
Open README.md w/ [editor] [option...] (default: more|vim|vi|nano).

-R|--remove [target]
Remove stubborn/unwanted file/folder from \$intsd and \$extsd.
By default, all "remove" lines from config are included.
e.g., fbind -R Android/data/com.facebook.orca

-t|--test-prefixes
Test internal storage prefixes (views) and automatically update the config.

-u|--unmount [mount point or egrep regex]
Unmount matched or all (no arg).
This works for regular bind-mounts, SDcardFS bind-mounts, regular partitions, loop devices and LUKS/LUKS2 encrypted volumes.
Unmounting "all at once" (no arg) does not affect partitions nor loop devices.
These must be unmounted with a regex argument.
For unmounting folders bound with the --bind-mount option, the mount points must be supplied, since those are not in config.txt.
e.g., fbind -u "loop|part|Downl"

-um|--remount [egrep regex]
Remount matched or all (no arg).
e.g., fbind -um "Download|obb"

-v|--version
Print version code (integer)

NOTES

  • Recent Magisk versions disable all modules when the system boots in safe mode. Keep this in mind, just in case you face a bootloop - although, in most cases, fbind will automatically revert problematic changes.

  • If you find terminal overwhelming, just run fbind and follow the wizard.

  • Always enforce Unix line endings (LF) when editing config.txt. NEVER use Windows Notepad for that!

  • Available free space in internal storage may be misreported.

  • [Some] file managers may show multiple SDcard/storage locations.

  • [FUSE] Some users may need to set intsd_path /storage/emulated/0 (default is /data/media/0).

  • If you stumble upon inaccessible folders or read-only access, try forcing FUSE (fbind -f) usage for emulated storage. If your system does not support FUSE, it may get into a bootloop. If that happens, fbind will revert the change automatically on the next boot attempt. To revert it manually, either run fbind -f again or remove /data/adb/modules/fbind/system.prop to FUSE.prop and remove /data/adb/vr25/fbind-data/.FUSE.

  • Logs are stored at /data/adb/vr25/fbind-data/logs/.

  • [SDcardFS] Remounting /mnt/runtime/write/... may cause a system reboot. When this happens, fbind learns to skip it. However, if the system reboots for a reason other than this, fbind will mistakenly create /data/adb/vr25/fbind-data/.noWriteRemount. If you stumble across broken bind mounts, remove that file and remount all folders. To do that in one shot, run rm /data/adb/vr25/fbind-data/.noWriteRemount; fbind -um.

  • Rebooting is not required after installing/upgrading. If /sbin is missing (many Android 11 based systems lack it), use the /dev/.vr25/fbind/fbind executable until you reboot - e.g., /dev/.vr25/fbind/fbind -m.

LINKS

LATEST CHANGES

v2021.12.2 (202112020)

  • Enhanced flashable zip generator;
  • Implemented losetup wrapper for greater compatibility;
  • Improved partition and image file mount logics;
  • Preliminary work on the appdata binding wizard;
  • Reordered emulated storage prefix fallbacks to cover another Android 11+ quirk.

v2021.12.2.1 (202112021)

  • Auto-mount hotfix

v2021.12.6 (202112060)

  • Added TOC to readme;
  • General optimizations;
  • Improved Android 11+ support.
Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected].