run-a-script

Download from Firefox Addons

A Firefox extension that allows you to define exactly one JS script and inject it into every web page you visit. It uses Firefox' userScripts feature which sandboxes JS code before execution. You should be safe from even the most malicious of actors out there. For at least some convenience, jQuery is injected as well and usable from your script. The code of the extension is deliberately minimal, you are encouraged to review it for security before running the extension. Please report all problems you find and share your snippets in the issues.

run-a-script is meant for people with trust issues. There are plenty of extensions out there that you could easily re-implement with a small JS snippet instead of installing. Also useful with uBlock Origin for defeating aggressive sites.

The plugin supports:

• sandboxed injection of 1 script + jQuery into all pages, you need to refresh the opened ones
• enabling / disabling the script

The plugin does NOT support:

• Android – but working on it
• Chrome – the whole idea of this extension is to be secure but that's irrelevant if your browser is a black box
• saving to and loading from a file – saving would be useful but currently not possible due to a Firefox bug

Example

Here's a simple script that does useful redirects:

console.log("The execution of the custom code is beginning.");

var url = document.URL;
var {
    host,
    protocol,
    pathname,
    search
} = new URL(url);

var redirects = {
    "www.google.com": "www.startpage.com",
    "www.youtube.com": "yewtu.be",
    "www.reddit.com": "old.reddit.com",
    "imgur.com": redirectToImgurMedia,
    "twitter.com": "nitter.net",
    "open.spotify.com": openSongWithInvidious,
    "yewtu.be": handleSpotifyRedirect
}

function redirectToImgurMedia() {
    console.log("Attempting to redirect to media...");
    $(document).ready(function() {
        var meta = $("meta[name='twitter:image']").first();
        if (meta.length > 0) {
            window.location.replace(meta.attr("content"));
        } else {
            console.log("Couldn't find the media link.");
        }
    });
}

function openSongWithInvidious() {
    if (pathname.startsWith("/track/")) {
        $(document).ready(function() {
            if ($("meta[property=og\\:type][content=music\\.song]").length) {
                console.log("Opening song in Invidious...");
                title = $("meta[property=og\\:title]").attr("content");
                artist = $("meta[property=og\\:description]").attr("content").replace(/ ·.*/, "");
                search_term = `${title} by ${artist}`;
                search_term = encodeURI(search_term.replaceAll(" ", "+"));
                window.location.replace(`https://yewtu.be/search/?q=${search_term}&from-spotify=1`);
            }
        });
    }
}

function handleSpotifyRedirect() {
    if (search.includes("from-spotify=1")) {
        console.log("Handling Spotify redirect...");
        $(document).ready(function() {
            href = $("div.pure-g a[href^=\\/watch\\?v\\=]:first").attr("href");
            window.location.replace(`https://yewtu.be${href}`);
        });
    }
}

var redirect = redirects[host];

if (redirect) {
    if (typeof redirect === "string") {
        window.location.replace(url.replace(
            `${protocol}//${host}`,
            `${protocol}//${redirect}`
        ));
    } else
        redirect();
}

console.log("The execution of the custom code is finishing.");

License

Copyright © 2022-present Mihail Ivanchev.

Distributed under the GNU General Public License, Version 3 (GNU GPLv3).

The doge icon was sourced from https://icon-library.com/icon/doge-icon-21.html and subsequently modified.

jQuery is distributed under its respective license.