Awesome YOURLS

A curated list of awesome things related to YOURLS

• Resources
  • Official Resources
  • Community
  • Tutorials
• Tools
  • Official Tools
  • 3rd party Integrations and Frameworks
  • Applications
• Plugins
  • 0-9 | A | B | C | D | E | F | G | H | I | J | K | L | M | N | O | P | Q | R | S | T | U | V | W | X | Y | Z
• Translations

Resources

Official Resources

• Official Guide
• GitHub Repo
• Release Notes
• YOURLS News

Community

• Twitter
• Official Forum

Tutorials

• YOURLS with Tweetie 2 on eugenegordin.com
• YOURLS with Tweetbot on 2fatdads.com

Tools

Official Tools

• YOURLS using Docker
• YOURLS using Helm for Kubernetes

3rd party Integrations and Frameworks

• WordPress
  • YOURLS Link Creator
  • YOURLS Widget - Fetch and display YOURLS links and a QR code in a widget.
  • There are numerous other WordPress plugins with YOURLS support.
• Drupal - YOURLS for Drupal. Requires the title-refetch and API Concurrency Fix plugins to be installed in YOURLS. See this Drupal issue for details.
• CakePHP - Plugin to integrate YOURLS
• Laravel - Plugin to integrate YOURLS
• status.net - Plugin for status.net to use YOURLS
• Perl - A Perl module to shorten URLs using YOURLS
• Ruby - A Ruby wrapper for the YOURLS API
• Python 3 - A Python client for YOURLS, built for Python 3
• Python 2 - Alternative Python 2 client for YOURLS
• VB .Net - A VB .Net 4.0 wrapper for the YOURLS API
• Javascript - JavaScript bindings for the YOURLS API to leverage JSONP support
• Gnome Desktop - Gnome Shell extension to shorten links in the clipboard

Applications

• Android

  • URLy
  • aYourls - A dedicated app for YOURLS supporting server-side deletion (needs API Delete)

• iOS

  • ShortFox2
  • Short Menu - YOURLS support requires a one-time in-app purchase of about $2 USD (See also: Setup instructions)

• Chrome

  • YOURLS

• Firefox

  • YOURLS shortener

• Mac

  • Short Menu - Available for $6 from the App Store or directly from the developer (See also: Setup instructions)

Themes

• ∞² - Infinity Squared, a beautiful public page theme for YOURLS
• Air 66 - A responsive admin theme for YOURLS
• Sleeky - A sleek and simple frontend & backend theme for YOURLS with light and dark modes

Plugins

0-9

• 302-Instead - Send a 302 (temporary) redirect instead of 301 (permanent), for sites where shortlinks may change
• 302-Instead - A fork of previous plugin, with some more options
• 404 If Not Found ⭐ - Give a 404 Not Found if the short URL is not found

A

• AAF Rapid Connect auth - AAF Rapid Connect authentication plugin for YOURLS
• Abuse Desk for YOURLS - A Google Safe Browsing implementation for YOURLS to avoid spam links
• Access Control Allow Origin - Prevents CORS issue with domain CNAMES and aliases for admin actions
• Additional Charsets - Define additional character sets for short URLs
• Admin Issue Diagnostic - A.I.D. - Collects YOURLS environmentals and formats a template to copy/paste into a YOURLS issue. Just fill in the blanks! Fantastic for newbies, great for experts!
• Admin NoReCAPTCHA - Protect logins with Google's No CAPTCHA reCAPTCHA (Google's ReCAPTCHA v2.0)
• Admin reCaptcha - Spam protection for private YOURLS admin interface with reCaptcha
• Advanced Reserved URLs - Extends the reserved word functionality, blocking short URLs containing reserved words, even if mixed case or written in leetspeak
• Allow Aliases - Allow YOURLS to work with alias hostnames for the server
• Allow Forward Slashes in Short URLs - Just as the name says.
• Always-302 - A newer alternative to 302-Instead, tested with YOURLS 1.7.x
• Amazon Affiliate - Adds your Amazon Affiliate Tag to all Amazon URLs before redirection.
• Amazon Affiliate With Notice - Adds your Amazon Affiliate Tag to all Amazon URLs before redirection with a notice of Amazon Affiliate link usage.
• Anonymise - Anonymise the log data that YOURLS captures.
• Antispam ⭐ - Merciless antispam plugin using the 3 major domain blacklists
• YOURLS APC Cache - Add support for APC to reduce MySQL queries
• API Action ⭐ - Example plugin for YOURLS 1.6+ to show how to implement custom API actions
• API Delete - Add a "delete" action to the API
• API Edit URL - Add an "update" action to the API to edit a URL, and a "geturl" action to get the long URL of a short URL
• Append Query String - Appends the query string to a long URL- as is
• Auth Manager - Assign users to roles like "Editor" and "Contributor" to limit the changes they are permitted to make (edit URLs, manage plugins...)
• Auth Manager Plus - Seperates user data & manages authorization with role-based access controls (RBAC)

