Link Tweaker User Guide

Table of Contents


Link Tweaker is a modest little application that adjusts URLs (aka hyperlinks) to make them more useful and more usable. It converts over-tokenized URLs into more readable strings. It can also optionally remove various forms of SharePoint detritus. It can also optionally insert a user-defined redirection string in front of a URL.

LinkTweaker’s operation is based on the philosophy that URLs should point a Web browser to a specific address, but should also tell a human user where a resource is located, so that said user can navigate to that resource through other means as well. To this end, LinkTweaker converts as many escape sequences as practical back to their original characters (changing a “%2F” back to a simple slash, for example), as well as removing other cruft and detritus that may have attached itself to a link somewhere along its journey.

Getting Started

System Requirements

Link Tweaker is written in Java and can run on any reasonably modern operating system, including Mac OS X, Windows and Linux. Link Tweaker requires a Java Runtime Environment (JRE), also known as a Java Virtual Machine (JVM). The version of this JRE/JVM must be at least 6. Visit to download a recent version for most operating systems. Installation happens a bit differently under Mac OS X, but generally will occur fairly automatically when you try to launch a Java app for the first time.

Because Link Tweaker may be run on multiple platforms, it may look slightly different on different operating systems, and will obey slightly different conventions (using the CMD key on a Mac, vs. an ALT key on a PC, for example).


Link Tweaker Copyright 2012 - 2014 Herb Bowie

Link Tweaker is open source software. Source code is available at GitHub.

Licensed under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.


Download the latest version from Decompress the downloaded file. Drag the resulting file or folder into the location where you normally store your applications. Double-click on the jar file (or the application, if you’ve downloaded the Mac app) to launch.

Data Fields

Link Tweaker works with links (aka hyperlinks, aka URLs). It provides for an input link, and then a separate text box for the output link, after one or more possible transformations.

User Interface

The Tool Bar

A toolbar with multiple buttons appears at the top of the user interface.

LinkTweaker has a single main window containing the following controls.

Input Link
Enter the link to be tweaked. Usually you would copy this information from a field in another app, and then paste it into this field.
Output Link
This is the resulting link, after the tweaking has occurred. It may or may not be different than the input, and it may or may not still perform the same function. Always test the link before relying on it.
Remove SharePoint Cruft?
When copying a link from Internet Explorer while navigating a SharePoint site, the copied link often seems to contain a great deal of additional, optional and apparently quite useless information. Checking this box will cause LinkTweaker to try to remove this stuff, resulting in a shorter and more straightforward hyperlink.
Insert Redirect?
In some cases, especially while inside a corporate firewall, it may be necessary to insert some sort of redirecting URL in order to successfully navigate to your ultimate destination. You will need to enter your redirect URL in the Preferences pane. Once doing so, checking this box will cause the redirect to be inserted before the Input Link.
Show spaces as spaces?
In order to avoid corruption, especially when being relayed via email, spaces in hyperlinks are often converted to “%20” strings. Checking this box will convert these strings back to spaces, which will generally make the link more readable (but less durable). This may be useful as a temporary setting, just to see the elements of your URL as they would normally appear in a file or web browser.
Pressing this button will cause the tweaking logic to be applied to the Input Link, producing a new Output Link. However, since this operation is also triggered by most of your other actions in the user interface, it may not be strictly necessary to press this button.
Pressing this button will cause the Output Link to be launched, using your favorite Web browser. This should be done to test the Output Link, to ensure it actually takes the user to your desired location.
Pressing this button will cause the Output Link to be copied to the system clipboard, so that your next paste will place the Output Link into a new location.

Link Tweaker logo