Scratch Addons Time Machine

Relive old Scratch Addons.

An image showing the settings page on version 1.3.1 in Scratch Addons Time Machine

About

Scratch Addons Time Machine is a ported collection of UI from past major versions of the Scratch Addons browser extension. Using Time Machine, you can interact with nostalgic emulations of the popups and settings pages.

The plugins, called "addons", offered by Scratch Addons, are not functional in Time Machine, but you can still browse them.

Time Machine includes the following versions of Scratch Addons:

• 1.0.0
• 1.1.1
• 1.2.1
• 1.3.1

Usage

Scratch Addons Time Machine is a browser extension and is currently only available in source code form. Once downloaded, you can install it using developer mode in your browser's Extensions menu.

Motivation

Scratch Addons versions prior to 1.38.0 ran on Manifest V2, which lost support from major browsers in 2025. By bringing parts of these versions to a new Manifest V3 extension, Time Machine archives the classic UI, which got Scratch Addons to where it was today, for new audiences.

For developers

Technical overview

Scratch Addons Time Machine's source code contains addon data and settings page files organized by version number.

When the user selects a version using the settings page or popup containers, the first thing that happens is the version's corresponding addon files are retrieved using a version control system. The database is stored in /addons alongside a changes.json file. Events from the change list are processed up to the selected version, and the entries are used to load the latest revision of each addon manifest that still exists.

Next, an embed of the corresponding webpage is loaded. It receives the data resulting from the process described above so it can display the addons from the same version.

Here's where some of these processes are located:

• /ui/settings-pages.html — Loads the embeds of settings pages
• /ui/popup-pages.html — Loads the embeds of popup pages
• /ui/services/get-addons.js — Finds the appropriate versions of each addon, and processes the data for use by the webpage embed
• /libraries/time-machine/page-wrapper.js — Compatibility layers that help the webpage embed work properly in a foreign browser extension

Adding versions

The general steps to add a version of Scratch Addons' webpages and addon collection to Time Machine are as follows:

0. Ensure that the latest version added to Time Machine has a complete list of changes, as you'll have to use them during comparison.

In other words, you should complete all these steps before repeating the process to add another version.

1. Note which release version of Scratch Addons you want to add, and check out its tag.

Open a clone of Scratch Addons in your terminal, then use this command:

git checkout <tag_name>

2. Collect the cumulative changes between your chosen version and the previous version listed in Time Machine.

Use this command in Scratch Addons after checkout:

git diff --name-status <previous_tag_name> HEAD

3. Append a change list to /addons/changes.json including any addon manifests that were added, updated, or removed, based on the list from step 3.

Ignore changes to userscripts, userstyles, customCssVariables, persistentScripts, dynamicEnable, dynamicDisable, or similar properties, as they don't have an effect on the content in the settings page.

The entry should look like this:

{
  "version": "<version_number>",
  "added": { ... },
  "modified": { ... },
  "removed": { ... }
}

4. Copy any addon manifests that were added or modified from Scratch Addons into Time Machine in a new directory, /addons/<version_number>.

Remember, unlike Scratch Addons, which stores manifests in /addons/<addon_id>/addon.json, Time Machine looks for them in /addons/<version_number>/<addon_id>.json.

5. Copy the contents of the popup and settings page from your chosen version of Scratch Addons into Time Machine in /pages/<version_number>.

This is also where the popup tabs go.

You can use the /images and /libraries directories to store images and code shared by multiple page versions. Don't forget to check the URLs in the pages, updating each one to point to the appropriate resource in Time Machine.

6. Add the new version to the version selector in both /ui/settings-pages.html and /ui/popup-pages.html.

Newer versions go at the top.

7. Use Time Machine to make sure everything is working.

Simply save your changes and check the new version in the extension's settings page and popup containers.

Licenses

Scratch Addons Time Machine is available under GNU General Public License v3 terms. Licenses for included software libraries can be found in the /licenses directory.