B

• Blacklist Domains - A simple plugin to blacklist domains from shortening URLs
• Blacklist IPs - A simple plugin to blacklist IPs from shortening URLs
• Bulk Import and Shorten - Import links from a CSV file
• Bulk URL Shortening - Shortening of multiple URLs with one API request

C

• cAuth - Client side SSL certificate authentication for admin pages.
• Cache Stat Pages ⭐ - Serve stat pages (http://sho.rt/blah+) from cache
• CAS Plugin - Enable authentication through a CAS server
• Case Insensitive - Makes all keywords case insensitive (creates and calls all keywords lowercase)
• Case Insensitive - Make YOURLS case insensitive: if you create http://sho.rt/MyLink, then variations like mylink or MYLINK will redirect to the same URL.
• Change Error Messages - Changes the error message when a keyword or URL already exists and displays the long URL.
• YOURLS GWall Change Logo - Allows you to change the image of the YOURLS logo and its alt and title tags.
• Change Password ⭐ - Change your password from within YOURLS instead of editing the config file
• Change Password - Allow users to change their password via the administration interface.
• Check URL - Check if a long URL is reachable before creating a short URL
• API Concurrency Fix - A plugin to resolve concurrency issues with the API as described in Issue 765.
• Compliance - Anti-abuse plugin, designed to address link complaints from 3rd parties.
• Conditional Toolbar ⭐ - A plugin to conditionally enable the toolbar: http://sho.rt/blah for normal redirect, http://sho.rt/tb/blah for a toolbar
• Conditional Advertisements - A plugin to conditionally send links through various link monetizing services: http://your.site/short is normal, http://your.site/a/short redirects through AdFly
• Custom Header & Footer - A plugin administration page to add custom header and footer style and content
• Custom Javascript - Add custom javascript to admin pages
• Custom Protocol ⭐ - If the user is known, this plugin adds custom protocol (eg blah://) to authorized protocols, otherwise restricts to http|s

D

• Disable JSONP - Disables JSONP access for the YOURLS API.
• DNSBL - Uses various DNSBLs to check the submitter's IP and prevent shortening URLs if any malicious activity has been detected.
• Domain Limit - Limit the domains that users can create shortlinks to
• Domain Limiter - Fork of Nic Waller's plugin with the addition of an admin panel to edit the white list from the admin area
• Do TLS - Always use SSL/TLS for a destination url if available
• Don't Log Bots ⭐ - Ignore bot hits in your stats (both click count as seen in the main admin page and in detailed stats)
• Don't Log Crawlers - A fork of the Don't Log Bots, with more bots filtered out.
• Don't Log Health Checker - A fork of Don't Log Bots, with more bots filtered out.
• Don't Track Admin Clicks - Don't count clicks on short URL if user is logged in

E

• Edition Logger - Logs to a file every url insertion, deletion, or modification, to provide traceability of users' actions allowing an open edition policy.
• Email Notify - Sends you an email with identifying information whenever someone clicks the link they were sent.
• Enhanced Auth Cookies ⭐ - Enhances the cookie based authentication, making each auth cookie name unique and time based.
• Every Click Counts - Click count include multiple clicks for the same client (ie there will be no browser caching of the redirection)
• Expiry - Defines optional conditions under which links will expire, able to set time and click limited links globally or per individual links.

F

• Fallback URL - Redirect to a custom URL when the short URL does not exist
• Filter Code - Allow to select 3XX Status Code to return per keyword
• Fix long URLs - Fix long URLs that contain %20 and other similar encodings
• Force Lowercase ⭐ - Force lowercase so http://sho.rt/ABC → http://sho.rt/abc
• Fuzzy Keyword Suggestions - Handles typos and other "near-misses" for any shortened link (eg if you have sho.rt/dh1ik but someone types sho.rt/dhlik, the 404 page will show suggestions for similar short URLs)

G

• GA MP - Track YOURLS link clicks with Google Analytics Measurement protocol in Real Time
• Git Version - Add version information from the git repository into the footer of the admin page
• Geo API - Plugin to look up country code from another 3rd party API (geoiplookup.net)
• GeoShortURL - Plugin to add per-country support to existing short URLs (use it with 302-Instead)
• Google Analytics Link Tagging - Add GA tags (utm_source and others) to your shortened links
• Google Auth - Enables Google Authentication for YOURLS
• Google Analytics YOURLS Plugin - Add your Google Analytics tags to admin and stat pages
• Google Safe Browsing ⭐ - Check every new URL against Google's Safe Browsing Lookup service
• GTM for YOURLS - Google Tag Manager for every single click

H

• hexdec - Changes the sequential keywords from base36 to base16 (ie [0-9a-f])
• Hide Referrer - Hide referrer on all or some short links
• Hide Version String - Hide the version string in the footer
• HTTP:BL - Prevent spam using the black list from Project Honeypot.
• HTTP Proxy - Get remote content using an HTTP proxy, for instance when YOURLS is running behind a firewall (e.g. corporate intranet)
• HTTP status per link - Plugin to allow you to select 3XX Status Code to return per keyword.

I

• Identi.ca for YOURLS - Share YOURLS links via identi.ca
• YOURLS IDN ⭐ - Add IDN support to YOURLS
• Image Placeholder - Simple image placeholder service for YOURLS
• YOURLS Import Export - A plugin to import and export YOURLS URL
• Integrated QRCodes - Integrated QRCodes is an updated fork of Inline QRCode, but more compact, configurable, and just as efficient with more features.
• iOS URL - Adds support for URLs starting with itms-apps:// and itms-services://
• iTunes-Affiliate - Adds your iTunes Affiliate-Token to all iTunes URLs before redirection

J

• Jappix - Adds a JappixMini chat on your YOURLS admin pages
• JSON Response - Add .json (or a custom string/character) to the short URL to get info about it as a JSON response.

K

• Keep Query String - Adds the short URL's query string (if any) to the long URL
• Keywords, Charset & Length - Custom charset, custom link length and random short urls, all in one plugin, with an admin panel.
• Keyword not found - If keyword isn't found in the database, redirect to admin page and pre-populate the short URL field
• Keyword Prefix - Adds a defined prefix to your short URLs

L

• LDAP - Enables use of LDAP for user authentication.
• Link Anonymizer - Generate a link that will take you to an anonymizer service.
• Link List - List recent links added, in the admin interface or on a public page
• Limit keyword length - This plugin limits the number of characters allowed for the custom keyword.
• Limited Links -limit the number of redirections of a specific link.
• log-login - Logs login atempts to YOURLS. To be used with fail2ban.
• Login Timeout - Adds a timeout after a certain number of failed logins to mitigate brute force logins.
• Lookup keywords by long URL substring - Add a "lookup-url-substr" action to YOURLS API which searches keywords by long URL substring (implements url LIKE %substr% SQL operation).
• lowercase username - Makes the username lowercase when logging in.

M

• Mailto - Adds a "mailto:" sharing option, next to Twitter and Facebook
• Mailto Bookmarklet - Adds a bookmarklet to share links by mail
• Mass Remove Link ⭐ - Remove several links at once. Select by date, date range, IP or URL matching.
• Mass Update - Adds an API action to mass update links from old_domain to new_domain
• Memcached - Memcached plugin for YOURLS
• Meta Redirect - Redirect using HTML meta tag when you prepend the short URL with an underscore (eg http://sho.rt/_bleh)
• Multi User - Add support for multiple users
• Mobile Detect - Add ability to redirect by user device OS

N

• No Traking Admins - No loggin clicks for authenticated users (compatible with OIDC).

O

• OAuth Sign In - Enable OAuth sign in support (using GitLab as an example)
• OIDC - OpenID Connect authentication against a generic OpenID Connect server

P

• Password Protection - Password protect any Short URL you want so that users are prompted for a password before redirection
• Phishtank - Prevent spam links using Phishtank's API
• Phishtank 2.0 - Functional rewrite of the old Phishtank plugin with more features
• Piwik-YOURLS - Piwik and a few other features
• Popular Clicks - Display the top of the most clicked links during past days
• Popular Clicks Extended - Shows which short links get clicked the most during a specific time frame
• Popular Links - Adds an admin page that displays your shortener's most popular links
• Preview URL ⭐ - Add the character '~' to a short URL to display a preview screen before redirection
• Preview URL with QR Code - Add the character '~' to a short URL to display a preview screen & QR code before redirection
• Preview URL with QR Code And Thumbnail - Add the character '~' to a short URL to display a QR code and Thumbnail image before redirection
• Public "Prefix n' Shorten" ⭐ - Redirect http://sho.rt/http://someurl.com/ to a public interface instead of the admin area
• YOURLS Pseudonymize - This plugin "pseudonymizes" the IP addresses so that it is in line with the German privacy laws (the last 2 segments/bytes of a visitor's IP address are removed)
• PUNS - A Plugin Update Notification System: provides a report-generating page and an API with optional email notifications.

Q

• QRCode ⭐ - Add ".qr" to short URLs to display the shorturl's QR code
• QRCode - Creates and displays QR Codes within YOURLS
• QR Google Charts - Another QR Code plugin, using Google Charts API
• QRCode - Another QR Code plugin. Get the QR code by simply clicking on a button in the Admin area (or by adding ".qr" to the end of the keyword.)
• QueryString Forward - Forward the query string on short link to long URL (eg http://sho.rt/kk?a=1 to http://very.long.url/somepage/?a=1)
• Query String Keeper - Pass the query string from the shortlink to the long URL (eg http://sho.rt/kk?hey forwards to http://longurl/bleh/?hey)

R

• reCaptcha - YOURLS plugin implementing reCaptcha for unauthenticated users in your public interface
• Redirect Index - Redirect the user to another site if they go to the base directory of your YOURLS installation
• Regenerate URL - Regenerate a new keyword for a URL that has already been shortened.
• Remove The Share Function - Remove the Share button and box that toggles the sharing options on the Admin page
• Remove YouTube Play Indicator - Removes the triangle from the title of Youtube shortened URL
• Reset URLs ⭐ - Deletes all URLs. For your test install needs.
• Reverse Proxy - Fixes the user IPs to point to the actual user instead of your cloud provider’s infrastructure IPs (Cloudflare, Heroku...)
• rscrub - An "HTTP referrer scrubbing swiss army knife for YOURLS" (evolution of the Hide Referrer plugin)

S

• Semantic Scuttle - Allows the sharing of the URL to a Semantic Scuttle installation.
• Separate Users - Adds a username to each created URL, and filters the admin interface.
• Shaarli - Allows the sharing of the URL to a Shaarli installation
• Share G+ - Adds Google+ to the Quick Share Box.
• Share LinkedIn - Adds LinkedIn to the Quick Share Box.
• Share with Tumblr ⭐ - In the Quick Share box, add a one-click share to Tumblr link.
• Shibboleth - Enable authentication with Shibboleth
• ShortShort - Checks if a URL is already shortened (e.g. t.co, bit.ly, youtu.be) to avoid nested shortened links.
• Show Git Branch - Using YOURLS on a dev box under Git? Show the current branch in page footer.
• SimpleDB Clickqueue - Queue clicks to Amazon SimpleDB before processing. This allows using a regular MySQL store even in the face of a high frequency of writes, without concern of connection limit overflow. Clicks are inserted later into the database via an import job.
• Skimlinks - Push all links through Skimlinks to automatically embed affiliate codes
• SMTP Contact - Provides a public contact page using PHPMailer for outbound mail delivery
• Snapshot - Visual preview plugin with image caching powered by PhantomJS.
• YOURLS SQLite - SQLite driver for YOURLS. It is now considered outdated.
• YOURLS SQLite - A fork of the original SQLite driver for YOURLS, actively maintained.
• Static Titles - Provide two options to avoid the network traffic when retrieving URL titles.
• SSL for SSL - Generates SSL short links if the original link was SSL.
• Swap Short URL - A plugin to have http://sho.rt/blah while having YOURLS installed in http://sho.rt/yourls/

T

• Telegram Quickshare - Quickly share a shortened URL via Telegram Messenger.
• Title Refetch - Refetch page titles
• Timezones ⭐ - Tell YOURLS your time zone and how you'd like times and dates displayed
• Thumbnail URL image - Get the Thumbnail URL image (long URL) by adding .i to the end of the keyword
• Time-Period Clicks - A simple API plugin for reporting URL clicks in a specific time period (e.g. the last week, January 1 - February 1, etc).
• Time Limit Link - Set a time limit for links
• Track Custom Keyword - Add a new field to YOURLS designed to track if a keyword was randomly assigned or manually specified
• Typer, a yourls prank plugin - Add an underscore * to your shortlink and the user will be shown a page where they have to type the shortlink themselves.

U

• Upload and Shorten - Upload and share files with YOURLS
• U-SRV - Provides secure links to files while obfuscating filesystem paths, allowing easy, secure access to files between plugins or from 3rd party scripts. Manual uploading of files is supported.
• Update 30X - An API plugin to test single, domain based, or all available links and update the URL in YOURLS if redirection occures at the destination.
• URL Health Check - Checks submitted URLs for validity, reachability, and redirection. In the case of redirection, the final destination URL will be stored avoiding nested redirects.

W

• wallabag - Allows the sharing of the URL to a Wallabag installation (previously named Poche)
• Whatsapp quickshare - Allows you to share your short URL via whatsapp
• Word Based Short URLs ⭐ - Generate short URLs with adjectives and nouns, like http://sho.rt/FluffyArrogantUnicorn

X

Y

• YAPCache - YAPCache is an APC based cache designed to reduce the database load of YOURLS and increase performance
• YOURS-TN - Display thumbnails on YOURLS admin page and stats page, using thumbnail.ws
• YouTube Title Fix - Fetch YouTube page titles via Google API

Z

Translations

YOURLS supports localization: this means if a language file for YOURLS in available in your language, YOURLS will speak your language!

• Brazilian: here and here (pt_BR)
• Bulgarian (bg_BG)
• Czech (cs_CZ)
• Danish (da_DK)
• Dutch (nl_NL)
• Farsi (fa_FA)
• Finnish (fi_FI)
• French (fr_FR)
• German (de_DE)
• Hindi (hi-IN)
• Indonesian (id_ID)
• Italian (it_IT)
• Japanese (ja_JP)
• Korean (ko_KR)
• Norwegian (bokmål) (nb_NO)
• Polish (pl_PL)
• Portuguese (pt_PT)
• Russian (ru_RU)
• Simplified Chinese (zh_CN)
• Slovak (sk_SK)
• Spanish (es_ES)
• Telugu (te_IN)
• Turkish (tr_TR)
• Traditional Chinese (zh_TW)
• Viet Nam (vi_VN)

Contribute

Contributions welcome! Read the contribution guidelines first.

License