initial draft

1 files changed, 67 insertions, 0 deletions

diff --git a/USE.md b/USE.md
new file mode 100644
index 0000000..7fb8d36
--- /dev/null
+++ b/USE.md
@@ -0,0 +1,67 @@
+# Using media masters syncronized with Android
+
+## Fetch from Android
+
+Finishing a photo session,
+connect the phone to the computer with USB cable and use the following command:
+
+	git annex sync --content phone
+
+Move the synchronized photos
+(exchange 210724-1 with the actual date):
+
+	mkdir 210724-1
+	git mv incoming/OpenCamera/* 210724-1
+	git annex fix
+
+### If connection fails...
+
+Under the hood,
+git annex uses ADB to connect to the Android system.
+The ADB connection requires physically connecting the device,
+but also the Android system needs to permit ADB access.
+
+If connection fails,
+then check on the Android system that ADB is active
+(e.g. a status message saying "USB debugging enabled").
+Otherwise try disconnect and reconnect cables,
+and if still no indication that ADB is enabled
+then go into system setup below developer setting
+and enable ADB debugger,
+and then disconnect and reconnect again.
+
+
+## Flush Android storage
+
+Empty the camera of the synced photos:
+
+	git annex sync --content phone
+
+
+## Unlock
+
+If there is need for editing media files,
+they need to first be "unlocked".
+
+You can unlock a specific file:
+
+	git annex unlock 210724-1/my_precious_file.jpg
+
+...or a directory:
+
+	git annex unlock 210724-1
+
+
+## Lock
+
+To ensure integrity of annexed files
+(and to save space: unlocked files require two copies),
+make sure to lock when done editing.
+
+You can lock a specific file:
+
+	git annex lock 210724-1/my_precious_file.jpg
+
+...or a directory:
+
+	git annex lock 210724-1