Add a firefox add-on

tools/webextension/README.md

@@ -0,0 +1,10 @@
+# Webextension for Docspell
+
+Idea: Inside the browser click on a PDF and send it to docspell. It is
+downloaded in the context of your current page. Then handed to an
+application that finally pushes it to docspell.
+
+Please see the
+[microsite](https://eikek.github.io/docspell/doc/tools.html) for
+instructions or navigate to the corresponding [markdown
+file](../../modules/microsite/src/main/tut/doc/tools.md#webextension-for-docspell).

tools/webextension/_locales/de/messages.json

@@ -0,0 +1,25 @@
+{
+  "extensionName": {
+    "message": "Docspell Upload Helper",
+    "description": "Name of the extension"
+  },
+
+  "extensionDescription": {
+    "message": "Lädt Dateien vom Browser zu Docspell.",
+    "description": "Description of the extension."
+  },
+
+  "notificationTitle": {
+    "message": "Docspell Antwort",
+    "description": "Title of the click notification."
+  },
+
+  "notificationSuccess": {
+    "message": "Die Datei wurde zu Docspell kopiert.",
+    "description": "Tells the user about the success of the upload."
+  },
+  "notificationFailure": {
+    "message": "Die Datei konnte nicht zu Docspell kopiert werden. Ist es evtl. keine PDF Datei?",
+    "description": "Tells the user about the failure of the upload."
+  }
+}

tools/webextension/_locales/en/messages.json

@@ -0,0 +1,25 @@
+{
+  "extensionName": {
+    "message": "Docspell Upload Helper",
+    "description": "Name of the extension"
+  },
+
+  "extensionDescription": {
+    "message": "Copies files from the browser to Docspell.",
+    "description": "Description of the extension."
+  },
+
+  "notificationTitle": {
+    "message": "Docspell Response",
+    "description": "Title of the click notification."
+  },
+
+  "notificationSuccess": {
+    "message": "The file has been uploaded to Docspell.",
+    "description": "Tells the user about the success of the upload."
+  },
+  "notificationFailure": {
+    "message": "The file could not be uploaded to Docspell. Maybe it's not a PDF file?",
+    "description": "Tells the user about the failure of the upload."
+  }
+}

tools/webextension/docspell.js

@@ -0,0 +1,87 @@
+function onCreated() {
+  if (browser.runtime.lastError) {
+    console.log(`Error: ${browser.runtime.lastError}`);
+  }
+}
+
+function onError(error) {
+  console.log(`Error: ${error}`);
+}
+
+function showResult(response) {
+    console.log(`Response: ${response}`);
+    var title = browser.i18n.getMessage("notificationTitle") || "Docspell Response";
+    var content = "";
+    if (response == 0) {
+        content = browser.i18n.getMessage("notificationSuccess");
+    } else {
+        content = browser.i18n.getMessage("notificationFailure");
+    }
+    browser.notifications.create({
+        "type": "basic",
+        "iconUrl": browser.extension.getURL("icons/logo-48.png"),
+        "title": title,
+        "message": content
+    });
+}
+
+function pushDocspell(items) {
+    for (let item of items) {
+        console.log(`Pushing to docspell: ${item.filename}`);
+        var sending = browser.runtime.sendNativeMessage("docspell", item.filename);
+        sending.then(showResult, onError);
+    }
+}
+
+function onStartedDownload(id) {
+    console.log(`Started downloading: ${id}`);
+    browser.downloads.onChanged.addListener(function(delta) {
+        if (delta.id == id) {
+            if (delta.state && delta.state.current === "complete") {
+                console.log(`Download ${delta.id} has completed.`);
+                var searching = browser.downloads.search({id});
+                searching.then(pushDocspell, onError);
+            }
+        }
+    });
+}
+
+function onFailed(error) {
+  console.log(`Download failed: ${error}`);
+}
+
+function downloadAsFile(url) {
+    console.log(`Downloading: ${url}`);
+    var downloading = browser.downloads.download({
+        url: url,
+        saveAs: false,
+        conflictAction : 'uniquify'
+    });
+    downloading.then(onStartedDownload, onFailed);
+}
+
+browser.contextMenus.create({
+  id: "separator-2",
+  type: "separator",
+  contexts: ["all"]
+}, onCreated);
+
+browser.contextMenus.create({
+  id: "docspell-push",
+  title: "Download and push to Docspell",
+  contexts: ["all"]
+}, onCreated);
+
+
+browser.contextMenus.onClicked.addListener(function(info, tab) {
+  switch (info.menuItemId) {
+  case "docspell-push":
+      if (info.linkUrl) {
+          downloadAsFile(info.linkUrl);
+      }
+      break;
+
+  }
+});
+
+console.log("Docspell Extension loaded");

tools/webextension/icons/logo-48.png

@@ -0,0 +1 @@
+../../../artwork/logo-48.png

tools/webextension/icons/logo-96.png

@@ -0,0 +1 @@
+../../../artwork/logo-96.png

tools/webextension/make-xpi.sh

@@ -0,0 +1,3 @@
+#!/usr/bin/env bash
+
+zip -9r docspell.xpi _locales/ docspell.js icons/ manifest.json

tools/webextension/manifest.json

@@ -0,0 +1,36 @@
+{
+
+    "manifest_version": 2,
+    "name": "__MSG_extensionName__",
+    "description": "__MSG_extensionDescription__",
+    "version": "1.0",
+
+    "permissions": [
+        "notifications",
+        "downloads",
+        "contextMenus",
+        "nativeMessaging"
+    ],
+
+
+    "browser_specific_settings": {
+        "gecko": {
+            "id": "docspell@eikek.github.io",
+            "strict_min_version": "50.0"
+        }
+    },
+
+    "description": "Downloads a file and pushes it to docspell.",
+
+    "icons": {
+        "48": "icons/logo-48.png",
+        "96": "icons/logo-96.png"
+    },
+
+    "background": {
+        "scripts": [
+            "docspell.js"
+        ]
+    },
+    "default_locale": "en"
+}

tools/webextension/native/app_manifest.json

@@ -0,0 +1,7 @@
+{
+  "name": "docspell",
+  "description": "Docspell Uploads",
+  "path": "/usr/local/share/docspell/native.py",
+  "type": "stdio",
+  "allowed_extensions": [ "docspell@eikek.github.io" ]
+}

tools/webextension/native/native.py

@@ -0,0 +1,51 @@
+#!/usr/bin/env python
+
+import json
+import sys
+import struct
+import os
+from os.path import expanduser
+import subprocess
+
+# The path to the ds.sh tool.
+try:
+    home = expanduser("~")
+    with open(home + '/.config/docspell/ds.cmd', 'r') as file:
+        DS_SH_CMD = file.read().replace('\n', '')
+except:
+    DS_SH_CMD="ds.sh"
+
+
+# Read a message from stdin and decode it.
+def get_message():
+    raw_length = sys.stdin.read(4)
+    if not raw_length:
+        sys.exit(0)
+    message_length = struct.unpack('=I', raw_length)[0]
+    message = sys.stdin.read(message_length)
+    return json.loads(message)
+
+
+# Encode a message for transmission, given its content.
+def encode_message(message_content):
+    encoded_content = json.dumps(message_content)
+    encoded_length = struct.pack('=I', len(encoded_content))
+    return {'length': encoded_length, 'content': encoded_content}
+
+
+# Send an encoded message to stdout.
+def send_message(encoded_message):
+    sys.stdout.write(encoded_message['length'])
+    sys.stdout.write(encoded_message['content'])
+    sys.stdout.flush()
+
+
+while True:
+    filename = get_message()
+    FNULL = open(os.devnull, 'w')
+    rc = subprocess.call(args=[DS_SH_CMD, filename], stdout=FNULL, stderr=FNULL, close_fds=True)
+    os.remove(filename)
+    if rc == 0:
+        send_message(encode_message(rc))
+    else:
+        send_message(encode_message(rc))