GoodLinks

URL Scheme

GoodLinks registers the goodlinks:// URL scheme and supports for integration with other apps via the x-callback-url protocol. The format for a URL action looks like this: 

goodlinks://x-callback-url/[action]?[action parameters]&[x-callback parameters]

Supported x-callback parameters: x-success, x-error and x-cancel.

GoodLinks supports the following actions:

save

Save a link.

Parameters

  • urloptionalThe URL of the link. If not specified, GoodLinks will look for URL in the clipboard.
  • titleoptionalThe title for the link.
  • summaryoptionalThe summary for the link.
  • tagsoptionalList of tags, separated by spaces.
  • starredoptionalValid values are "1" and "true". If specified, the link will be added to Starred.
  • readoptionalValid values are "1" and "true". If specified, the link will be marked as read.
  • quickoptionalValid values are "1" and "true". If specified, GoodLinks will save the link without showing any UI, otherwise the link editor screen will be shown.

Examples

  • goodlinks://x-callback-url/save?url=https%3A%2F%2Fapple.com&starred=1&tags=apple%20ios

    Save the specified URL, tag it with tags "apple" and "ios", add it to Starred.

  • goodlinks://x-callback-url/save?quick=1

    Quick save the URL in the clipboard.

open

Open a link in the GoodLinks app.

Parameters

  • urlrequiredThe URL of the link.

pick

Return details of a link.

Parameters

  • url-paramoptionalThe URL will be passed to the x-success URL using this parameter name. Default value is "url".
  • title-paramoptionalThe title will be passed to the x-success URL using this parameter name. Default value is "title".
  • summary-paramoptionalThe summary will be passed to the x-success URL using this parameter name. Default value is "summary".

last

Open the last unread link in the GoodLinks app.

random

Open a random unread link in the GoodLinks app.

unread

Show Unread list in the GoodLinks app.

starred

Show Starred list in the GoodLinks app.

untagged

Show Untagged list in the GoodLinks app.

read

Show Read list in the GoodLinks app.

tag

Show links tagged with the specified tag in the GoodLinks app.

Parameters

  • namerequiredTag name.

Example

  • goodlinks://x-callback-url/tag?name=apple