Clean Links


Warning: Trying to access array offset on value of type null in /home/public/kirby/vendors/parsedownextra.php on line 241

Warning: Trying to access array offset on value of type null in /home/public/kirby/vendors/parsedownextra.php on line 241

Overview:

Clean Links resolves URLs that have been shortened (i.e. bit.ly) or put behind a proxy (i.e. feedproxy.com). It will also remove clutter such as UTM tokens. When it's all done, you get the result back onto your clipboard. More advanced settings can be configured within the standard Settings application.

Usage:

  1. Copy url to clipboard in another app
  2. Load CleanLinks
  3. URL Cleaning results shown in status area.

    x-callback-url support:

CleanLinks also supports the x-callback-url URL scheme. This allows for automation through callbacks. Features include:

  • Full support for x-success & x-failure callbacks.
  • Either the cleaned URL (successful) or original URL (failures) will be returned to calling application.
  • You can customize the how the URL is passed back. See usage below.
    Note: When passing in a URL, it's required to be correctly URL encoded.

Usage

Url Scheme: clean-links
Host: x-callback-url
Action: clean
Parameters (All optional):
retParam: The return value used for success & failure callbacks. Will be added as a querystring parameter to the callback. Omitting this will use a parameter named url.
x-success: URL called after a successful cleaning.
x-failure: URL called after a failed cleaning. errorCode & errorMessage will be added to the callback.

Examples

Using Clean Links through x-callback-url is simple.

Simple Redirect URL

Clean Links can also be used with other common iOS Applications like (Note: must have application installed):

OmniFocus
Drafts
Notesy
Things
Tweetbot
Google Chrome

Special Thanks

Thanks to all of the beta testers: Aaron Mahnke, Brett Terpstra, David Sparks, Federico Viticci and Patrick Rhone. Icon Design by Aaron Mahnke at Wet Frog Studios

Help & Suggestions

We welcome all feedback. Please send any notes here. You can also find me on Twitter.

Copyrights

Very special thanks to the follow OSS projects for examples & libraries: