linkding/docs/how-to.md

How To

Collection of tips and tricks around using linkding.

Table of Contents:

• Using the bookmarklet on Android/Chrome
• Using HTTP Shortcuts app on Android
• Create a share action on iOS for adding bookmarks to linkding
• Increase the font size

Using the bookmarklet on Android/Chrome

This how-to explains the usage of the standard linkding bookmarklet on Android / Chrome.

Chrome on Android does not permit running bookmarklets in the same way you can on a desktop system. There is however a workaround that is explained here.

Note that this only works with Chrome and not with other browsers on Android.

Create a bookmark of your linkding deployment by clicking the star icon which you find in the three dots menu in the top right. Next you have to edit the bookmark. Edit the URL and replace it it with the bookmarklet code of your instance and give it an easy to type name like bm for bookmark or ld for linkding:

javascript:window.open(`http://<YOUR_INSTANCE_HERE>/bookmarks/new?url=${encodeURIComponent(window.location)}&auto_close`)

Now when you are browsing the web and you want to save the current page as a bookmark to your linkding instance simply type bm into the address bar and select it from the results. The bookmarklet code will trigger and you will be redirected so save the current page.

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 tag and bookmark it to linkding

• Install HTTP Shortcuts from Play Store or F-Droid.

• Copy the URL of linkding_shortcut.json.

• Open HTTP Shortcuts, tap the 3-dot-button at the top-right corner, tap Import/Export, then tap Import from URL.

• Paste the URL you copied earlier, tap OK, go back, tap the 3-dot-button again, then tap Variables.

• Edit the values of linkding_instance and linkding_api_key.

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.

To install the shortcut:

• Download the Shortcut on your iOS device
• Tap the downloaded file, which brings up the Shortcuts app
• Confirm that you want to add the shortcut
• In the shortcut, change https://linkding.mydomain.com to the URL of your linkding instance
• Confirm / close the shortcut

To use the shortcut:

• Open Safari and navigate to the page you want to bookmark
• Tap the share button
• Scroll down and tap "Add To Linkding"
• This opens linkding in a Safari overlay where you can configure the bookmark
• When you're done, tap "Save"
• After the bookmark is saved you can close the overlay

At the bottom of the share sheet there is a button for configuring share actions. You can use this to move the "Add To Linkding" action to the top of the share sheet if you like.

Note

You can also check the Community section for other pre-made shortcuts that you can use.

Increase the font size

The font size can be adjusted globally by adding the following CSS to the custom CSS field in the settings:

html {
  --font-size: 0.75rem;
  --font-size-sm: 0.7rem;
  --font-size-lg: 0.9rem;
}

.bookmark-list {
  line-height: 1.15rem;
}

.tag-cloud {
  line-height: 1.15rem;
}

You can adjust the --font-size, --font-size-sm and --font-size-lg variables to your liking. Note that increasing the font might also require you to adjust the line-height in certain places to better separate texts from each other. As an example, the above also increases the font size and line height of the bookmark list and tag cloud.