Skip to content

soulhotel/git-userChrome

Repository files navigation

Git userChrome..

...A cross-platform tool to git userChrome themes from anywhere.

prev3

Note

As of August 16, 2025. gituserChrome is available as both a standalone script or a GUI

Overview

gituserChrome automates the installation of userChrome themes in several ways. It handles downloading Themes, saving them, and managing them between Profiles, Firefoxs (Firefox variants, Librewolf, Zen, Floorp), and Operating Systems. Both the script and app can work with github, codeberg, etc, backups of existing chrome, user.js and restarts. And all of this can be done with just one command (or click). The full configuration process is safe and smart (see the order of operations below). The original script is also well tested & vetted through users of my FF Ultima theme. You can find usage for the script below, or for the application, there's a version for each platform on the Releases Page ➜

Scripts

The automation script does not need to be downloaded (but they can be). You can simply run the first command for your operating system. And the script will assist you in automating the installation of any userChrome theme. In these examples below, I fetch the script globally, then add the link to the userChrome theme: "gituserChrome github.com/someones/theme.git".

LINUX & MAC (BASH)
bash <(curl -s https://raw.githubusercontent.com/soulhotel/git-userChrome/main/scripts/gituserChrome.sh) https://github.com/soulhotel/ff-ultima.git
./gituserChrome.sh https://github.com/soulhotel/ff-ultima.git
WINDOWS (POWERSHELL)
powershell -NoProfile -ExecutionPolicy Bypass -Command "irm 'https://raw.githubusercontent.com/soulhotel/git-userChrome/main/scripts/gituserChrome.ps1' | iex; Invoke-gituserChrome -gitTheme 'https://github.com/soulhotel/ff-ultima.git'"
.\gituserChrome.ps1 -gitTheme "https://github.com/soulhotel/ff-ultima.git"
NEED GIT? (SOURCE BELOW)
sudo pacman -S git                        # ARCH
sudo apt install git                      # DEBIAN/UBUNTU
xcode-select --install && git --version   # MAC
https://gitforwindows.org/                # WINDOWS
SCRIPT OPERATIONS

The standalone script fully automates the installation process by:

  • Finding the Profile Folder(s).
  • Backing up any existing chrome folder into chrome-datetime.
  • Downloading the CSS Theme into chrome/
  • Properly handle weird formats like chrome/chrome (double folders) from the downloaded theme.
  • Applying user.js if applicable.
  • Restarting Firefox.
  • Cleaning up user.is if applicable.

Note: The application expands on this experience with the ability to specify firefox binaries, profile locations, and such.

Previews

Script Previews: The full script operation put on youtube for better quality (windows, linux, mac)
App Previews: For Windows 11, Arch Linux (kde), Mac Sonoma (VM), Windows 10
Screenshot_20250815_212950

1 2

b image