This special remote stores files on an Android device.
The adb
program is used to access the Android device, which
allows connecting to it in various ways like a USB cable or wifi.
example
To add a remote for the /sdcard/DCIM directory on the Android device, allowing to import and export photos:
git annex initremote android type=adb androiddirectory=/sdcard/DCIM encryption=none exporttree=yes importtree=yes
git annex export master --to android
configuration
A number of parameters can be passed to git annex initremote
to configure
the adb remote.
androiddirectory
- Set to the location on the Android device where files for the special remote are stored.androidserial
- Normally this is not needed, but if multiple Android devices are accessible, you'll be prompted to use it to specify which one to use.exporttree
- Set to "yes" to make this special remote usable by git-annex-export. It will not be usable as a general-purpose special remote. Since this makes the exported files easily browsable on the Android device, you will almost always want to enable this.importtree
- Set to "yes" to make this special remote usable by git-annex-import. When set in combination with exporttree, this lets files be imported from it, and changes exported back to it.encryption
- One of "none", "hybrid", "shared", or "pubkey". See encryption.keyid
- Specifies the gpg key to use for encryption.chunk
- Enables chunking when storing large files.
@iakornfeld, like all special remotes, the git repository is not stored in the special remote, only the content of annexed files.
Using
git annex export
like in the example, the android device will contain files with the same names as those in your git-annex repository.If you want to use a git-annex repository on the Android device, see Android instead of this. However, for pushing a tree of annexed files to Android device and updating it, this special remote can be a good fit.