From 53c76456c099036f11fa8c581b30d6a470625a47 Mon Sep 17 00:00:00 2001
From: Sebastian <sebasjm@gmail.com>
Date: Tue, 26 Apr 2022 09:25:24 -0300
Subject: [PATCH] custom protocol

---
 contrib/custom-protocol/README                | 33 +++++++++++++++++++
 .../custom-protocol/taler-wallet-cli.desktop  | 12 +++++++
 2 files changed, 45 insertions(+)
 create mode 100644 contrib/custom-protocol/README
 create mode 100755 contrib/custom-protocol/taler-wallet-cli.desktop

diff --git a/contrib/custom-protocol/README b/contrib/custom-protocol/README
new file mode 100644
index 000000000..0ebbeed4d
--- /dev/null
+++ b/contrib/custom-protocol/README
@@ -0,0 +1,33 @@
+Custom protocol handler for taler:// URI
+
+In order to run the wallet when trying to open an html anchor to a ref starting with "taler://" you have to setup a custom protocol handler in your local setup.
+
+
+
+First add this content into file `.config/mimeapps.list` under section `[Default Applications]`
+
+```
+x-scheme-handler/taler=taler-wallet-cli.desktop
+x-scheme-handler/taler+http=taler-wallet-cli.desktop
+```
+
+then create a file named `taler-wallet-cli.desktop` in location `$HOME/.local/share/applications` with content
+
+```
+[Desktop Entry]
+Name=GNU Taler Wallet CLI URL Handler
+GenericName=Wallet
+Comment=Handle URL Scheme taler://
+Exec=bash -c "taler-wallet-cli handle-uri %u; read"
+Terminal=true
+Type=Application
+MimeType=x-scheme-handler/taler;x-scheme-handler/taler+http
+Name[en_US]=GNU Taler Wallet URL Handler
+```
+
+Done, you can test it using the next command:
+
+```
+$ xdg-open taler://withdraw/bank.demo.taler.net/api/793ee3e4-2915-47e8-9abe-bcc36c8e65cf
+```
+
diff --git a/contrib/custom-protocol/taler-wallet-cli.desktop b/contrib/custom-protocol/taler-wallet-cli.desktop
new file mode 100755
index 000000000..35c8e5154
--- /dev/null
+++ b/contrib/custom-protocol/taler-wallet-cli.desktop
@@ -0,0 +1,12 @@
+[Desktop Entry]
+Name=GNU Taler Wallet CLI URL Handler
+GenericName=Wallet
+Comment=Handle URL Scheme taler://
+Exec=bash -c "taler-wallet-cli handle-uri %u; read"
+Terminal=true
+Type=Application
+MimeType=x-scheme-handler/taler;x-scheme-handler/taler+http
+Icon=sublime-text-2
+Categories=TextEditor;Development;Utility;
+Name[en_US]=GNU Taler Wallet URL Handler
+