{"id":17719161,"url":"https://github.com/claromes/socialswitch","last_synced_at":"2025-03-14T03:33:31.926Z","repository":{"id":182945078,"uuid":"669337822","full_name":"claromes/socialswitch","owner":"claromes","description":"Browser extension that redirects Instagram e TikTok URLs to anonymous viewers","archived":false,"fork":false,"pushed_at":"2024-05-12T23:06:17.000Z","size":2819,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-05-13T00:20:05.627Z","etag":null,"topics":["android","browser-extension","chrome-extension","firefox","firefox-addon","imginn","instagram","picuki","tiktok","urlebird","xaller"],"latest_commit_sha":null,"homepage":"","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/claromes.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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},"funding":{"github":["claromes"]}},"created_at":"2023-07-22T01:09:28.000Z","updated_at":"2024-05-13T00:20:19.340Z","dependencies_parsed_at":"2024-05-13T00:20:18.552Z","dependency_job_id":"46029ed6-6dd4-4153-97c8-1451f6e0980b","html_url":"https://github.com/claromes/socialswitch","commit_stats":null,"previous_names":["claromes/picukiswitch","claromes/socialswitch"],"tags_count":11,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/claromes%2Fsocialswitch","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/claromes%2Fsocialswitch/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/claromes%2Fsocialswitch/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/claromes%2Fsocialswitch/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/claromes","download_url":"https://codeload.github.com/claromes/socialswitch/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":221434248,"owners_count":16820401,"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":["android","browser-extension","chrome-extension","firefox","firefox-addon","imginn","instagram","picuki","tiktok","urlebird","xaller"],"created_at":"2024-10-25T15:00:25.503Z","updated_at":"2025-03-14T03:33:31.913Z","avatar_url":"https://github.com/claromes.png","language":"JavaScript","funding_links":["https://github.com/sponsors/claromes"],"categories":[],"sub_categories":[],"readme":"# ![Social Switch](chrome/icons/icon32.png 'Social Switch') Social Switch\n\n[![ZIP Files](https://github.com/claromes/socialswitch/actions/workflows/main.yml/badge.svg)](https://github.com/claromes/socialswitch/actions/workflows/main.yml) [![Mozilla Add-on Users](https://img.shields.io/amo/users/social-switch?label=mozilla%20add-on%20users)](https://addons.mozilla.org/en-US/firefox/addon/social-switch)\n[![Chrome Web Store Users](https://img.shields.io/chrome-web-store/users/elmbjjhgiifenlhffpjcjfkjmilbbfki?label=chrome%20web%20store%20users)](https://chrome.google.com/webstore/detail/social-switch/elmbjjhgiifenlhffpjcjfkjmilbbfki)\n\nRedirect Instagram and TikTok URLs to anonymous viewers. Access any profile, posts, tagged posts, stories profile or tags on Instagram or any profile on TikTok and the extension will redirect automatically to web viewers.\n\nFrom **Instagram** URLs to **Picuki.com** or **Imginn.com**, and from **TikTok** URLs to **UrleBird.com** or **Xaller.com**.\n\n## Note\n\nFor those seeking an alternative redirection for open-source instances, I recommend using the LibRedirect extension. The Social Switch extension aims to streamline access to web viewers that are more stable and facilitate the download of assets from both Instagram and TikTok. It targets users who prefer these anonymous but closed-source platforms.\n\nIt's necessary to add that despite being anonymous for accessing Instagram and TikTok, the web services Picuki, Imginn, UrleBird, and Xaller are commercial and may track users. For this reason, it is recommended to use these services with VPNs, ad blockers, and other methods to inhibit trackers.\n\nThis extension is not affiliated with Instagram, TikTok, Picuki, Imginn, UrleBird, and Xaller and does not take responsibility for any actions of these web services.\n\n## Installation\n\n- Firefox Add-ons\n\n  [![Get the add-on](assets/amo_badge.png 'Get the add-on')](https://addons.mozilla.org/en-US/firefox/addon/social-switch/)\n\n  [![Get the add-on for Android](assets/amo_android_badge.png 'Get the add-on for Android')](https://addons.mozilla.org/en-US/android/addon/social-switch/)\n\n- Chrome Web Store\n\n  [![Install from Chrome Web Store](assets/cws_badge.png 'Install from Chrome Web Store')](https://chrome.google.com/webstore/detail/social-switch/elmbjjhgiifenlhffpjcjfkjmilbbfki)\n\n- From the ZIP File\n\n  - **Firefox for Desktop**\n\n    - Download the latest version of the [socialswitch-firefox.xpi](https://github.com/claromes/socialswitch/releases) file\n    - Open Firefox and navigate to `about:addons`\n    - From the settings cog, press \"Install Add-on From File...\" (located at the top-right corner)\n    - Select the extension file\n\n  - **Chrome**\n\n    - Download the latest version of the [socialswitch-chrome.zip](https://github.com/claromes/socialswitch/releases) file\n    - Extract the ZIP file\n    - Open Google Chrome and navigate to `chrome://extensions`\n    - Enable \"Developer Mode\" (located at the top-right corner)\n    - Click on the \"Load Unpacked\" button (located at the top-left corner)\n    - Navigate to the directory where you extracted the ZIP file containing the extension\n    - Select the extension folder\n\n## Usage\n\nSelect a viewer option and enable or disable redirection through the popup.\n\n![Social Switch Popup](assets/popup.jpg 'Social Switch Popup')\n\nFor Instagram post URLs (`instagram.com/p/short_code`) and Instagram stories profile URLs (`instagram.com/stories/handle`), regardless of the redirection option, the extension will redirect to Imginn.com. This viewer uses the original post short code, and it has the option to view only stories via URL. However, for tag URLs (`instagram.com/explore/tags/tag_name`), irrespective of the redirection option, the extension will redirect to Picuki.com, as only this viewer supports tag search.\n\n### Supported URLs\n\n- Instagram:\n\n  `instagram.com/handle`\n\n  `instagram.com/handle/tagged`\n\n  `instagram.com/stories/handle` _(only Imginn)_\n\n  `instagram.com/p/short_code` _(only Imginn)_\n\n  `instagram.com/handle/p/short_code` _(only Imginn)_\n\n  `instagram.com/reel/short_code` _(only Imginn)_\n\n  `instagram.com/handle/reel/short_code` _(only Imginn)_\n\n  `instagram.com/explore/tags/tag_name` _(only Picuki)_\n\n- TikTok:\n\n  `tiktok.com/@handle`\n\n## Development\n\n### Requirement\n\nNode.js 20 or higher\n\n$ `git clone git@github.com:claromes/socialswitch.git`\n\n$ `cd socialswitch`\n\n$ `npm install`\n\n### Common files\n\nThe files for each browser are in their respective directories. The files for **Google Chrome** are all in the `chrome` directory, and some are shared with **Firefox**.\n\nThe common files between **Google Chrome** and **Firefox** are in the `chrome` directory and consist of `chrome/popup.html`, `chrome/support.html`, and the `chrome/icons` directory.\n\n### Firefox for Android\n\n[Set up your computer and Android emulator or device](https://extensionworkshop.com/documentation/develop/developing-extensions-for-firefox-for-android/).\n\nThen, run:\n\n$ `cd firefox`\n\n$ `web-ext run -t firefox-android --adb-device \u003cCODE\u003e --firefox-apk org.mozilla.fenix`\n\n### Testing with Puppeteer\n\nTo test each group of URLs (Instagram profile, tagged, stories, post and tag, and TikTok profile), it's necessary to pass the group and the browser as options when running the script. This applies only to Firefox for Desktop and Google Chrome.\n\nThe groups are: `ig_profile`, `ig_tagged`, `ig_post`, `ig_stories`, `ig_tags`, and `tt_profile`.\n\nThe browsers are: `chrome`, and `firefox`.\n\nRun the test with the desired group:\n\n$ `npm test [group] [browser]`\n\n#### Example\n\nTo test Instagram profile URLs on Firefox, run the command `npm test ig_profile firefox`.\n\n## Roadmap\n\n- [x] Tags URL\n- [x] Post URLs\n- [ ] TikTok options\n  - [x] User\n  - [ ] Video\n- [x] Firefox extension\n\n## Contributing\n\nYou're welcome to contribute, whether it's through bug reporting, feature suggestions, or code contributions.\n\n## Credits\n\n- [Claromes](https://claromes.com), author and maintainer\n- [MagicPattern](https://unsplash.com/@magicpattern), background image of the [promotional assets](assets)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fclaromes%2Fsocialswitch","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fclaromes%2Fsocialswitch","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fclaromes%2Fsocialswitch/lists"}