document nix-on-droid as an alternative to termux

Sponsored-by: Graham Spencer on Patreon
This commit is contained in:
Joey Hess 2022-03-07 12:57:16 -04:00
parent 5154d15183
commit 675a491632
No known key found for this signature in database
GPG key ID: DB12DB0FF05F8F38
2 changed files with 35 additions and 13 deletions

View file

@ -1,6 +1,7 @@
git-annex is available for Android inside Termux. This includes the git-annex is available for Android inside Termux or Nix-On-Droid.
[[git-annex assistant|/assistant]], for easy syncing between your Android This includes the [[git-annex assistant|/assistant]], for easy
and other devices. You do not need to root your Android to use git-annex. syncing between your Android and other devices. You do not need
to root your Android to use git-annex.
(Alternatively, rather than installing git-annex on your Android device, (Alternatively, rather than installing git-annex on your Android device,
git-annex can run on your computer and use `adb` to pull and push changes git-annex can run on your computer and use `adb` to pull and push changes
@ -9,7 +10,7 @@ on using git-annex that way.)
[[!toc ]] [[!toc ]]
## Installation ## Installation (Termux)
First, install [Termux](https://termux.com/). This is an Android app that can First, install [Termux](https://termux.com/). This is an Android app that can
run some Linux software in a terminal, including git-annex. run some Linux software in a terminal, including git-annex.
@ -21,9 +22,24 @@ to install it. Paste these commands into Termux:
wget https://git-annex.branchable.com/install/Android/git-annex-install wget https://git-annex.branchable.com/install/Android/git-annex-install
source git-annex-install source git-annex-install
## Starting git-annex ## Installation (Nix-On-Droid)
To start git-annex, just run "git annex webapp" inside Termux. Installing git-annex using
[Nix-On-Droid](https://github.com/t184256/nix-on-droid) is recommended
for more advanced users who want to use git-annex at the command line.
The git-annex webapp does not currently work in Nix-On-Droid.
To enter a shell with git-annex available to use,
run inside Nix-On-Droid: `nix-shell -p git git-annex`
To avoid needing to do that every time you start Nix-On-Droid,
you can add git and git-annex to your `environment.packages` in
`~/.config/nixpkgs/nix-on-droid.nix` and then run
`nix-on-droid switch`
## Starting git-annex assistant
Just run "git-annex webapp" inside Termux.
A browser window will open with the git-annex interface. A browser window will open with the git-annex interface.
[[!img webapp.png alt="git-annex webapp"]] [[!img webapp.png alt="git-annex webapp"]]
@ -31,8 +47,8 @@ A browser window will open with the git-annex interface.
## Closing and reopening the webapp ## Closing and reopening the webapp
The webapp does not need to be left open after you've set up your The webapp does not need to be left open after you've set up your
repository. As long as Termux is left open, git-annex will repository. As long as Termux (or Nix-On-Droid) is left open, git-annex
remain running and sync your files. will remain running and sync your files.
## Starting at power on ## Starting at power on
@ -44,11 +60,11 @@ set up in the webapp.
## Using the command line ## Using the command line
If you prefer to use `git-annex` at the command line, you can do so inside If you prefer to use `git-annex` at the command line, you can do so inside
Termux. Here we'll make a repository for photos: Termux or Nix-On-Droid. Here we'll make a repository for photos:
cd ~/storage/dcim cd ~/storage/dcim
git init git init
git annex init git-annex init
You can go on to set up a ssh remote pointing to a server, and sync You can go on to set up a ssh remote pointing to a server, and sync
your files to and from it. your files to and from it.
@ -56,6 +72,6 @@ your files to and from it.
And so on. Most ways you would use git-annex on a Linux system work fairly And so on. Most ways you would use git-annex on a Linux system work fairly
well in the Termux environment. well in the Termux environment.
## Upgrading ## Upgrading (Termux)
To upgrade to a new git-annex release, just run `git-annex-install` again. To upgrade to a new git-annex release, just run `git-annex-install` again.

View file

@ -5,6 +5,12 @@
content=""" content="""
@Atemu great tip! I had seen nix-on-droid and wondered about it. @Atemu great tip! I had seen nix-on-droid and wondered about it.
Perhaps this would be worth documenting in [[Android]] as an alternative to I have added some instructions based on your comment
termux. to [[/Android]].
Looks like `git-annex webapp` does not work in nix-on-droid,
because it cannot open a web page. Perhaps there is some way to
do that; on termux git-annex uses xdg-open, but I tried it on nix-on-droid
and it does not work. For now I documented nix-on-droid as an alternative
for users who want to use git-annex at the command line.
"""]] """]]