awesome_yourls/README.md

582 lines
46 KiB
Markdown
Raw Permalink Normal View History

<p align="center">
<a href="https://yourls.org">
<img height="120" src="https://github.com/YOURLS/YOURLS/raw/master/images/yourls-logo.svg" alt="YOURLS Logo">
</a>
</p>
2017-11-29 04:47:52 +00:00
# Awesome YOURLS
[![Awesome](https://awesome.re/badge.svg)](https://awesome.re)
2023-03-14 18:29:32 +00:00
[![Listed in Awesome YOURLS!](https://img.shields.io/badge/Awesome-YOURLS-C5A3BE)](https://github.com/YOURLS/awesome)
> A curated list of **awesome things** related to **[YOURLS](https://yourls.org)**
2017-11-29 04:47:52 +00:00
## Contents
2017-11-29 04:47:52 +00:00
- [Official Links](#official-links) - Official guides and tools
- [Plugins](#plugins) - what makes YOURLS so versatile and powerful.
2023-11-07 20:37:32 +00:00
Currently: **<!--plugin_count-->208<!--/plugin_count-->** plugins listed.<!-- DO NOT UPDATE THIS COUNT MANUALLY -->
- [Themes](#themes) - to customize how YOURLS looks
- [Translations](#translations) - YOURLS in your language
- [Integrations](#integrations) - Third-party integrations and frameworks
- [Guides & tutorials](#guides--tutorials) - Community resources
- [Showcases](#showcases) - Inspiration and celebrity endorsements
2018-08-30 13:37:09 +00:00
_Something missing or incorrect? Want to get your work listed? See how you can [contribute](CONTRIBUTING.md)!_
2018-08-30 13:37:09 +00:00
## Official Links
[🔼 Go to top](#readme)
2023-03-14 18:29:32 +00:00
#### Official material from the YOURLS team
- [Official Readme](https://yourls.org)
- [Source Code](https://github.com/YOURLS/YOURLS)
2023-03-14 18:29:32 +00:00
- [Documentation](https://yourls.org/docs)
2018-08-30 13:37:09 +00:00
- [Release Notes](https://github.com/YOURLS/YOURLS/releases)
2023-03-14 18:29:32 +00:00
- [YOURLS News](https://yourls.org/blog)
- [Community Discussions](https://github.com/orgs/YOURLS/discussions)
2022-04-21 22:23:11 +00:00
2023-03-14 18:29:32 +00:00
#### Official tools from the YOURLS team
2022-04-21 22:23:11 +00:00
2018-08-30 13:37:09 +00:00
- [YOURLS using Docker](https://hub.docker.com/_/yourls/)
- [YOURLS using Helm for Kubernetes](https://artifacthub.io/packages/helm/yourls/yourls)
2022-04-23 10:14:45 +00:00
- [Sample YOURLS plugin](https://github.com/YOURLS/plugin-sample)
2022-04-21 22:23:11 +00:00
- [YOURLS plugins using Composer](https://github.com/YOURLS/composer-installer)
- [YOURLS test suite for plugins](https://github.com/YOURLS/YOURLS-test-suite-for-plugins)
2018-08-30 13:37:09 +00:00
## Plugins
[🔼 Go to top](#readme)
2018-08-30 13:37:09 +00:00
All known plugins, from the community or the YOURLS team
_Legend:_
- ☑️ : plugin authored by a member of the YOURLS teams
2023-03-02 04:42:06 +00:00
- :test_tube: : plugins featuring their own unit tests to ensure expected functionality, as well as present and future compatibility, with YOURLS
2018-08-30 13:37:09 +00:00
2023-11-07 20:37:32 +00:00
Currently we have **<!--plugin_count-->208<!--/plugin_count-->** plugins listed.
<!-- DO NOT UPDATE THIS COUNT MANUALLY -->
Willing to get your plugins featured here? Please [contribute](CONTRIBUTING.md)!
2022-02-09 16:40:59 +00:00
Jump to [0-9](#0-9) | [A](#a) | [B](#b) | [C](#c) | [D](#d) | [E](#e) | [F](#f) | [G](#g) | [H](#h) | [I](#i) | [J](#j) | [K](#k) | [L](#l) | [M](#m) | [N](#n) | [O](#o) | [P](#p) | [Q](#q) | [R](#r) | [S](#s) | [T](#t) | [U](#u) | [V](#v) | [W](#w) | [X](#x) | [Y](#y) | [Z](#z)
2018-08-30 13:37:09 +00:00
### 0-9
- [2fa Support](https://github.com/MatthewC/yourls-2fa-support) - Adds 2FA support to YOURLS.
2021-02-27 15:32:18 +00:00
- [302-Instead](https://github.com/EpicPilgrim/302-instead) - Send a 302 (temporary) redirect instead of 301 (permanent), for sites where shortlinks may change.
- [302-Instead](https://github.com/timcrockford/302-instead) - A fork of previous plugin, with some more options.
- [404 If Not Found](https://github.com/YOURLS/404-if-not-found) ☑️ - Give a 404 Not Found if the short URL is not found.
2017-11-29 04:47:52 +00:00
[⬆️ Go to section](#plugins)
2017-11-29 04:47:52 +00:00
### A
2021-02-27 15:32:18 +00:00
- [AAF Rapid Connect auth](https://github.com/clmcavaney/aaf-rapidconnect-auth-yourls) - AAF Rapid Connect authentication plugin for YOURLS.
- [Abuse Desk for YOURLS](https://yourls.org/blog/2011/04/yourls-abuse-anti-spam-plugins/) - A Google Safe Browsing implementation for YOURLS to avoid spam links.
2021-02-27 15:32:18 +00:00
- [Access Control Allow Origin](https://github.com/TEODE/yourls-access-control-allow-origin) - Prevents CORS issue with domain CNAMES and aliases for admin actions.
- [Additional Charsets](https://github.com/josheby/yourls-additional-charsets) - Define additional character sets for short URLs.
- [Admin Issue Diagnostic - A.I.D.](https://github.com/PopVeKind/admin_issue_diagnostic) - Collects YOURLS environmentals and formats a template to copy/paste into a YOURLS issue.
- [Admin NoReCAPTCHA](https://github.com/amindeed/YOURLS-Admin-NoReCAPTCHA) - Protect logins with Google's No CAPTCHA reCAPTCHA (Google's ReCAPTCHA v2.0).
- [Admin reCaptcha](https://github.com/armujahid/Admin-reCaptcha) - Spam protection for private YOURLS admin interface with reCaptcha.
- [Advanced Reserved URLs](https://github.com/josheby/yourls-advanced-reserved-urls) - Extends the reserved word functionality, blocking short URLs containing reserved words, even if mixed case or written in leetspeak.
- [Allow Aliases](https://github.com/adigitalife/yourls-allow-aliases) - Allow YOURLS to work with alias hostnames for the server.
2017-11-29 04:47:52 +00:00
- [Allow Forward Slashes in Short URLs](https://github.com/williambargent/YOURLS-Forward-Slash-In-Urls) - Just as the name says.
2022-04-19 07:32:30 +00:00
- [Allow Full Stops in Short URLs](https://github.com/SophiaAtkinson/YOURLS-full-stop-in-short-urls) - This plugin will allow full stops `.` in keywords when shortening URLS.
2021-02-27 15:32:18 +00:00
- [Always-302](https://github.com/tinjaw/Always-302) - A newer alternative to 302-Instead.
2017-11-29 04:47:52 +00:00
- [Amazon Affiliate](https://github.com/floschliep/YOURLS-Amazon-Affiliate) - Adds your Amazon Affiliate Tag to all Amazon URLs before redirection.
2018-09-18 02:12:30 +00:00
- [Amazon Affiliate With Notice](https://github.com/Trsmoothie/YOURLS-Amazon-Affiliate-With-Redirect-Notice) - Adds your Amazon Affiliate Tag to all Amazon URLs before redirection with a notice of Amazon Affiliate link usage.
2020-01-15 18:00:33 +00:00
- [Anonymise](https://github.com/wlabarron/yourls-anonymise) - Anonymise the log data that YOURLS captures.
2022-04-25 18:16:42 +00:00
- [Antispam](https://github.com/YOURLS/antispam) ☑️ - Antispam plugin using the major DNS blacklists.
- [YOURLS APC Cache](https://yourls.org/blog/2011/06/yourls-apc-cache-plugin/) - Add support for APC to reduce MySQL queries.
- [API Action](https://github.com/YOURLS/API-action) ☑️ - Example plugin for YOURLS 1.6+ to show how to implement custom API actions.
2022-04-22 08:15:57 +00:00
- [API Contract](https://github.com/brookestevens/yourls-api-contract) - API action opposite to "expand": check if a URL has been shortened before
2021-02-27 15:32:18 +00:00
- [API Delete](https://github.com/claytondaley/yourls-api-delete) - Add a "delete" action to the API.
- [API Edit URL](https://github.com/timcrockford/yourls-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.
- [API List All](https://github.com/rosano/yourls-api-action-list) - Add a "list" action to the API to show all keywords.
- [API List All + URLs](https://github.com/Le0X8/yourls-api-action-list) - Add a "list" action to the API to show all keywords & URLs. This is a fork of the previous plugin and therefore incompatible with it.
2021-02-27 15:32:18 +00:00
- [Append Query String](https://github.com/drockney/append-qs) - Appends the query string to a long URL.
- [Auth Manager Plus](https://github.com/joshp23/YOURLS-AuthMgrPlus) - Seperates user data & manages authorization with role-based access controls (RBAC).
- [Auto Login](https://gist.github.com/ozh/3fa3382eb83d26449daab4b70cd3b299) ☑️ - Automatically populate login/password with test/test (for test installs).
[⬆️ Go to section](#plugins)
2017-11-29 04:47:52 +00:00
### B
- [BaseURL Rewrite](https://github.com/christian-krieg/yourls-plugin-base-url-rewrite) - Rewrite short URLs such that they point to alternative (base) URLs.
2021-02-27 15:32:18 +00:00
- [Blacklist Domains](https://github.com/apelly/YourlsBlacklistDomains) - A simple plugin to blacklist domains from shortening URLs.
- [Blacklist IPs](https://github.com/LudoBoggio/YourlsBlacklistIPs) - A simple plugin to blacklist IPs from shortening URLs.
- [BlackList User-Agent](https://github.com/8Mi-Tech/yourls-ban-useragent):test_tube: - A simple plugin to blacklist User-Agent from shortening URLs.
- [Block details while not login](https://github.com/taozhiyu/block-details-while-not-login) - Blocks access to the details page when not logged in.
2021-02-27 15:32:18 +00:00
- [Bulk Import and Shorten](https://github.com/vaughany/yourls-bulk-import-and-shorten) - Import links from a CSV file.
- [Bulk URL Shortening](https://github.com/tdakanalis/bulk_api_bulkshortener) - Shortening of multiple URLs with one API request.
2017-11-29 04:47:52 +00:00
[⬆️ Go to section](#plugins)
2017-11-29 04:47:52 +00:00
### C
- [cAuth](https://github.com/joshp23/YOURLS-cAuth) - Client side SSL certificate authentication for admin pages.
- [Cache Stat Pages](https://github.com/YOURLS/cache-stats-pages) ☑️ - Serve stat pages (`http://sho.rt/blah+`) from cache.
2021-02-27 15:32:18 +00:00
- [CAS Plugin](https://github.com/nicwaller/yourls-cas-plugin) - Enable authentication through a CAS server.
- [Case Insensitive](https://github.com/seandrickson/YOURLS-Case-Insensitive/) - Makes all keywords case insensitive (creates and calls all keywords lowercase).
2017-11-29 04:47:52 +00:00
- [Case Insensitive](https://github.com/adigitalife/yourls-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.
2022-05-05 16:25:33 +00:00
- [Case Insensitive YOURLS](https://github.com/IMExperts/yourls-case-insensitive) - Makes YOURLS case insensitive, for 1.9+.
2017-11-29 04:47:52 +00:00
- [Change Error Messages](https://github.com/adigitalife/yourls-change-error-messages) - Changes the error message when a keyword or URL already exists and displays the long URL.
2019-09-25 13:59:00 +00:00
- [YOURLS GWall Change Logo](https://github.com/gioxx/YOURLS-GWallChangeLogo) - Allows you to change the image of the YOURLS logo and its alt and title tags.
- [YOURLS GWall Change Title](https://github.com/gioxx/YOURLS-GWallChangeTitle) - Allows you to change the title of the YOURLS website (the html `<title>` tag).
- [Change Password](https://github.com/ozh/yourls-change-password) ☑️ - Change your password from within YOURLS instead of editing the config file.
2017-11-29 04:47:52 +00:00
- [Change Password](https://github.com/vvanasten/YOURLS-Change-Password) - Allow users to change their password via the administration interface.
2021-02-27 15:32:18 +00:00
- [Check URL](https://github.com/adigitalife/yourls-check-url) - Check if a long URL is reachable before creating a short URL.
2017-11-29 04:47:52 +00:00
- [Compliance](https://github.com/joshp23/YOURLS-Compliance) - Anti-abuse plugin, designed to address link complaints from 3rd parties.
- [Conditional Toolbar](https://github.com/YOURLS/conditional-toolbar) ☑️ - A plugin to conditionally enable the toolbar: `http://sho.rt/blah` for normal redirect, `http://sho.rt/tb/blah` for a toolbar.
2021-02-27 15:32:18 +00:00
- [Conditional Advertisements](https://github.com/HeroCC/yourls-conditional-urlads) - 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](https://github.com/mediageni/yourls-custom-header-footer) - A plugin administration page to add custom header and footer style and content.
- [Custom Javascript](https://github.com/mediageni/yourls-custom-javascript) - Add custom javascript to admin pages.
- [Custom Number of Displayed Links](https://github.com/YOURLS/YOURLS/issues/2339#issuecomment-352127623) ☑️ - Change the default number of links per page, if 15 isn't your taste.
- [Custom Protocol](https://github.com/YOURLS/custom-protocol) ☑️ - If the user is known, this plugin adds custom protocol (eg `blah://`) to authorized protocols, otherwise restricts to `http|s`.
2017-11-29 04:47:52 +00:00
[⬆️ Go to section](#plugins)
2017-11-29 04:47:52 +00:00
### D
2017-11-29 04:47:52 +00:00
- [Disable JSONP](https://github.com/seandrickson/YOURLS-Disable-JSONP) - Disables JSONP access for the YOURLS API.
- [DNSBL](https://github.com/Diftraku/yourls_dnsbl/) - Uses various DNSBLs to check the submitter's IP and prevent shortening URLs if any malicious activity has been detected.
2021-02-27 15:32:18 +00:00
- [Domain Limit](https://github.com/nicwaller/yourls-domainlimit-plugin) - Limit the domains that users can create shortlinks to.
- [Domain Limiter](https://bitbucket.org/quantumwebco/domain-limiter-yourls-plugin) - Fork of Nic Waller's plugin with the addition of an admin panel to edit the white list from the admin area.
- [Do TLS](https://github.com/joshp23/YOURLS-doTLS) - Always use SSL/TLS for a destination url if available.
- [Don't Log Bots](https://github.com/YOURLS/dont-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](https://github.com/luixxiul/dont-log-crawlers/) - A fork of the `Don't Log Bots`, with more bots filtered out.
- [Don't Log Health Checker](https://github.com/guessi/yourls-dont-log-health-checker) - A fork of `Don't Log Bots`, with more bots filtered out.
2022-04-23 10:14:45 +00:00
- [Don't Track Admin Clicks](https://github.com/dgw/yourls-dont-track-admins) ☑️🧪 - Don't count clicks on short URL if user is logged in.
- [Download Plugin](https://github.com/krissss/yourls-download-plugin) - Download and install YOURLS plugins from the admin panel.
2017-11-29 04:47:52 +00:00
[⬆️ Go to section](#plugins)
2017-11-29 04:47:52 +00:00
### E
2017-11-29 04:47:52 +00:00
- [Edition Logger](https://github.com/esuarezsantana/yourls-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](https://github.com/s22-tech/Yourls-Email-Notify) - Sends you an email with identifying information whenever someone clicks the link they were sent.
2021-04-06 12:28:12 +00:00
- [Emojis](https://github.com/telepathics/yourls-emojis) - Create an emoji-only short link, like `http://sho.rt/✨` or `http://sho.rt/😎🆒🔗`
- [Enhanced Auth Cookies](https://github.com/ozh/yourls-enhanced-cookies) ☑️ - Enhances the cookie based authentication, making each auth cookie name unique and time based.
2021-02-27 15:32:18 +00:00
- [Every Click Counts](https://github.com/BstName/every-click-counts) - Click count include multiple clicks for the same client (ie there will be no browser caching of the redirection).
- [Expiry](https://github.com/joshp23/YOURLS-Expiry) - Defines optional conditions under which links will expire, able to set time and click limited links globally or per individual links.
2017-11-29 04:47:52 +00:00
[⬆️ Go to section](#plugins)
2017-11-29 04:47:52 +00:00
### F
2021-04-08 12:32:55 +00:00
- [Fallback URL](https://github.com/ozh/yourls-fallback-url/) - Redirect to a custom URL when the short URL does not exist.
- [Fancy Animals Short Urls](https://github.com/cfultz/Fancy-Animal-Short-Urls) - Plugin to create cool short URLS like `https://sho.rt/SwiftCrimsonBullfrog`
- [Fancy Pokemon Short Urls](https://github.com/fortepc/Fancy-Pokemon-Short-Urls) - Plugin to create cool short URLS like `https://sho.rt/QuirkyHisuianNuzleaf`
- [Favicon](https://github.com/YOURLS/yourls-favicon/) ☑️ - Properly displayed favicon in all cases (home screen on iOS, Android, Chrome, Safari...).
2021-02-27 15:32:18 +00:00
- [Filter Code](https://github.com/ShredCode/YOURLS-filter-code) - Allow to select 3XX Status Code to return per keyword.
- [Fix long URLs](https://github.com/adigitalife/yourls-fix-long-url) - Fix long URLs that contain %20 and other similar encodings.
2022-04-24 11:13:48 +00:00
- [Fix Youtube titles](https://github.com/ozh/fix-youtube-titles) ☑️ - Get correct video title, not "`Before you continue to YouTube`"
- [Force Lowercase](https://github.com/YOURLS/force-lowercase) ☑️ - Force lowercase so `http://sho.rt/ABC``http://sho.rt/abc`.
2021-02-27 15:32:18 +00:00
- [Fuzzy Keyword Suggestions](https://github.com/philhagen/ltc-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).
2017-11-29 04:47:52 +00:00
[⬆️ Go to section](#plugins)
2017-11-29 04:47:52 +00:00
### G
- [GA MP](https://github.com/powerthazan/YOURLS-GA-MP-Tracking) - Track YOURLS link clicks with Google Analytics Measurement protocol in Real Time.
2021-02-27 15:32:18 +00:00
- [Git Version](https://github.com/chtaube/YOURLS-plugin-gitversion) - Add version information from the git repository into the footer of the admin page.
2021-05-16 19:13:09 +00:00
- [Geo API](https://github.com/ssecurelabs/yourls-Geo-API-plugin) - Plugin to look up country code from another 3rd party API (geoiplookup.net).
2022-03-20 15:12:03 +00:00
- [GeoIP Update](https://github.com/ozh/yourls-geoip-update) ☑️ - Update the GeoIP database
2021-02-27 15:32:18 +00:00
- [GeoShortURL](https://github.com/tobozo/YOURLS-GeoShortURL) - Plugin to add per-country support to existing short URLs (use it with [302-Instead](https://github.com/timcrockford/302-instead)).
- [Google Analytics Link Tagging](https://katz.co/2300/) - Add GA tags (utm_source and others) to your shortened links.
- [Google Auth](https://github.com/8thwall/google-auth-yourls) - Enables Google Authentication for YOURLS.
- [Google Safe Browsing](https://github.com/YOURLS/google-safe-browsing) ☑️:test_tube: - Check every new URL against Google's Safe Browsing Lookup service.
2021-02-27 15:32:18 +00:00
- [GTM for YOURLS](https://github.com/dorks-delivered/GTM-for-YOURLS) - Google Tag Manager for every single click.
2017-11-29 04:47:52 +00:00
[⬆️ Go to section](#plugins)
2017-11-29 04:47:52 +00:00
### H
2021-02-27 15:32:18 +00:00
- [hexdec](https://github.com/plttn/yourls-hexdec) - Changes the sequential keywords from base36 to base16 (ie `[0-9a-f]`).
- [Hide Referrer](https://github.com/Sire/yourls-hide-referrer) - Hide referrer on all or some short links.
- [Hide Version String](https://github.com/YOURLS/YOURLS/issues/1878#issuecomment-88450475) - Hide the version string in the footer.
2018-04-27 06:37:49 +00:00
- [HTTP:BL](https://github.com/joshp23/YOURLS-httpBL) - Prevent spam using the black list from Project Honeypot.
2021-02-27 15:32:18 +00:00
- [HTTP Proxy](https://github.com/adigitalife/yourls-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](https://github.com/district09/yourls_plugin_http-status-per-link) - Select `3XX` Status Code to return per keyword.
2017-11-29 04:47:52 +00:00
[⬆️ Go to section](#plugins)
2017-11-29 04:47:52 +00:00
### I
- [Identi.ca for YOURLS](https://yourls.org/blog/2011/04/yourls-identi-ca-and-tumblr-plugins/) - Share YOURLS links via identi.ca.
- [YOURLS IDN](https://github.com/YOURLS/YOURLS-IDN) ☑️ - Add IDN support to YOURLS.
- [Image Placeholder](https://github.com/LeoColomb/yourls-image-placeholder) ☑️ - Simple image placeholder service for YOURLS.
2021-02-27 15:32:18 +00:00
- [YOURLS Import Export](https://github.com/GautamGupta/YOURLS-Import-Export) - A plugin to import and export YOURLS URL.
2017-11-29 04:47:52 +00:00
- [Integrated QRCodes](https://github.com/joshp23/YOURLS-IQRCodes) - Integrated QRCodes is an updated fork of Inline QRCode, but more compact, configurable, and just as efficient with more features.
- [Insert Fake Links](https://gist.github.com/ozh/6455d192ac443c2a12379cc94f607b43) ☑️ - Insert fake links (for test installs)
2021-02-27 15:32:18 +00:00
- [iOS URL](https://github.com/suculent/yourls-ios-url-schemes-plugin) - Adds support for URLs starting with `itms-apps://` and `itms-services://`.
- [iTunes-Affiliate](https://github.com/floschliep/YOURLS-iTunes-Affiliate) - Adds your iTunes Affiliate-Token to all iTunes URLs before redirection.
2017-11-29 04:47:52 +00:00
[⬆️ Go to section](#plugins)
2017-11-29 04:47:52 +00:00
### J
2021-02-27 15:32:18 +00:00
- [Jappix](https://github.com/jonrandoem/yourls-jappix) - Adds a JappixMini chat on your YOURLS admin pages.
2018-04-27 06:37:49 +00:00
- [JSON Response](https://github.com/tessus/yourls-json-response) - Add `.json` (or a custom string/character) to the short URL to get info about it as a JSON response.
2017-11-29 04:47:52 +00:00
[⬆️ Go to section](#plugins)
2017-11-29 04:47:52 +00:00
### K
2021-02-27 15:32:18 +00:00
- [Keep Query String](https://github.com/rinogo/yourls-keep-query-string) - Adds the short URL's query string (if any) to the long URL.
2017-11-29 04:47:52 +00:00
- [Keywords, Charset & Length](https://github.com/peterberbec/yourls-keyword_charset_length) - Custom charset, custom link length and random short urls, all in one plugin, with an admin panel.
2021-02-27 15:32:18 +00:00
- [Keyword not found](https://github.com/8thwall/keyword-not-found-set-field-yourls) - If keyword isn't found in the database, redirect to admin page and pre-populate the short URL field.
- [Keyword Prefix](https://github.com/jangrewe/yourls-keyword-prefix) - Adds a defined prefix to your short URLs.
2017-11-29 04:47:52 +00:00
[⬆️ Go to section](#plugins)
2017-11-29 04:47:52 +00:00
### L
2017-11-29 04:47:52 +00:00
- [LDAP](https://github.com/k3a/yourls-ldap-plugin) - Enables use of LDAP for user authentication.
- [Link Anonymizer](https://github.com/katzwebservices/YOURLS-Link-Anonymizer) - Generate a link that will take you to an anonymizer service.
2021-04-07 09:07:47 +00:00
- [Link List](https://gitlab.com/ruthtillman/yourls-linklist) - List recent links added, in the admin interface or on a public page.
2017-11-29 04:47:52 +00:00
- [Limit keyword length](https://github.com/adigitalife/yourls-limit-keyword-length) - This plugin limits the number of characters allowed for the custom keyword.
- [Limit keyword length](https://github.com/gehwissenlos/yourls-limit-keyword-length) - This plugin defines the minimal amount of characters for the custom keyword.
- [Limited Links](https://github.com/LeoColomb/yourls-limited-links) ☑️ -limit the number of redirections of a specific link.
2017-11-29 04:47:52 +00:00
- [log-login](https://github.com/SweBarre/log-login) - Logs login atempts to YOURLS. To be used with fail2ban.
- [Login Timeout](https://github.com/reanimus/yourls-login-timeout) - Adds a timeout after a certain number of failed logins to mitigate brute force logins.
- [Lookup keywords by long URL substring](https://github.com/bryzgaloff/yourls-api-lookup-keywords-by-url-substr) - Add a "lookup-url-substr" action to YOURLS API which searches keywords by long URL substring (implements `url LIKE %substr%` SQL operation).
- [lowercase username](https://github.com/JensSpanier/yourls-lowercase-username) - Makes the username lowercase when logging in.
2017-11-29 04:47:52 +00:00
[⬆️ Go to section](#plugins)
2017-11-29 04:47:52 +00:00
### M
2021-02-27 15:32:18 +00:00
- [Mailto](https://github.com/peterberbec/yourls-mailto) - Adds a "mailto:" sharing option, next to Twitter and Facebook.
- [Mailto Bookmarklet](https://github.com/peterberbec/yourls-mailto-bookmarklet) - Adds a bookmarklet to share links by mail.
2022-05-05 16:25:33 +00:00
- [Mass Remove Link](https://github.com/YOURLS/mass-remove-links/) ☑️ - Remove several links at once. Select by date, date range, IP or URL matching.
2021-02-27 15:32:18 +00:00
- [Mass Update](https://github.com/Binarypark/yourls-api-mass-update) - Adds an API action to mass update links from `old_domain` to `new_domain`.
2023-02-26 13:22:36 +00:00
- [md5 salt](https://github.com/ashleykleynhans/yourls-plugin-md5-salt) - Provide backwards compatibility for those still using `md5` in their passwordless API calls.
2021-02-27 15:32:18 +00:00
- [Memcached](https://github.com/alexalouit/Yourls-Memcached) - Memcached plugin for YOURLS.
- [Meta Redirect](https://github.com/pureexe/Yourls-meta-redirect) - Redirect using HTML meta tag when you prepend the short URL with an underscore (eg `http://sho.rt/_bleh`).
- [Mobile Detect](https://github.com/guessi/yourls-mobile-detect) - Add ability to redirect by user device OS.
2017-11-29 04:47:52 +00:00
[⬆️ Go to section](#plugins)
2017-11-29 04:47:52 +00:00
### N
- [No Traking Admins](https://github.com/joshp23/YOURLS-No-Tracking-Admins) - No loggin clicks for authenticated users (compatible with OIDC).
2022-12-11 15:25:06 +00:00
- [No URL title](https://github.com/YOURLS/YOURLS/issues/1966#issuecomment-148905749) ☑️ - Don't fetch long URL titles.
- [No Version Check](https://github.com/YOURLS/YOURLS/issues/2851) ☑️ - Stop YOURLS from checking if a new release is available.
2021-12-05 11:51:22 +00:00
- [Notifier](https://github.com/SosthenG/yourls-notifier) - Sends notifications when actions occurs, like creating a new shortened url.
[⬆️ Go to section](#plugins)
2017-11-29 04:47:52 +00:00
### O
2021-02-27 15:32:18 +00:00
- [OAuth Sign In](https://github.com/LouisSung/YOURLS-OAuth_Sign_In) - Enable OAuth sign in support (using GitLab as an example).
- [OIDC](https://github.com/joshp23/YOURLS-OIDC) - OpenID Connect authentication against a generic OpenID Connect server.
- [Open Graph Meta Scraper](https://github.com/LK608/OG-Scraper) - Get Open Graph (OG) information for your shortened links.
- [Original URL Regex Limiter](https://github.com/uniwue-rz/yourls-original-url-regex-limiter) - Enables to allow and block (original) URLs not just with domain names like related plugins, but with regular expressions for more precise policies.
[⬆️ Go to section](#plugins)
2017-11-29 04:47:52 +00:00
### P
2021-02-27 15:32:18 +00:00
- [Password Protection](https://github.com/MatthewC/yourls-password-protection) - Password protect any Short URL you want so that users are prompted for a password before redirection.
- [Phishtank](https://blog.yourls.org/2011/04/yourls-abuse-anti-spam-plugins/) - Prevent spam links using Phishtank's API.
2021-02-27 15:32:18 +00:00
- [Phishtank 2.0](https://github.com/joshp23/YOURLS-Phishtank-2.0) - Functional rewrite of the old Phishtank plugin with more features.
- [Piwik-YOURLS](https://github.com/interfasys/piwik-yourls) - Piwik and a few other features.
- [Popular Clicks](https://github.com/miconda/yourls/tree/master/plugins/popular-clicks) - Display the top of the most clicked links during past days.
- [Popular Clicks Extended](https://github.com/vaughany/yourls-popular-clicks-extended) - Shows which short links get clicked the most during a specific time frame.
- [Popular Links](https://github.com/laaabaseball/Yourls-Popular-Links) - Adds an admin page that displays your shortener's most popular links.
- [Preview URL](https://yourls.org/docs/development/examples/preview) ☑️ - Add the character '~' to a short URL to display a preview screen before redirection.
2021-02-27 15:32:18 +00:00
- [Preview URL with QR Code](https://github.com/dennydai/yourls-preview-url-with-qrcode) - Add the character '~' to a short URL to display a preview screen & QR code before redirection.
- [Preview URL with QR Code And Thumbnail](https://github.com/prog-it/yourls-preview-url-with-qrcode-thumbnail) - Add the character '~' to a short URL to display a QR code and Thumbnail image before redirection.
- [Public "Prefix n' Shorten"](https://yourls.org/docs/development/examples/public-prefix) ☑️ - Redirect `http://sho.rt/http://someurl.com/` to a public interface instead of the admin area.
2021-02-27 15:32:18 +00:00
- [YOURLS Pseudonymize](https://github.com/ubicoo/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](https://github.com/joshp23/YOURLS-PUNS) - A Plugin Update Notification System: provides a report-generating page and an API with optional email notifications.
2017-11-29 04:47:52 +00:00
[⬆️ Go to section](#plugins)
2017-11-29 04:47:52 +00:00
### Q
- [QRCode](https://yourls.org/docs/development/examples/qrcode) ☑️ - Add ".qr" to short URLs to display the shorturl's QR code.
- [QRCode](https://techlister.com/plugins-2/qrcode-plugin-for-yourls/) - Creates and displays QR Codes within YOURLS.
- [QR Google Charts](https://aiaraldea.github.io/qr-google-charts/) - Another QR Code plugin, using Google Charts API.
2021-02-27 15:32:18 +00:00
- [QRCode](https://github.com/seandrickson/YOURLS-QRCode-Plugin) - 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](https://github.com/llonchj/yourls_plugins) - Forward the query string on short link to long URL (eg `http://sho.rt/kk?a=1` to `http://long.url/somepage/?a=1`).
- [Query String Keeper](https://github.com/jessemaps/yourls-query-string-keeper) - Pass the query string from the shortlink to the long URL (eg `http://sho.rt/kk?hey` forwards to `http://long.url/bleh/?hey`).
2017-11-29 04:47:52 +00:00
[⬆️ Go to section](#plugins)
2017-11-29 04:47:52 +00:00
### R
2021-02-27 15:32:18 +00:00
- [reCaptcha](https://github.com/spbriggs/recaptcha-plugin) - YOURLS plugin implementing reCaptcha for unauthenticated users in your public interface.
- [Redirect Index](https://github.com/tomslominski/yourls-redirect-index) - Redirect the user to another site if they go to the base directory of your YOURLS installation.
- [Referral Link Checkpoint](https://github.com/telepathics/yourls-ref-checkpoint) - Add a landing page to let visitors know when it is a referral link.
2017-11-29 04:47:52 +00:00
- [Regenerate URL](https://github.com/TheLeonKing/yourls-api-regenerate-url) - Regenerate a new keyword for a URL that has already been shortened.
2021-02-27 15:32:18 +00:00
- [Remove The Share Function](https://github.com/seandrickson/YOURLS-Remove-the-Share-Function) - Remove the Share button and box that toggles the sharing options on the Admin page.
- [Remove YouTube Play Indicator](https://github.com/UltraNurd/youtube-play-indicator) - Removes the triangle from the title of Youtube shortened URL.
- [Reset URLs](https://gist.github.com/ozh/a0090f46569b50835520d95f9481d9fd) ☑️ - Deletes all URLs. For your test install needs.
2021-02-27 15:32:18 +00:00
- [Reverse Proxy](https://github.com/Diftraku/yourls_reverseproxy) - Fixes the user IPs to point to the actual user instead of your cloud providers infrastructure IPs (Cloudflare, Heroku...).
- [rscrub](https://github.com/joshp23/YOURLS-rscrub) - An "HTTP referrer scrubbing swiss army knife for YOURLS" (evolution of the Hide Referrer plugin).
2017-11-29 04:47:52 +00:00
[⬆️ Go to section](#plugins)
2017-11-29 04:47:52 +00:00
### S
- [SAML Authentication](https://github.com/wlabarron/yourls-saml) - Sign in via SAML-based single sign-on.
- [Save By Keyword](https://github.com/vitorccs/yourls-api-save-by-keyword) - API action to update the long URL of an existing keyword, or creates a new short URL.
2017-11-29 04:47:52 +00:00
- [Semantic Scuttle](https://github.com/jonrandoem/yourls-semanticscuttle) - Allows the sharing of the URL to a Semantic Scuttle installation.
- [Separate Users](https://github.com/ianbarber/Yourls-Separate-Users) - Adds a username to each created URL, and filters the admin interface.
2021-02-27 15:32:18 +00:00
- [Shaarli](https://github.com/miwasp/yourls-shaarli) - Allows the sharing of the URL to a Shaarli installation.
- [Share Files](https://github.com/mtttmpl/YOURLS-Plugin--Share-Files) - Upload and share files with YOURLS.
2017-11-29 04:47:52 +00:00
- [Share LinkedIn](https://github.com/popnt/yourls-linkedin-share) - Adds LinkedIn to the Quick Share Box.
2022-04-19 16:02:49 +00:00
- [Share with Tumblr](https://gist.github.com/ozh/25b2074dd275ed091aa1869200894c4d) ☑️ - In the Quick Share box, add a one-click share to Tumblr link.
2021-02-27 15:32:18 +00:00
- [Shibboleth](https://github.com/fuero/yourls-shibboleth) - Enable authentication with Shibboleth.
2020-07-13 16:36:06 +00:00
- [ShortShort](https://github.com/abaumg/yourls-shortshort) - Checks if a URL is already shortened (e.g. t.co, bit.ly, youtu.be) to avoid nested shortened links.
- [Show Git Branch](https://github.com/ozh/show-git-branch) ☑️ - Using YOURLS on a dev box under Git? Show the current branch in page footer.
2017-11-29 04:47:52 +00:00
- [SimpleDB Clickqueue](https://github.com/ianbarber/Yourls-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](https://github.com/mtttmpl/YOURLS-Plugin--Skimlinks) - Push all links through Skimlinks to automatically embed affiliate codes.
2021-02-27 15:32:18 +00:00
- [Skip Click Count](https://github.com/vipwangtian/yourls-skip-click-count) - Don't count clicks on short URLs.
- [Slack Notifier](https://github.com/jfix/yourls-plugin-slack-notifier) - Send a notification to a Slack channel whenever a new short URL is created.
2021-02-27 15:32:18 +00:00
- [SMTP Contact](https://github.com/joshp23/YOURLS-SMTP-contact) - Provides a public contact page using PHPMailer for outbound mail delivery.
2017-11-29 04:47:52 +00:00
- [Snapshot](https://github.com/joshp23/YOURLS-Snapshot) - Visual preview plugin with image caching powered by PhantomJS.
- [YOURLS SQLite](https://github.com/ozh/yourls-sqlite) ☑️ - SQLite driver for YOURLS. It is now considered outdated.
- [YOURLS SQLite](https://github.com/Flameborn/yourls-sqlite) - A fork of the original SQLite driver for YOURLS, actively maintained.
2017-11-29 04:47:52 +00:00
- [Static Titles](https://github.com/softius/yourls-static-titles) - Provide two options to avoid the network traffic when retrieving URL titles.
- [SSL for SSL](https://github.com/tipichris/ssl4ssl) - Generates SSL short links if the original link was SSL.
- [Swap Short URL](https://github.com/gerbz/Yourls-Swap-Short-Url) - A plugin to have `http://sho.rt/blah` while having YOURLS installed in `http://sho.rt/yourls/`
2017-11-29 04:47:52 +00:00
[⬆️ Go to section](#plugins)
2017-11-29 04:47:52 +00:00
### T
- [Telegram Notifier](https://github.com/XLixl4snSU/yourls-telegram-notifier) - Get a notification via Telegram whenever a new shortlink is created.
- [Telegram Quickshare](https://github.com/ColinShark/YOURLS_tg-quickshare) - Quickly share a shortened URL via Telegram Messenger.
2021-02-27 15:32:18 +00:00
- [Title Refetch](https://github.com/joshp23/YOURLS-title-refetch) - Refetch page titles.
- [Timezones](https://github.com/YOURLS/timezones) ☑️ - Tell YOURLS your time zone and how you'd like times and dates displayed.
2021-02-27 15:32:18 +00:00
- [Thumbnail URL image](https://github.com/stevecohenfr/yourls-thumbnail-url) - Get the Thumbnail URL image (long URL) by adding `.i` to the end of the keyword.
2018-10-24 15:14:21 +00:00
- [Time-Period Clicks](https://github.com/rinogo/yourls-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).
2021-02-27 15:32:18 +00:00
- [Time Limit Link](https://github.com/chesterrush/yourls-Time-Limit-Link) - Set a time limit for links.
- [Track Custom Keyword](https://github.com/timcrockford/track-custom-keywords) - Add a new field to YOURLS designed to track if a keyword was randomly assigned or manually specified.
2017-11-29 04:47:52 +00:00
- [Typer, a yourls prank plugin](https://github.com/koma5/typer) - Add an underscore * to your shortlink and the user will be shown a page where they have to type the shortlink themselves.
[⬆️ Go to section](#plugins)
2017-11-29 04:47:52 +00:00
### U
2021-02-27 15:32:18 +00:00
- [Upload and Shorten](https://github.com/fredl99/YOURLS-Upload-and-Shorten) - Upload and share files with YOURLS.
- [U-SRV](https://github.com/joshp23/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](https://github.com/joshp23/YOURLS-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](https://github.com/joshp23/YOURLS-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.
- [Users in Database](https://gist.github.com/njbair/d951fb8b9c1f44d0e8bcd405645bbde1) - Reads users from a database table instead of a config file. Currently does not provide an interface for adding/editing users though.
2017-11-29 04:47:52 +00:00
[⬆️ Go to section](#plugins)
2017-11-29 04:47:52 +00:00
### W
2021-02-27 15:32:18 +00:00
- [wallabag](https://github.com/jonrandoem/yourls-wallabag) - Allows the sharing of the URL to a Wallabag installation (previously named Poche).
- [Whatsapp quickshare](https://github.com/wissehes/Whatsapp-quickshare) - Allows you to share your short URL via whatsapp.
- [Word Based Short URLs](https://github.com/ozh/yourls-word-based-short-urls) ☑️ - Generate short URLs with adjectives and nouns, like `http://sho.rt/FluffyArrogantUnicorn`.
2017-11-29 04:47:52 +00:00
[⬆️ Go to section](#plugins)
2017-11-29 04:47:52 +00:00
### X
2023-02-26 15:06:07 +00:00
- [X-Robots-Tag header](https://github.com/YOURLS/YOURLS/pull/3517#issuecomment-1427114687) ☑️ - Send `X-Robots-Tag: index` header on redirection, to fine tune your SEO needs.
[⬆️ Go to section](#plugins)
2017-11-29 04:47:52 +00:00
### Y
2022-06-09 19:38:56 +00:00
- [YA Phish Checker](https://github.com/stefanmm/YOURLS-ya-phish-checker) - Prevent spam/phishing links using ipqualityscore's API. Fork of Phishtank-2.0 (+some extra features)
2021-02-27 15:32:18 +00:00
- [YAPCache](https://github.com/tipichris/YAPCache) - YAPCache is an APC based cache designed to reduce the database load of YOURLS and increase performance.
- [YOURS-TN](https://github.com/sgiovagnoli/YOURLS-TN) - Display thumbnails on YOURLS admin page and stats page, using thumbnail.ws.
- [YouTube Title Fix](https://github.com/joshp23/YOURLS-YouTube-title-fix) - Fetch YouTube page titles via Google API.
2017-11-29 04:47:52 +00:00
[⬆️ Go to section](#plugins)
### Z
[⬆️ Go to section](#plugins)
2017-11-29 04:47:52 +00:00
## Themes
[🔼 Go to top](#readme)
This will be the next big thing when YOURLS fully support theming
2021-02-27 15:42:30 +00:00
- [∞²](https://github.com/tomslominski/infinity-squared) - Infinity Squared, a beautiful public page theme for YOURLS.
- [Air 66](https://github.com/air66design/air66-yourls-admin-theme) - A responsive admin theme for YOURLS.
- [Sleeky](https://github.com/Flynntes/Sleeky) - A sleek and simple frontend & backend theme for YOURLS with light and dark modes.
## Translations
[🔼 Go to top](#readme)
2017-11-29 04:47:52 +00:00
YOURLS supports localization: this means if a language file for YOURLS in available in your language, YOURLS will speak your language!
- Brazilian: [here](https://github.com/didi3d/YOURLS-pt_BR) and [here](https://github.com/henriquecrang/YOURLS-pt_BR) (`pt_BR`)
- [Bulgarian ](https://github.com/VoodooServ/YOURLS-bg_BG) (`bg_BG`)
2021-09-07 22:02:54 +00:00
- [Catalan](https://github.com/kuratowsky/YOURLS-ca_ES) (`ca_ES`)
2017-11-29 04:47:52 +00:00
- [Czech](https://github.com/KubaCZ721/YOURLS-cs_CZ) (`cs_CZ`)
- [Danish](https://github.com/jensz12/YOURLSDK) (`da_DK`)
- [Dutch](https://github.com/Beun/YOURLS-nl_NL) (`nl_NL`)
- [English (Australian)](https://github.com/bakkbone/yourls-en_AU) (`en_AU`)
2017-11-29 04:47:52 +00:00
- [Farsi](https://github.com/saahmadnejad/YOURLS-fa_FA) (`fa_FA`)
2019-10-17 08:00:37 +00:00
- [Finnish](https://github.com/re2man/YOURLS-fi_FI) (`fi_FI`)
2017-11-29 04:47:52 +00:00
- [French](https://github.com/ozh/YOURLS-fr_FR) (`fr_FR`)
2021-03-01 13:58:45 +00:00
- [German](https://github.com/DerSev/YOURLS-de_DE) (`de_DE`)
2017-11-29 04:47:52 +00:00
- [Hindi](https://github.com/itsKV/YOURLS-Hindi-translation) (`hi-IN`)
- [Indonesian](https://github.com/tigefa4u/YOURLS-id_ID-Translations) (`id_ID`)
- [Italian](https://github.com/ggardin/YOURLS-it_IT) (`it_IT`)
2020-08-28 17:04:42 +00:00
- [Japanese](https://github.com/havill/YOURLS-ja_JP) (`ja_JP`)
2017-11-29 04:47:52 +00:00
- [Korean](https://github.com/at4am/YOURLS-ko_KR) (`ko_KR`)
- [Norwegian (bokmål)](https://github.com/geirawsm/YOURLS-nb_NO) (`nb_NO`)
2017-11-29 04:47:52 +00:00
- [Polish](https://github.com/tomslominski/YOURLS-pl_PL) (`pl_PL`)
- [Portuguese](https://github.com/oscarmarcelo/YOURLS-pt_PT) (`pt_PT`)
- [Russian](https://github.com/nsauk/YOURLS-ru_RU) (`ru_RU`)
- [Simplified Chinese](https://github.com/taozhiyu/yourls-translation-zh_CN) (`zh_CN`)
- [Slovak](https://github.com/filyph/YOURLS-sk_SK) (`sk_SK`)
2017-11-29 04:47:52 +00:00
- [Spanish](https://github.com/kralizeck/YOURLS-es_ES) (`es_ES`)
- [Telugu](https://github.com/kalyan-gupta/YOURLS_Telugu_Translation) (`te_IN`)
- [Turkish](https://github.com/cgdgsg22/YOURLS_TR) (`tr_TR`)
- [Traditional Chinese](https://github.com/alexclassroom/YOURLS-zh_TW) (`zh_TW`)
2023-03-07 23:22:28 +00:00
- [Ukrainian](https://github.com/Dizer7/YOURLS-uk) (`uk`)
2017-11-29 04:47:52 +00:00
## Integrations
[🔼 Go to top](#readme)
2021-02-27 15:32:18 +00:00
Make YOURLS work with other platforms, programming languages or tools.
2022-01-27 14:43:49 +00:00
### 3rd party platforms
- [Make](https://www.make.com/en/integrations/yourls) - Automate actions with YOURLS (eg new blog post -> shorten link -> share on Discord)
2022-01-27 14:43:49 +00:00
### 3rd party Integrations and Frameworks
2021-06-06 16:14:27 +00:00
- Bash
2023-03-11 14:59:05 +00:00
- [YOURLS BASH](https://github.com/ozh/yourls-bash) - a simple BASH script to shorten URLs with YOURLS.
- [CakePHP](https://github.com/adrianoluis/CakePHP-YOURLS-Plugin) - Plugin to integrate YOURLS.
2023-03-11 14:59:05 +00:00
- Docker
- Official [YOURLS Docker image](https://hub.docker.com/_/yourls).
- [Dockerize YOURLS](https://github.com/guessi/docker-yourls) - a YOURLS image with several integrated plugins.
2021-06-06 16:14:27 +00:00
- [Drupal](https://www.drupal.org/project/shorten) - YOURLS for Drupal.
- [FreeBSD Freshport](https://www.freshports.org/www/yourls/) - a FreeBSD package.
2021-06-06 16:14:27 +00:00
- [Gnome Desktop](https://github.com/joshp23/gnome-shell-extension-yourls) - Gnome Shell extension to shorten links in the clipboard.
2021-02-21 18:49:49 +00:00
- Laravel
2021-02-27 15:42:30 +00:00
- [Laravel YOURLS Plugin](https://github.com/phpsa/laravel-yourls-plugin)
- [Laraval YOURLS](https://github.com/orumad/laravel-yourls)
2021-06-06 16:14:27 +00:00
- NodeJS
- [JavaScript bindings for the YOURLS API](https://github.com/neocotic/yourls-api) - JavaScript bindings to leverage JSONP support.
- [YOURLS API for nodejs](https://www.npmjs.com/package/yourls)
- Perl
- [WWW::Shorten::Yourls](https://github.com/p5-shorten/WWW-Shorten-Yourls) - A Perl module to shorten URLs using YOURLS.
2021-02-27 15:42:30 +00:00
- [AmazonAffiliatesToYourls](https://github.com/acaranta/AmazonAffiliatesToYourls) - Amazon affiliate management.
2022-02-09 16:40:59 +00:00
- [Prometheus exporter](https://github.com/just1not2/prometheus-exporter-yourls) - A Prometheus exporter to monitor a YOURLS instance.
2021-05-02 16:20:20 +00:00
- Python
- [pyourls3](https://pypi.org/project/pyourls3/) - A Python client for YOURLS, built for Python 3.
- [python-yourls](https://github.com/tflink/python-yourls/) - Alternative Python 2 client for YOURLS.
- [yourls-python](https://github.com/razerm/yourls-python) - `pip install yourls` for Python 2 or 3
2021-02-27 15:32:18 +00:00
- [Ruby](https://github.com/threestage/yourls) - A Ruby wrapper for the YOURLS API.
- [status.net](https://github.com/rthees/yourls-status-net) - Plugin for status.net to use YOURLS.
2021-06-06 16:14:27 +00:00
- Telegram
- [Telegram bot](https://simon-eller.at/en/projects/lets-short) - A [Telegram bot](https://t.me/LetsShortBot) to shorten links.
- [YOURLS Bot](https://gitlab.com/HirschHeissIch/yourls-bot) - Open source code base for hosting your own Telegram bot to shorten links via your own YOURLS instance. Includes access control by default, so suitable for non-public YOURLS instances.
- [VB .Net](https://www.nugardt.com/open-source/yourls-api/) - A VB .Net 4.0 wrapper for the YOURLS API.
2021-06-06 16:14:27 +00:00
- WordPress
- [YOURLS Link Creator](https://wordpress.org/plugins/yourls-link-creator/)
- [YOURLS Widget](https://gist.github.com/joshp23/3f990e6ec36e24ba53985968bbfa89f1) - Fetch and display YOURLS links and a QR code in a widget.
- There are numerous [WordPress plugins](https://wordpress.org/plugins/search/yourls/) with YOURLS support.
### Applications
- Android
2021-02-27 15:42:30 +00:00
- [aYourls](https://gitlab.com/matecode/ayourls/-/tree/develop) - A dedicated app for YOURLS supporting server-side deletion (needs [API Delete](https://github.com/claytondaley/yourls-api-delete)).
- [URL Shortener](https://play.google.com/store/apps/details?id=de.keineantwort.android.urlshortener) - Supports various shortener, including YOURLS.
- [iC-YOURLS](https://play.google.com/store/apps/details?id=net.inscomers.yourls) - A simple YOURLS app for Android, supports receiving links from other apps.
- iOS
2021-02-27 15:42:30 +00:00
- [ShortTail](https://www.adamdehaven.com/blog/shorttail-for-yourls-an-elegant-yourls-client-for-iphone/) - An elegant YOURLS client for iPhone.
- [ShortFox2](https://apps.apple.com/us/app/shortfox2/id1465812791?ls=1&t=8)
- [Short Menu](https://shortmenu.com/ios/) - YOURLS support requires a one-time in-app purchase of about $2 USD (See also: [Setup instructions](https://shortmenu.com/support/custom-services/yourls/)).
- Chrome
2021-02-27 15:42:30 +00:00
- [YOURLS](https://chrome.google.com/webstore/detail/yourls/nddaaiojgkoldnhnmkoldmkeocbooken)
- Firefox
- [YOURLS shortener](https://addons.mozilla.org/en-US/firefox/addon/yourls-shortener/)
- Mac
2021-02-27 15:42:30 +00:00
- [Short Menu](https://shortmenu.com/mac/) - Available for $6 from the App Store or directly from the developer (See also: [Setup instructions](https://shortmenu.com/support/custom-services/yourls/)).
2021-02-21 19:37:50 +00:00
- Windows
2021-02-27 15:42:30 +00:00
- [YOURLS on Windows](https://appsonwindows.com/apk/127308/) - Run YOURLS as a Windows program.
## Guides & Tutorials
[🔼 Go to top](#readme)
### Installation guides
2022-02-09 16:40:59 +00:00
- [Installing YOURLS on a Plesk-Hosted Domain](https://www.danhendricks.com/2018/10/installing-yourls-on-plesk-shared-hosting-domain/)
- [How to Install YOURLS using Softaculous](https://www.websiterating.com/online-marketing/how-to-install-yourls-using-softaculous/)
- [How to Install YOURLS on a VPS or shared hosting](https://thishosting.rocks/how-to-shorten-your-links-with-your-own-domain/)
- [YOURLS on Azure](https://www.juharyhanen.com/technology/create-personal-url-shortener-in-5-simple-steps/)
- CentOS
2021-02-27 15:42:30 +00:00
- [How to Install YOURLS on CentOS 7](https://www.vultr.com/docs/how-to-install-yourls-on-centos-7)
- [How to install YOURLS on Centos 7](https://www.linuxcloudvps.com/blog/how-to-install-yourls-on-centos-7/)
- [How to Install YOURLS on CentOS 8](https://www.howtoforge.com/how-to-install-yourls-on-centos-8/)
2022-04-19 15:48:25 +00:00
- [YOURLS on Cherokee](https://github.com/lylebrown/YOURLS-Cherokee)
- [YOURLS on Cloudron](https://www.cloudron.io/store/org.yourls.cloudronapp.html)
- [YOURLS on Installatron](https://installatron.com/yourls)
2022-04-19 15:48:25 +00:00
- [YOURLS on IIS](https://gist.github.com/ozh/714d23228235becba14fea925fc77e2c)
- [YOURLS on Fedora](https://fedoraproject.org/wiki/Install_and_configure_YOURLS_for_AutoQA)
2023-03-11 14:59:05 +00:00
- [YOURLS on Yunohost](https://github.com/YunoHost-Apps/yourls_ynh)
- Guides for Ubuntu:
- [How to install YOURLS on Ubuntu](https://computingforgeeks.com/install-yourls-your-own-url-shortener-on-ubuntu/)
2021-02-27 15:42:30 +00:00
- [How to install YOURLS on Ubuntu 14.04](https://www.rosehosting.com/blog/how-to-install-yourls-on-ubuntu-14-04/)
- [How to install YOURLS on Ubuntu 20.04](https://linuxbuz.com/linuxhowto/install-yourls-ubuntu-20-04)
- [How to Install YOURLS on Ubuntu with Nginx and Lets Encrypt](https://linuxstans.com/how-to-install-yourls/)
- Windows
- [How to Install YOURLS on WAMP](https://gist.github.com/AlbertoVargasMoreno/fb624a33244b6047bbab1fb95aabc6af)
### Installation guides in other languages
- [宝塔面板搭建短链接服务 YOURLS](https://blog.lza59.com/archives/yourls.html)
- [Cómo instalar YOURLS, usando Softaculous](https://www.websiterating.com/es/online-marketing/how-to-install-yourls-using-softaculous/)
2022-04-19 15:48:25 +00:00
- [Cómo instalar YOURLS en Ubuntu 20.04](https://linuxyunnovato.wordpress.com/2022/04/12/como-instalar-yourls-en-ubuntu-20-04/)
- [Installer YOURLS, un système d'URL raccourcies](https://www.justegeek.fr/tuto-installer-yourls-un-systeme-durl-raccourcies/)
- [Трекер Yourls ваш собственный сокращатель ссылок (URL)](https://wiki.dieg.info/yourls)
### Other tutorials
- [Getting Started with YOURLS](https://www.youtube.com/watch?v=9L8HtB6vZdQ) - a video presentation that includes API examples with Keyboard Maestro
- [YOURLS with Tweetbot](https://2fatdads.com/2012/02/how-to-make-yourls-org-work-in-tweetbot/)
## Showcases
[🔼 Go to top](#readme)
2021-02-21 19:17:24 +00:00
### Sites running YOURLS with a unique design or concept
2021-02-21 19:17:24 +00:00
- https://oe.cd/ - Europe OECD's internal URL shortener with a neat interface and private features.
2021-02-27 15:42:30 +00:00
- https://kiwi.gg/ - A sexy shortener home page with stats and details.
- https://your.ls/ - Very neat public interface using [Sleeky](https://github.com/Flynntes/Sleeky) theme. Also a neat domain hack :)
- https://yourwish.es/ - Easily share an Amazon wishlist.
- http://vbly.us - YOURLS early adopter, once taken down by Libya! ([story](https://mashable.com/archive/vbly-domain-seizure)).
2021-02-21 19:17:24 +00:00
### Celebrity endorsements (sort of)
2021-02-21 19:17:24 +00:00
2021-02-27 15:42:30 +00:00
- Early review on [Lifehacker](https://lifehacker.com/make-your-own-url-shortening-service-5335216).
- https://mclrn.co/ by [McLaren Cars](https://www.mclaren.com/).
2021-04-14 16:17:27 +00:00
- https://smashed.by/ by [Smashing Magazine](https://www.smashingmagazine.com/).
- https://cuny.is/ by the [City University of New York](https://www.cuny.edu/).
2021-04-14 16:17:27 +00:00
- https://dhurl.org/ by [Dreamhost](https://yourls.org/dreamhost).
2021-02-21 19:17:24 +00:00
YOURLS has also been used by the NASA, Virgin and Epic Games. Sweet! 😊
2021-02-21 19:17:24 +00:00
## Contribute
2017-11-29 04:47:52 +00:00
Contributions welcome! Read the [contribution guidelines](CONTRIBUTING.md) first.
## License
2017-11-29 04:47:52 +00:00
[![CC0](https://mirrors.creativecommons.org/presskit/buttons/88x31/svg/cc-zero.svg)](https://creativecommons.org/publicdomain/zero/1.0/)