diff --git a/docs/how-to.md b/docs/how-to.md index 9b868c5b..8f4d97d8 100644 --- a/docs/how-to.md +++ b/docs/how-to.md @@ -20,6 +20,22 @@ Now when you are browsing the web and you want to save the current page as a boo For more info see here: https://paul.kinlan.me/use-bookmarklets-on-chrome-on-android/ +## Using HTTP Shortcuts app on Android + +**Note** This allows you to share URL from any app to bookmark it to linkding + +- Install HTTP Shortcuts from [Play Store](https://play.google.com/store/apps/details?id=ch.rmy.android.http_shortcuts) or [F-Droid](https://f-droid.org/en/packages/ch.rmy.android.http_shortcuts/). + +- Download [linkding_shortcut.json](../linkding_shortcut.json) from this repository. + +- Open HTTP Shortcuts, tap the 3-dot-button at the top-right corner, tap `Import/Export`, then tap `Import from file`. + +- Select the json file you downloaded earlier, go back, tap the 3-dot-button again, then tap `Variables`. + +- Edit the `values` of `linkding_instance`, `linkding_tag` and `linkding_api_token`. + +Try using share button on an app, a new item `Send to...` should appear on the share sheet. You can also manually share by tapping the shortcut inside the HTTP Shortcuts app itself. + ## Create a share action on iOS for adding bookmarks to linkding This how-to explains how to make use of the app shortcuts iOS app to create a share action that can be used in Safari for adding bookmarks to your linkding instance. diff --git a/linkding_shortcut.json b/linkding_shortcut.json new file mode 100644 index 00000000..a4838992 --- /dev/null +++ b/linkding_shortcut.json @@ -0,0 +1,59 @@ +{ + "categories": [ + { + "id": "8f4299d4-4c30-4a8e-a3f9-c90694011713", + "name": "Shortcuts", + "shortcuts": [ + { + "bodyContent": "{ \"url\": \"{{b2953f61-b302-4c79-b90d-39858a06d9a6}}\", \"tag_names\": [ \"{{c360f61f-ce17-47b4-bea3-1d8c3913ca52}}\" ] }", + "contentType": "application/json", + "description": "Bookmark to linkding", + "headers": [ + { + "id": "d235f7b4-fce2-41f4-a00f-72d5fde9e4b9", + "key": "Authorization", + "value": "Token {{6a739a16-d16d-4a06-93a5-3457da3c3d20}}" + } + ], + "iconName": "flat_grey_ribbon", + "id": "1e047d02-a4a3-4cad-b4cc-123cc16c8398", + "launcherShortcut": true, + "method": "POST", + "name": "Linkding", + "quickSettingsTileShortcut": true, + "responseHandling": { + "failureOutput": "simple", + "id": "61fa9fc3-8b7a-47ce-b43c-f24618a65e1e", + "uiType": "toast" + }, + "url": "{{ea2db14b-b9ca-45d8-8555-403271a38f5a}}/api/bookmarks/" + } + ] + } + ], + "variables": [ + { + "id": "ea2db14b-b9ca-45d8-8555-403271a38f5a", + "key": "linkding_instance", + "value": "https://your.instance.tld.without.slashed.end" + }, + { + "flags": 1, + "id": "b2953f61-b302-4c79-b90d-39858a06d9a6", + "key": "linkding_add_url", + "title": "Enter URL", + "type": "text" + }, + { + "id": "c360f61f-ce17-47b4-bea3-1d8c3913ca52", + "key": "linkding_tag", + "value": "single-tag" + }, + { + "id": "6a739a16-d16d-4a06-93a5-3457da3c3d20", + "key": "linkding_api_token", + "value": "your_token_from_integrations_tab" + } + ], + "version": 45 +} \ No newline at end of file