url actions

Created By: pnlng, 22 Stars, Last Updated: 02/02/21 03:43:26

Love this? Please consider supporting its creator by starring or sponsoring this project on GitHub!

From the project's README:

URL Actions

URL Actions is an Alfred workflow that fetches the URL and title of your browser’s current tab (compatible with Firefox, Safari, Chrome, and pretty much everything else), and
does things with them. For example, it can

  • Copy link in Markdown
  • Add a task to OmniFocus Pro
  • Clean up Amazon URLs

The actions are also customizable. It can

  • Open custom URLs
  • Copy custom strings to clipboard

An optional PopClip extension is also available, if one is inclined to trigger the workflow from the mouse.

Download

Screenshots

Alfred OmniFocus quick entry

macOS notification

Contents

Usage

Select the desired URL (⌘L to get the URL of the current tab in a browser). Fire up the workflow’s associated hotkey, which is ⇧^C by default.

Alternatively, if you use PopClip, you trigger Alfred through the PopClip extension.

  • Note: The extension triggers Alfred 4 by default. If you use other versions of Alfred, you would need to modify alfred.applescript and Bundle Identifier in Config.plist, and package the extension yourself.

Configuration

Variables

See here for a quick tutorial on how to configure variables in Alfred.

  • CLEAN_AMAZON – Default: true
    • The workflow removes tracking tokens from Amazon URLs if this variable is set to true.
    • To disable the feature, set the variable to false.
  • UPDATE_FREQUENCY – Default: 7
    • Set once how many days the workflow should check for updates
    • Updates done through OneUpdater
  • CUSTOM_ACTIONS_FILE – Default: null
    • The name of a JSON file in the workflow data directory supplying custom actions that override the default actions.
  • CUSTOM_ACTIONS – Default: null
    • A string in JSON format supplying custom actions that override the default actions.
    • If both CUSTOM_ACTIONS and CUSTOM_ACTIONS_FILE are defined, only the CUSTOM_ACTIONS_FILE will be used.

Custom Actions

You can supply custom actions that override the default actions in one of the following ways.

  1. Put a JSON file in the workflow data directory (accessible via the keyword urlact). Let the value of CUSTOM_ACTIONS_FILE be the name of the file.
  2. Let the value of CUSTOM_ACTIONS be a JSON string.

For a template, see default_actions.json.

_Please do not directly edit the default_actions.json file in the workflow directory, as user changes will be overridden when the workflow is updated._

Example:

[
  {
    "action_title": "Copy as Markdown link",
    "output": "[{title}]({url})"
  },
  {
    "action_title": "Add to OmniFocus",
    "action_subtitle": "",
    "output": "omnifocus:///add?name={title}&note={url}",
    "encode": true
  }
]

Variables:

  • {title}
  • {url}

Attributes:

  • action_title: Action title shown in Alfred.
  • action_subtitle: (Optional) Action subtitle shown in Alfred. If unspecified, the workflow will display the formatted output in this field.
  • output: Desired output of the action.
  • encode: (Optional) Default false. Whether to encode the title of the webpage. This is useful when the action is to open an URL scheme.

Note: Currently, if the output matches the regex `^.+:///.`, the workflow will open the URL. Conversely, if the output doesn’t match the regex, the workflow will copy the output to clipboard.*

Alternatives

Copying URLs

Fallroot’s Copy URL is a great workflow for formatting an URL in various ways. It can get the current tab title and URL from Safari and Chrome. Alas, it does not support Firefox.

Adding to OmniFocus

There is a workflow called Create OmniFocus Tasks by Aaron Hockley. It’s hosted here on Dropbox, archived here on GitHub, and is no longer actively maintained.

If you use only Safari or Chrome, and do not need to copy links in Markdown or clean Amazon URLs, this workflow might be the easiest way to add an URL and the associated page title to OmniFocus.

Browser Specific

For maximal scriptability in Firefox, checkout deanishe’s Firefox Assistant for Alfred.

There are a few browser specific tools that can send the frontmost web page and URL to OmniFocus.

Browser Support

  • Firefox
  • Chrome
  • Safari
  • Brave
  • Opera
  • Vivaldi
    … probably any browser, really.

Acknowledgements

This workflow is inspired by these articles and projects.

This workflow is especially indebted to: