https://github.com/openstyles/stylus

Stylus - Userstyles Manager
https://github.com/openstyles/stylus

chrome-extension firefox-extension opera-addon privacy stylish usercss userstyles

Last synced: about 2 months ago
JSON representation

Stylus - Userstyles Manager

• Host: GitHub
• URL: https://github.com/openstyles/stylus
• Owner: openstyles
• License: gpl-3.0
• Created: 2017-01-08T08:35:15.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2025-04-05T13:05:47.000Z (about 1 year ago)
• Last Synced: 2025-04-09T19:05:15.451Z (about 1 year ago)
• Topics: chrome-extension, firefox-extension, opera-addon, privacy, stylish, usercss, userstyles
• Language: JavaScript
• Homepage: https://add0n.com/stylus.html
• Size: 20.3 MB
• Stars: 5,782
• Watchers: 94
• Forks: 315
• Open Issues: 96
• Metadata Files:
  • Readme: README.md
  • Contributing: .github/CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-useful-projects - <img src="https://icon.horse/icon/github.com" height="20px" align="center"/>/openstyles/stylus - Userstyles manager (Browser Extensions/Scripts/Tools / Other)
• awesome-starred-test - openstyles/stylus - Stylus - Userstyles Manager (JavaScript)
• awesome-rainmana - openstyles/stylus - Stylus - Userstyles Manager (JavaScript)
• Awesome - Stylus - 定制网页 CSS (Chrome / 插件)
• jimsghstars - openstyles/stylus - Stylus - Userstyles Manager (JavaScript)

README

          
Stylus is a browser extension to restyle the websites via CSS themes, compatible with Chrome, Firefox, and any Chromium-based browsers.

## Highlights

* No analytics/tracking - this is our foundational principle as Stylus was created solely because the original Stylish extension was sold to a Web analytics company.

* Lots of themes in external galleries like [USW](https://userstyles.world/explore), [USO archive](https://uso.kkx.one/browse/categories), [greasyfork](https://greasyfork.org/en/scripts/by-site/*?language=css):

  * click the `Find` button in the popup UI,

  * click the screenshot to apply the style to the website,

  * click the screenshot again to uninstall the style.

* [UserCSS](https://github.com/openstyles/stylus/wiki/Usercss) styles with advanced customization installable from any raw plain text URL.

* Cloud sync for Dropbox, GDrive, OneDrive, or any WebDAV-compatible server.

* Backup to a JSON file compatible with other userstyles managers.

* Auto-update for styles, configurable in each style and globally in the options.

* Lightweight content script (~10kB) in the web pages runs in about a millisecond.

* Lots of options to configure UI and behavior.

* Built-in editor for your own CSS themes (CSS/LESS/Stylus) that highlights problems using up-to-date linters ([Stylelint](https://stylelint.io/) and [CSSLint-mod](https://github.com/openstyles/csslint-mod)) with customizable rules.

* Support for external IDE or advanced editor via the [live reload feature](https://github.com/openstyles/stylus/wiki/Writing-UserCSS#live-reload-on-the-fly-previewingwhen-developing-styles-locally-in-another-editoride) e.g. you can write SASS/SCSS by setting up a build step to produce standard CSS in a separate file that will be tracked by Stylus.

## Screenshots

* Manager

   ![Style manager](.github/screenshots/manager.png)

* Installer

  ![Installer](.github/screenshots/installer.png)

* Editor

  ![Style editor](.github/screenshots/editor.png)

* Popup search

  ![Popup inline search](.github/screenshots/popup-search.png)

* Popup config

  ![Popup config for usercss](.github/screenshots/popup-config.png)

* Manager config

  ![Style manager config for usercss](.github/screenshots/manager-config.png)

* Options

  ![Options](.github/screenshots/options.png)

## Releases

1. [Chrome Web Store](https://chromewebstore.google.com/detail/stylus/clngdbkpkpeebahjckkjfobafhncgmne) or [beta](https://chromewebstore.google.com/detail/stylus-beta/apmmpaebfobifelkijhaljbmpcgbjbdo)
for modern Chrome (v128+) and Chromium-based browsers like Brave, Opera, Vivaldi.

2. [Mozilla addons](https://addons.mozilla.org/firefox/addon/styl-us/) or [beta](https://github.com/openstyles/stylus/releases) (as an xpi file)
for Firefox and any Gecko-based browser.

3. [Zip file](https://github.com/openstyles/stylus/releases) with `-mv2` suffix to _load as an unpacked extension_
for older Chromium-based browsers which only support ManifestV2 version.

## Pre-release test builds (nightlies) [![badge](https://github.com/openstyles/stylus/actions/workflows/ci.yml/badge.svg)](https://github.com/openstyles/stylus/actions/workflows/ci.yml)

1. click a workflow entry in https://github.com/openstyles/stylus/actions/workflows/ci.yml,

2. download the file in `Artifacts` - this requires a github.com account,

3. install it, see [the instruction](https://github.com/openstyles/stylus/wiki/Install-Stylus-from-GitHub).

## Asking questions, participating, contributing

* Bugs, discussions, questions, ideas, pull requests: https://github.com/openstyles/stylus

* Wiki for many common tasks and questions: https://github.com/openstyles/stylus/wiki

* Discord: https://discordapp.com/widget?id=379521691774353408 ![Discord](https://img.shields.io/discord/379521691774353408.svg)

* Helping with translation: https://explore.transifex.com/github-7/Stylus/

* Guidelines and more info: https://github.com/openstyles/stylus/CONTRIBUTING.md

## License: [GPLv3](./LICENSE)

* Copyright © 2017-2025 [Stylus Team](https://github.com/openstyles/stylus/graphs/contributors)

* Copyright © 2005-2014 [Jason Barnabe](jason.barnabe@gmail.com) for the ever diminishing parts of the original [Stylish](https://github.com/stylish-userstyles/stylish/).

* Licenses of modified external libraries: [vendor-overwrites](./src/vendor-overwrites).