Integrations

Prefill link

To send someone to the converter with a link already filled in, put the app link in ?url=, URL-encoded:

https://linkopen.app/?url=obsidian%3A%2F%2Fopen%3Fvault%3DNotes%26file%3DProjects%252FRoadmap

Add &mode=manual to turn off auto-redirect. Encode the whole app link: an unencoded & inside it would cut it short.

Apple Shortcuts

A shortcut for iPhone and iPad that takes an app link from the share sheet, or from the clipboard when nothing was shared, and copies the https link.

1. In the Shortcuts app, create a shortcut. Open its Details and turn on Show in Share Sheet. An input action appears at the top.
2. In the input action, tap Any and keep only text and URLs. Then tap Continue in the same action and choose Get Clipboard.
3. Add the action that URL-encodes text (search the actions for “encode”) and give it the shortcut’s input.
4. Add a URL action: https://linkopen.app/api/link?url= followed by the encoded text from step 3. For links that ask first, add &mode=manual at the end.
5. Add Get Contents of URL. It calls the URL from step 4 and gets the link back.
6. Add Copy to Clipboard.

Use it from the share sheet on a selected app link, or copy an app link and run the shortcut from the Shortcuts app.

Raycast

A Script Command for Raycast on a Mac. Save it as linkopen.sh in a folder of its own. In Raycast settings, open Extensions, click the plus button, choose Add Script Directory and pick that folder.

#!/bin/bash

# Required parameters:
# @raycast.schemaVersion 1
# @raycast.title Copy LinkOpen Link
# @raycast.mode silent

# Optional parameters:
# @raycast.packageName LinkOpen
# @raycast.argument1 { "type": "text", "placeholder": "App link" }

# Documentation:
# @raycast.description Turn an app link into an https link and copy it.

link=$(curl -sS -G https://linkopen.app/api/link --data-urlencode "url=$1")

case "$link" in
  https://*)
    printf '%s' "$link" | pbcopy
    echo "Copied $link"
    ;;
  *)
    echo "$link"
    exit 1
    ;;
esac

Run Copy LinkOpen Link, paste an app link, press Enter, and the https link is on your clipboard. If Raycast can’t run the script, make it executable with chmod +x linkopen.sh.

Shell

For macOS and Linux. Add this to ~/.zshrc or ~/.bashrc:

# Usage: linkopen 'obsidian://open?vault=Notes&file=Roadmap' [manual]
linkopen() {
  local link
  link=$(curl -sS -G https://linkopen.app/api/link \
    --data-urlencode "url=$1" \
    --data-urlencode "mode=${2:-auto}") || return 1
  case "$link" in
    https://*) ;;
    *) echo "linkopen: $link" >&2; return 1 ;;
  esac
  if [ -t 1 ]; then echo "$link"; else printf '%s' "$link"; fi
}

linkopen 'obsidian://open?vault=Notes&file=Roadmap'
linkopen 'slack://channel?team=T0001&id=C0001' manual
linkopen 'zoommtg://zoom.us/join?action=join&confno=123456789' | pbcopy

Keep the app link in single quotes so the shell leaves & and ? alone. When piped, the output has no trailing newline, so pbcopy on macOS, or xclip -selection clipboard or wl-copy on Linux, copies just the link.

Obsidian

The LinkOpen plugin for Obsidian adds three commands: copy a link to the current note, to the heading or block under the cursor, or a Markdown link to the note. It also adds a “Copy LinkOpen link” item to the file menu. Links are built on your device; the plugin makes no network calls.

Install it from Obsidian’s community plugins: open Settings › Community plugins, select Browse and search for LinkOpen. It also has a page in the community directory. The source is at github.com/inlife/obsidian-linkopen. For more on the links themselves, see Sharing Obsidian links.