An Alfred Workflow

Short Description

Shorten URLs by using YOURLS + some extras

Last Updated

26 Jun 2016


Mountain Lion
Snow Leopard
Yes Yes No No No



Bundle ID




An Alfred 3 workflow to shorten URLs by using YOURLS + some extras


YOURLS (Your Own URL Shortener) is a self hosted URL shortener and must be installed:


  1. Use the keyword yourlsendpoint to set the API endpoint of your YOURLS server. E.g.

  2. Use the keyword yourlstoken to set your signature token. This token is used instead of your username and password. It can be found in the Tools section of your YOURLS admin website.

Shorten an URL

Use the keyword shorten and enter the URL to shorten. The shortened URL gets copied to the clipboard. You can also use a hotkey trigger (I've set it to ctl+option+cmd+y) which shortens the current text selection.

Shorten an URL and use a keyword

You can set a keyword by separating it with the * character from the URL.

Usage: <keyword>*<url>

Example: microsoft* will create a short URL like


The keyword yourlsstats displays the last 100 shortened URLs with their click counts.

There are some actions you can perform on the results:

  • return key: Copies the shortened URL to the clipboard
  • option/alt + return key: Opens the shortened URL in your default browser
  • cmd + return key: Deletes the shortened URL (see hint below)
  • space key + text: To filter the results. It searches in the shortened URL, original URL and the title for your entered text

Hint to get delete short URL working

The following API plugin must be installed on your YOURLS server: yourls-api-delete