Scripts

A collection of userscripts and userstyles for customizing and improving the web.

  

About Scripts

Scripts is an open wiki for userscripts and userstyles built on top of Git.

• Open & Transparent: Every script and style is checked prior to inclusion and open for public review.
• Community-Driven: Anyone can contribute bug fixes, new features, website updates, or metadata improvements.
• Collaborative Ownership: The original author creates the initial implementation, but scripts and styles are maintained and improved collectively over time.

Repository Structure

Each script or style lives in its own folder under scripts/:

scripts/<name>/<name>.user.js
scripts/<name>/<name>.user.css
scripts/<name>/*.png | *.jpg | *.jpeg | *.webp | *.gif | *.avif

The file must be named after the folder. Any images in the same folder are detected automatically and shown as screenshots (the first one on the card, all of them on the detail page).

Every script or style gets a detail page at /<name>. Names that collide with site routes (about, saved, search, scripts) are rejected by the build.

Files placed directly inside the scripts/ root are ignored by the build system.

Installation

1. Install a userscript manager such as Tampermonkey or Violentmonkey for scripts, and Stylus for styles.
2. Browse the website and click Install on the script or style you want.
3. Review the source code in your extension before accepting it.

Publishing a Script or Style

Add your file in its own folder:

scripts/<name>/<name>.user.js
scripts/<name>/<name>.user.css

Userscripts must point the metadata header to the raw file:

// @updateURL    https://raw.githubusercontent.com/<repo>/main/scripts/<name>/<name>.user.js
// @downloadURL  https://raw.githubusercontent.com/<repo>/main/scripts/<name>/<name>.user.js

Userstyles use a /* ==UserStyle== ... ==/UserStyle== */ header and @-moz-document rules, and are installed with Stylus:

/* ==UserStyle==
@name         Example Style
@author       Scripts
@namespace    https://github.com/<repo>
@version      1.0.0
@description  What the style changes.
@updateURL    https://raw.githubusercontent.com/<repo>/main/scripts/<name>/<name>.user.css
@downloadURL  https://raw.githubusercontent.com/<repo>/main/scripts/<name>/<name>.user.css
==/UserStyle== */

Metadata should accurately describe the behavior of the script or style and, for scripts, the requested permissions.

Improving Existing Scripts & Styles

You can propose changes to any existing script or style:

1. Fork the repository.
2. Make your changes.
3. Open a Pull Request explaining your changes.

Bug fixes, compatibility updates, refactoring, and metadata improvements are all welcome.

Localization & Pages

Translations and page content are structured by language code:

language/
  en/
    general.json
    about.html
    404.html
  tr/
    general.json
    about.html
    404.html

en serves as the primary source language and fallback.

Custom pages can be added under language/en/<name>.html. They are automatically rendered at /<name> and added to the sitemap.

Supported dynamic placeholders:

• {repo_url}
• {owner}
• {owner_url}

Custom page HTML rejects:

• <script> elements
• <iframe> elements
• Inline event attributes
• javascript: URIs

Code Quality & Safety

Every script and style contribution and update goes through a pull request review.

Users and maintainers can inspect source code and, for scripts, network requests and requested permissions at any time.

If you find a bug, broken functionality, or an unnecessary permission request, open an issue or submit a pull request with a fix.

License

This project is licensed under the GNU General Public License v3.0 (GPL-3.0).