base on All-in-one browser extension for Scratch. # <img src="images/icon.svg" alt="Scratch Addons logo" align="right" width="128px"></img>Scratch Addons [](https://chrome.google.com/webstore/detail/fbeffbjdlemaoicjdapfpikkikjoneco) [](https://addons.mozilla.org/firefox/addon/scratch-messaging-extension/) [](https://chrome.google.com/webstore/detail/fbeffbjdlemaoicjdapfpikkikjoneco) [](https://addons.mozilla.org/firefox/addon/scratch-messaging-extension/) [](https://microsoftedge.microsoft.com/addons/detail/scratch-addons/iliepgjnemckemgnledoipfiilhajdjj) [](https://github.com/ScratchAddons/ScratchAddons/releases) [](https://github.com/ScratchAddons/ScratchAddons/blob/master/LICENSE) [](https://discord.gg/R5NBqwMjNc) [](https://scratchaddons.com) [](https://scratchaddons.com/usercount.json) ## About Scratch Addons combines new and existing features and themes for the [Scratch](https://scratch.mit.edu) website and project editor into one easy-to-access and configurable browser extension. The mission is to provide a centralized, up-to-date platform for community development of new features and themes for Scratch. <div align="center">  </div> ### About addons An addon mainly consists of one or more [userscripts](https://scratchaddons.com/docs/develop/userscripts/) (written in JavaScript) or [userstyles](https://scratchaddons.com/docs/develop/userstyles/) (written in CSS) that run on the Scratch website or project editor. Each addon declares its own [addon manifest](https://scratchaddons.com/docs/reference/addon-manifest/) (`addon.json` file). This file specifies under which circumstances each one of its userscripts and userstyles should be injected into the page. It also contains user-facing information, such as the description of the feature, and information about the addon's settings. Userscripts work similarly to [extension content scripts](https://developer.chrome.com/docs/extensions/develop/concepts/content-scripts) running in the "main world" (the unprivileged context where `chrome.*` extension APIs are not available). Userscripts have access to `addon.*` APIs. They can use these built-in utilities for various purposes: waiting until a certain element exists on the page, listening to settings change events, getting a reference to the Scratch VM object, etc. Addons are designed to be compatible with each other. They are also developed with performance, internationalization, accessibility, and privacy in mind. Read the [documentation](https://scratchaddons.com/docs/develop/getting-started/addon-basics/) for more information about addons. ### About the extension The Scratch Addons browser extension provides a settings page where users can enable, disable and configure addons. The extension interprets addon manifests, stores the user's settings, and provides APIs to userscripts. A new version of the extension is released to the stores regularly with new addons and features. ### Addons beyond the Scratch Addons browser extension Other open-source projects (such as Scratch forks) can also make use of the addons. For example, the [TurboWarp](https://github.com/TurboWarp/scratch-gui/tree/develop/src/addons) and [Adacraft](https://gitlab.com/adacraft/scratch-mod/scratch-gui/-/tree/adacraft/main/src/addons) project editors allow you to use most of the editor addons without installing browser extensions, and even while offline ([TurboWarp Desktop](https://desktop.turbowarp.org/)). ### File structure #### Addons - `addons-l10n`: Translation for addon strings (one file per addon). - `addon-api`: Implementation of the `addon.*` JavaScript APIs. - `addons`: Each addon has its own directory, which must include an addon manifest file named `addon.json`. - `libraries`: Third-party libraries and other utilities, some of which are used by addons. #### Others - `.github`: GitHub templates, workflows, and contributing files. - `_locales`: Translation strings for the browser extension (excluding addons). - `background`: Background scripts for the extension. - `content-scripts`: Content scripts, which among other things, execute userscripts and inject userstyles to the page. - `images`: Logos, screenshots and icons (excluding addon-specific images). - `popups`: Addon pages that are only accessible through the extension popup (for example, Scratch Messaging). - `webpages`: The settings page, extension popup, and other pages. ## Installation No building is required. The best way to download the source is with Git: ```sh git clone https://github.com/ScratchAddons/ScratchAddons.git ``` For browser support information and other installation methods, check [the documentation](https://scratchaddons.com/docs/getting-started/installing). ### Loading the extension (Chrome) To load the extension into most Chromium-based browsers, go to `chrome://extensions`, turn on developer mode, click "Load unpacked", and select the `ScratchAddons` folder. ### Loading the extension (Firefox) Go to `about:debugging`, select "This Firefox", click "Load Temporary Add-on...", and select the `manifest.json` file in the `ScratchAddons` folder. > [!NOTE] > Firefox extensions loaded this way are removed when the browser is closed. ## Contributing ### Suggestions and bug reports If you found a bug or have a suggestion [create an issue](https://github.com/ScratchAddons/ScratchAddons/issues/new/choose) after checking for duplicates. Alternatively, you can use our [feedback page](https://scratchaddons.com/feedback) instead. If you found a security vulnerability, please follow the instructions in our [Security Policy](https://github.com/ScratchAddons/ScratchAddons/tree/master/.github/SECURITY.md) instead. ### Code Before contributing code, please read our [contributing guidelines](https://github.com/ScratchAddons/ScratchAddons/blob/master/.github/CONTRIBUTING.md). We recommend using Visual Studio Code as the code editor. ### Translations Translations are handled by [Transifex](https://www.transifex.com/). If you are interested in translating the extension, read [Joining the Localization Team](https://scratchaddons.com/docs/localization/joining-the-localization-team/). ### Documentation The Scratch Addons Docs are available at https://scratchaddons.com/docs/. Most of the documentation is located in [website-v2](https://github.com/ScratchAddons/website-v2) (repository of the [ScratchAddons.com](https://scratchaddons.com) website) in the [/content/docs](https://github.com/ScratchAddons/website-v2/tree/master/content/docs) directory. ## License Scratch Addons is licensed under the terms of the [GNU General Public License v3.0](https://github.com/ScratchAddons/ScratchAddons/blob/master/LICENSE). Other third-party libraries used are listed on [/libraries/README.md](https://github.com/ScratchAddons/ScratchAddons/tree/master/libraries#readme). ", Assign "at most 3 tags" to the expected json: {"id":"7981","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"