Skip to content
Damian edited this page May 18, 2021 · 1 revision

Table of Contents



Contact, feedback and support

To contact me please send me an e-mail or write a message on WhatsApp If you are a GitHub user you can open a new issue for bug reports and feature requests.

What is UserCSS?

As it is written on Stylus’ UserCSS wiki page

UserCSS is essentially a CSS stylesheet with some extra data added to the beginning. We add a .user.css / .user.styl extension so you know it’s different. So what’s all the hype about it?
  • Self-hosting: UserCSS styles help to preserve your privacy. A UserCSS style can be hosted and installed from anywhere, even your own drive. That way you can prevent userstyle repository web sites tracking you. We emphasize can preserve as it is dependent on where the UserCSS is hosted.
  • User-customizable variables: These style settings (including colorpicker) can be live-switched, are maintained during updates and can be set back to defaults separately.
  • Preprocessor: Besides standard CSS, these preprocessors are supported: LESS, Stylus-lang and the USo-format. Furthermore you can utilize whatever you want by using live-reload and your own external editor

How to install the UserCSS?

See installation page.

How to set own image as the app background?

First, you have to upload your image on the web. For this, you may use any free image hosting service eg Imgur.

Second, copy the image link and paste it into the Bgr image field. Remember to wrap the link in single ' or double " quotes.

Notice: Image link has to end in .jpg or .png

See also configuration page - bgr image and configuration page - additional background.

Why only the default preset is full configurable?

Because other presets overwrite some options values.

You can easily get the same effect manually, just select default preset and set up the same options values as described in configuration page - presets settings section.

Why the CSS code does not use class selectors?

Because the WhatsApp CSS classes are dynamically generated and changed themselves every new app version. Use tag and id selectors give more universality.