summaryrefslogtreecommitdiff
path: root/doc
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
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')
-rw-r--r--doc/assistant/downloadnotification.pngbin0 -> 4550 bytes
-rw-r--r--doc/assistant/nautilusmenu.pngbin0 -> 59867 bytes
-rw-r--r--doc/related_software.mdwn1
-rw-r--r--doc/tips/file_manager_integration.mdwn31
4 files changed, 31 insertions, 1 deletions
diff --git a/doc/assistant/downloadnotification.png b/doc/assistant/downloadnotification.png
new file mode 100644
index 000000000..5cb3961d9
--- /dev/null
+++ b/doc/assistant/downloadnotification.png
Binary files differ
diff --git a/doc/assistant/nautilusmenu.png b/doc/assistant/nautilusmenu.png
new file mode 100644
index 000000000..d7926e34f
--- /dev/null
+++ b/doc/assistant/nautilusmenu.png
Binary files differ
diff --git a/doc/related_software.mdwn b/doc/related_software.mdwn
index 1b5579628..66abad8df 100644
--- a/doc/related_software.mdwn
+++ b/doc/related_software.mdwn
@@ -11,4 +11,3 @@ designed to interoperate with it.
utility, with a `-A` switch that enables git-annex support.
* Emacs Org mode can auto-commit attached files to git-annex.
* [git annex darktable integration](https://github.com/xxv/darktable-git-annex)
-* [Nautilus file manager ingegration](https://gist.github.com/ion1/9660286)
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.