Skip to content

edward-shen/shlink

Repository files navigation

Shlink Extension (Unofficial)

This extension provides a shortcut button to generate a short url using Shlink.

Usage

Click the extension and a short link will be requested from your instance for the page you're currently on. This short link will be copied to your clipboard, so you can easily paste it.

Requirements

An existing Shlink installation that's ready to use. If you don't have one, take a look at their Getting Started page to learn how to run your own instance.

Installation

Once installed, you'll need to set it up with your API key and host URL information:

  1. Right click the Shlink button in the top right and select the option to manage the extension.
    • In Chrome, you would select "Options".
    • In Firefox, you would select "Manage Extension".
  2. (Firefox only) Then, select the Preferences tab.
  3. Here, you'll need to enter your API key and point to where your Shlink instance is located.

Once all these steps are complete, the extension should be ready to use. If you encounter any errors, check to see if your API key is correct and you're pointed to the right domain.

Privacy

This extension does not log any information by itself, and only communicates with the Shlink instance you provide in its preferences. All other information is kept local.

This extension keeps your API key in plaintext in your local browser storage.

Permissions used

Permission Reason
tabs Needed so that the extension read the current active tab.
notifications Needed so that the extension can inform users if generating the short link was successful or not.
clipboardWrite Needed so that the extension can copy the short link to your clipboard.
storage Needed so that the extension can save the location of a Shlinker instance and your API key.