summaryrefslogtreecommitdiff
path: root/doc/tips/file_manager_integration.mdwn
diff options
context:
space:
mode:
authorGravatar Joey Hess <joey@kitenet.net>2014-03-22 15:51:30 -0400
committerGravatar Joey Hess <joey@kitenet.net>2014-03-22 15:51:30 -0400
commit24fd8b2ea04a66233ffdb51b8c113ac9129ed410 (patch)
tree3da2ad0ec27ecc8aae9cfdb97290543ae74a6ea1 /doc/tips/file_manager_integration.mdwn
parent123c9520fb9a4197761cb57e17605eed2bb882ec (diff)
webapp: Automatically install Nautilus integration scripts to get and drop files.
This commit was sponsored by Gian-Maria Daffre.
Diffstat (limited to 'doc/tips/file_manager_integration.mdwn')
-rw-r--r--doc/tips/file_manager_integration.mdwn31
1 files changed, 31 insertions, 0 deletions
diff --git a/doc/tips/file_manager_integration.mdwn b/doc/tips/file_manager_integration.mdwn
new file mode 100644
index 000000000..18210b8ee
--- /dev/null
+++ b/doc/tips/file_manager_integration.mdwn
@@ -0,0 +1,31 @@
+Integrating git-annex and your file manager provides an easy way to select
+annexed files to get or drop.
+
+## nautilus
+
+Recent git-annex comes with built-in nautilus integration. Just pick the
+action from the menu.
+
+[[!img assistant/nautilusmenu.png]]
+
+[[!img assistant/downloadnotification.png]]
+
+This is set up by making simple scripts in
+`~/.local/share/nautilus/scripts`, with names like "git-annex get"
+
+## your file manager here
+
+Edit this page and add instructions!
+
+## general
+
+If your file manager can run a command on a file, it should be easy to
+integrate git-annex with it. A simple script will suffice:
+
+ #!/bun/sh
+ git-annex get --notify-start --notify-finish "$@"
+
+The --notify-start and --notify-stop options make git-annex display a
+desktop notification. This is useful to give the user an indication that
+their action took effect. Desktop notifications are currently only
+implenented for Linux.