{"id":645,"url":"https://github.com/basharovV/StumbleUponAwesome","last_synced_at":"2025-07-31T12:33:18.007Z","repository":{"id":45833258,"uuid":"235890763","full_name":"basharovV/StumbleUponAwesome","owner":"basharovV","description":"⚡️A browser extension that takes you to a random site from one of the awesome curated lists. Like good ol' StumbleUpon, for developers, tech \u0026 science lovers.","archived":false,"fork":false,"pushed_at":"2024-05-11T11:25:09.000Z","size":19065,"stargazers_count":338,"open_issues_count":4,"forks_count":20,"subscribers_count":9,"default_branch":"master","last_synced_at":"2024-05-22T02:00:49.656Z","etag":null,"topics":["awesome","awesome-list","browser-extension","chrome-extension","discovery","firefox-addon","stumble","stumbleupon"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/basharovV.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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":"2020-01-23T21:33:05.000Z","updated_at":"2024-05-15T14:36:08.000Z","dependencies_parsed_at":"2024-05-22T02:00:28.721Z","dependency_job_id":"0e05a46f-9aa9-482a-8354-06302a321909","html_url":"https://github.com/basharovV/StumbleUponAwesome","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/basharovV%2FStumbleUponAwesome","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/basharovV%2FStumbleUponAwesome/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/basharovV%2FStumbleUponAwesome/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/basharovV%2FStumbleUponAwesome/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/basharovV","download_url":"https://codeload.github.com/basharovV/StumbleUponAwesome/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":228248369,"owners_count":17891447,"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":["awesome","awesome-list","browser-extension","chrome-extension","discovery","firefox-addon","stumble","stumbleupon"],"created_at":"2024-01-05T20:13:01.067Z","updated_at":"2024-12-05T06:31:13.360Z","avatar_url":"https://github.com/basharovV.png","language":"JavaScript","funding_links":[],"categories":["Meta","Related","Uncategorized","JavaScript","Live Site:   [searchAwesome](https://search-awesome.vercel.app/)","HarmonyOS","Themed Directories"],"sub_categories":["Uncategorized","Windows Manager","Other"],"readme":"# \u003cimg src=\"extension/images/icon_128.png\" width=\"45\" align=\"left\"\u003e StumbleUponAwesome\nAn *awesome* internet discovery button, for developers, tech and science lovers. \n\n\u003cimg src=\"https://img.shields.io/chrome-web-store/users/dhfmgppomdaagdcbpccdfjpopgikcdge?color=%236F82EB\u0026label=chrome%20users\u0026labelColor=464646\u0026style=flat-square\u0026logo=google-chrome\u0026logoColor=white\"/\u003e \u003cimg src=\"https://flat.badgen.net/amo/users/stumbleuponawesome?color=6F82EB\u0026label=firefox%20users\u0026icon=firefox\"/\u003e \u003cimg src=\"https://img.shields.io/chrome-web-store/v/dhfmgppomdaagdcbpccdfjpopgikcdge?color=E87676\u0026label=version\u0026style=flat-square\" /\u003e \u003cimg src=\"https://flat.badgen.net/github/license/basharovV/stumbleuponawesome?color=green\" /\u003e\n[![Mentioned in Awesome](https://awesome.re/mentioned-badge-flat.svg)](https://github.com/sindresorhus/awesome)\n\n\u003cp align=\"center\"\u003e\n  \u003cimg style=\"width: 100%;padding:0;margin:0;\" src=\"header.png\"/\u003e\n\u003c/p\u003e\n\n\u003e A browser extension that takes you to a random site from one of the [awesome curated lists](https://github.com/sindresorhus/awesome). Like good ol' StumbleUpon (which is now dead). \n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://chrome.google.com/webstore/detail/stumbleuponawesome/dhfmgppomdaagdcbpccdfjpopgikcdge?authuser=3\"\u003e\u003cb\u003e⚡️ Install Chrome Extension\u003c/b\u003e\u003c/a\u003e\n  \u003ca href=\"https://addons.mozilla.org/en-GB/firefox/addon/stumbleuponawesome/\"\u003e\u003cb\u003e⚡️ Install Firefox Add-on\u003c/b\u003e\u003c/a\u003e\n\u003c/p\u003e\n\nThere are 45,787 unique sites from 554 awesome lists on Github from kind contributors. There's some hidden gems waiting in there 💎 . \n\n----\n\n## How to use it:\n**To stumble:** Simply click on the ⚡️ extension button → go to a new awesome site!\n\n\u003csmall\u003e(or use \u003ckbd\u003e**`Alt`**\u003c/kbd\u003e + \u003ckbd\u003e**`Shift`**\u003c/kbd\u003e +\u003ckbd\u003e**`S`**\u003c/kbd\u003e)\u003c/small\u003e\n\n---\n\n\u003cimg align=\"right\" width=\"150\" src=\"./rabbit-hole-icon.gif\"/\u003e\n\n### ꩜ Introducing: The Rabbit Hole \n\n_We have all been down internet rabbit holes_. \u003cbr/\u003e\n.\u003cbr/\u003e\nOne minute you're casually reading the news, the next you've read so much about `random topic` you might as well do a TED talk. \u003cbr/\u003e\n.\u003cbr/\u003e\n_What just happened?_ The rabbit hole pulled you in and you lost track of time, but you also might have discovered something _awesome_. \u003cbr/\u003e\n.\u003cbr/\u003e\nSo why not embrace it, by having a fancy button for it, _obviously_. \n\n**Stay stumblin' on the same topic,** or exit back to random mode.\u003cbr/\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg style=\"width: 100%;padding:0;margin:0;\" src=\"rabbit-hole.gif\"/\u003e\n\u003c/p\u003e\n\n---\n\n### Setup\n\n1. Clone or fork this repository\n2. Open Chrome/Brave or other Chromium-based browser\n3. Open the extensions page at `chrome://extensions`\n4. Enable developer mode \n5. Click \"Load unpacked\" and select the `/extension` folder. \n\n### Development\n\nHere's some of the things I'd like to build out for this extension. However the main one right now is simply to curate the links as good as I can, add more data sources and make sure the pages are a good mix of interesting, useful, fun and exciting. \n\n- [ ] Feedback mechanism for good/bad links\n- [ ] Favourite 'gems' to bookmark folder\n- [ ] Basic stats\n- [ ] Categories\n  - [x] [awesome curated lists](https://github.com/sindresorhus/awesome)\n  - [ ] tech, science, software, startups, etc.\n- [x] Rabbit hole feature (stay on the same topic).\n- [x] Firefox support\n- [ ] Safari support\n\n**[→ Changelog](CHANGELOG.md)**\n\n\n### A note about permissions\nThis extension requires the `\u003call_urls\u003e` permission, in order to show the overlay UI on every stumble page that you visit. It does not access data on these sites. There is no tracking, or analytics of any kind, and state is only stored locally. \n\n### Credit to the curators ✔\nThis extension is made possible by awesome people curating the internet:\n- [sindresorhus/awesome](https://github.com/sindresorhus/awesome) and [all the awesome list authors](https://github.com/sindresorhus/awesome/graphs/contributors)\n\n### A note about the dataset\nIt's completely local - you can find it under [/extension/data](./extension/data). It's generated with [awesome_scraper.py](./scraper/awesome_scraper.py). \n\n##### Maintaining quality\nTo make sure that every link works and is relevant, the dataset is cleaned. Any dead or broken links are removed, as well as links to CI pipelines, recursive links, donation links, etc. This is done with the cleanup functions in [utils.py](./scraper/utils.py). Running this script can take a few hours on a slow connection.\n\n##### Broken links\nAfter removing from the dataset, a record of dead or broken links (those with 404, SSL, other server errors) is saved in [these text files](./extension/data/broken-urls) after every scrape. \n\n❗️If you are one of the awesome list maintainers, find the **[ text file for your awesome-list](./extension/data/broken-urls)** to check for dead links and remove them from your list, or update with a valid URL. If the file is empty, all good! \n\n#### Contribute\n\n[☝️Submit an issue](https://github.com/basharovV/StumbleUponAwesome/issues/new)\n[🤘Submit a PR](https://github.com/basharovV/StumbleUponAwesome/pulls)\n\n✨ Stay curious!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FbasharovV%2FStumbleUponAwesome","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FbasharovV%2FStumbleUponAwesome","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FbasharovV%2FStumbleUponAwesome/lists"}