{"id":26548541,"url":"https://github.com/simplytil/yourls-shortener-extension","last_synced_at":"2026-05-15T20:33:07.601Z","repository":{"id":283360020,"uuid":"942873393","full_name":"SimplyTil/yourls-shortener-extension","owner":"SimplyTil","description":"YOURLS Chrome Extension to add usability with YOURLS host","archived":false,"fork":false,"pushed_at":"2025-03-19T20:06:49.000Z","size":69,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-19T21:26:12.967Z","etag":null,"topics":["extension","extension-chrome","yourls","yourls-extension"],"latest_commit_sha":null,"homepage":"https://chromewebstore.google.com/detail/yourls-link-shortener/bpaidpglokfmipgcbippdmcncngcjghh","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SimplyTil.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-03-04T20:17:08.000Z","updated_at":"2025-03-19T20:06:52.000Z","dependencies_parsed_at":"2025-03-19T21:36:15.394Z","dependency_job_id":null,"html_url":"https://github.com/SimplyTil/yourls-shortener-extension","commit_stats":null,"previous_names":["simplytil/yourls-shortener-extension"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SimplyTil%2Fyourls-shortener-extension","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SimplyTil%2Fyourls-shortener-extension/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SimplyTil%2Fyourls-shortener-extension/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SimplyTil%2Fyourls-shortener-extension/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SimplyTil","download_url":"https://codeload.github.com/SimplyTil/yourls-shortener-extension/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244914053,"owners_count":20530949,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["extension","extension-chrome","yourls","yourls-extension"],"created_at":"2025-03-22T06:19:18.308Z","updated_at":"2026-05-15T20:33:07.596Z","avatar_url":"https://github.com/SimplyTil.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Chrome Extension for YOURLS Link Shortener\n\nA modern browser extension for quickly shortening URLs with your own [YOURLS](https://yourls.org/) (Your Own URL Shortener) instance. Built with Manifest V3 compatibility for Chrome and Chromium-based browsers.\n\n\n\n## ![YOURLS Extension Screenshot](images/icon16.png) Features\n\n### Core Functionality\n- **One-click URL shortening** from any webpage\n- **Custom keywords** for personalized short links\n- **Auto-copy** shortened URLs to clipboard\n- **Context menu integration** for quick access\n- **Bulk operations** support\n\n### Advanced Analytics\n- **Comprehensive dashboard** with real-time statistics\n- **Performance metrics** including clicks today, this week, and this month\n- **Top performing links** with detailed click analytics\n- **Server information** including YOURLS version and database statistics\n- **Data export** functionality for further analysis\n- **Visual charts** and animated counters for better data presentation\n\n### Multi-Server Support\n- **Primary and additional server** configurations\n- **Server switching** in popup and analytics views\n- **Independent analytics** for each server\n- **Custom server naming** for easy identification\n\n### Internationalization\n- **14 languages** supported including RTL languages\n- **Dynamic language switching** without restart\n- **Localized error messages** and help text\n- **RTL layout support** for Arabic and other RTL languages\n\n### Advanced Settings\n- **Auto-save settings** for seamless experience\n- **Connection testing** for both servers\n- **Customizable behavior** options\n- **Modern tabbed interface** for organized settings\n\n\n## 🚀 Installation\n\n### Chrome Web Store (Recommended)\n1. Visit the [Chrome Web Store page](https://lyxo.link/l4kzv)\n2. Click \"Add to Chrome\"\n3. Confirm the installation\n\n### Manual Installation\n1. Download the latest release from [GitHub Releases](https://github.com/simplytil/yourls-shortener-extension/releases)\n2. Extract the zip file to a folder\n3. In Chrome, go to `chrome://extensions/`\n4. Enable \"Developer mode\" in the top-right corner\n5. Click \"Load unpacked\" and select the extracted folder\n\n## ⚙️ Configuration\n\n### Setting Up Your YOURLS Server\n\n1. Click the extension icon and select \"Settings\" (gear icon)\n2. Navigate to the \"Servers\" tab\n\n#### Primary Server Configuration\n- **YOURLS Server URL**: Enter the base URL of your YOURLS installation\n  - Example: `https://your-domain.com/yourls` or `http://localhost/yourls`\n  - Make sure to include the correct protocol (`http://` or `https://`)\n  - You don't need to include `yourls-api.php` at the end\n- **Signature Token**: Enter your YOURLS signature token\n  - Find this in your YOURLS admin panel under Tools → API\n- Click \"Test Connection\" to verify your settings\n\n#### Additional Server (Optional)\n- Enable the \"Additional YOURLS server\" toggle\n- Configure URL, signature token, and display name\n- Use the server selector dropdown in the popup to switch between servers\n\n### General Settings\n\nNavigate to the \"General\" tab to configure behavior and interface options:\n\n- **Always ask for keyword**: When enabled, you'll be prompted for a custom keyword each time\n- **Auto-copy shortened URL**: Automatically copy the short URL to your clipboard\n- **Auto-save settings**: Save changes automatically without clicking the save button\n- **Language**: Choose your preferred language from the dropdown\n\n## 📝 Usage\n\n### Basic Usage\n1. Navigate to any webpage you want to shorten\n2. Click the YOURLS extension icon in your toolbar\n3. (Optional) Enter a custom keyword if the setting is enabled\n4. Click \"Shorten URL\"\n5. Copy the shortened URL or use it directly (it's automatically copied if auto-copy is enabled)\n\n### Context Menu\n- Right-click on any link\n- Select \"Shorten Link\" from the context menu\n- The extension popup will open with that link ready to be shortened\n\n### Dashboard\nClick the extension icon, then open settings and go to the \"Dashboard\" tab to:\n- View statistics from your YOURLS server\n- See your most recently created short links\n- Copy any of your recent links with a single click\n- Switch between servers (if you've configured multiple)\n\n## 🛠 Technical Details\n\n- Built with Manifest V3 for modern browser compatibility\n- Uses background scripts to handle API requests and bypass CORS restrictions\n- Implements modern JavaScript with async/await patterns\n- Utilizes CSS custom properties for consistent theming\n- Provides comprehensive error handling and user feedback\n\n## 🔍 Troubleshooting\n\n### Common Issues\n\n**Connection Failed**\n- Verify your YOURLS URL is correct and includes the protocol (`http://` or `https://`)\n- Check that your signature token is valid\n- Ensure your YOURLS server is online and accessible\n\n**Extension Not Working**\n- Check browser console for any error messages\n- Verify that you have the necessary permissions enabled\n- Try reinstalling the extension\n\n**Server Not Showing in Dashboard**\n- Make sure you've properly configured server settings\n- Check that your YOURLS API is properly responding\n- Some older YOURLS versions may not support all dashboard features\n\n## 📚 Resources\n\n- [YOURLS Official Website](https://yourls.org/)\n- [YOURLS Documentation](https://docs.yourls.org/)\n- [Report Issues](https://github.com/simplytil/yourls-shortener-extension/issues)\n\n## 📜 License\n\n```\nCopyright 2025 YOURLS Link Shortener Contributors\n\nLicensed under the GNU General Public License v3.0 (GPL-3.0)\nYou may obtain a copy of the License at\n\n    https://www.gnu.org/licenses/gpl-3.0.html\n```\n\n## 👏 Acknowledgments\n\n- Thanks to [binfalse](https://github.com/binfalse) for the initial idea and code foundation\n- YOURLS team for creating the excellent URL shortener platform\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimplytil%2Fyourls-shortener-extension","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsimplytil%2Fyourls-shortener-extension","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimplytil%2Fyourls-shortener-extension/lists"}