FF ULTIMA...
. . . A theme with too many options. And a sequel to FF Perfection CSS.
![GitHub Release](https://img.shields.io/github/v/release/soulhotel/FF-CSS-ULTIMA?style=for-the-badge) ![GitHub Downloads (all assets, all releases)](https://img.shields.io/github/downloads/soulhotel/ff-ultima/total?style=for-the-badge&color=blue) ![GitHub Repo stars](https://img.shields.io/github/stars/soulhotel/FF-CSS-ULTIMA?style=for-the-badge) ![GitHub contributors](https://img.shields.io/github/contributors/soulhotel/FF-ULTIMA?style=for-the-badge&color=blue)
Features
- Windows, Linux and Mac OS Support.
Vertical Tabs
and a One Line Nav Bar
.
- Add-on theme support, FF ULTIMA can be used with Firefox add-on themes.
- Color Scheme support, choose from the many options or learn how to create your own.
- Dark or Light mode themes, automatically cycle depending on your systems current Color Mode.
- Multiple Options for Tabs, autohiding, spacing, accessibility and more, toggleable on the about:config page
- See more detail on what FF Ultima has to offer through the Wiki.
Installation
🚨 Do not skip the installation instructions! Firefox v131+ Required. 🚨
Need help finding your Profile Folder? (Click Me)
> userChrome Themes work by communicating with a chrome folder located in your Firefox Profile folder, think of it as your User Interface. This folder typically holds `.css` files with the purpose of customizing elements of the Browser. There are two easy ways to access this folder:
1. Go to the `about:support` page
- In the URL Bar, type `about:support`.
- Look for the **Profile Folder** row. Open the folder.
- In that folder, create a new folder named `chrome` (If it doesnt already exist).
![aboutsupport](theme/pic/assets/about_support.png)
2. Go to the `about:profiles` page
- In the URL Bar, type `about:profiles`.
- Your profile will say `This is the profile in use and...`.
- Look for the **Root Directory** row, and click **Open Directory**.
- In the opened Folder, create a new folder named `chrome` (if it doesnt already exist).
![alt text](theme/pic/assets/profilelocation.png)
Have system theme enabled for first install, not firefox dark/light. (Click Me)
![addonthemespage](theme/pic/assets/installprep.png)
⬇️ Choose one of the installation methods below. ⬇️
The Easy Way
>
1. Download the latest version on the [release page](https://github.com/soulhotel/FF-CSS-ULTIMA/releases/latest).
2. Copy everything in the ffultima(version).zip into your chrome folder.
3. For first time installation, you will need to apply the `user.js` to your profile to access theme settings.
4. In the chrome folder, youll see the `user.js`, move it out the chrome folder and into the Profile Folder.
5. Restart Firefox.
6. **Wait** for Firefox to open, then delete the `user.js` file.
7. Go to `about:config` and search for `ultima` to see all of your settings.
###### :warning: You only need to touch the user.js when installing the theme for the first time. It's function is to enable userChrome and add theme settings to the about:config page. Do not copy the user.js file into the Profile Folder if you are just updating the theme to a new version. Unless you want all of your saved settings to be reset :).
The Hard Way
>
###### This method involves using Git and the Terminal - allowing easier updates. Harder for the less technical of people.
1. Open a terminal in your Profiles `chrome` folder.
2. Or in the terminal, navigate to your Profiles chrome folder `cd your\profile-folder\chrome`.
3. In the terminal, git clone the repo to install/update to the latest version:
```
# cd your/profile-folder/chrome # cd into profile folder
git clone https://github.com/soulhotel/FF-ULTIMA.git # git clone inside
mv FF-ULTIMA/* FF-ULTIMA/.* . # clean up double folder
rmdir FF-ULTIMA # remove the extra folder
```
5. In your chrome folder you'll have a file named `user.js`.
6. Move the `user.js` file OUT of the chrome folder and INTO your Profile Folder.
7. Restart Firefox.
8. **Wait** for Firefox to open, then delete the `user.js` file.
9. Go to `about:config` and search for `ultima` to see all of your settings.
###### :warning: You only need to touch the user.js when installing the theme for the first time. It's function is to enable userChrome and add theme settings to the about:config page. Do not copy the user.js file into the Profile Folder if you are just updating the theme to a new version. Unless you want all of your saved settings to be reset :).
###### :accessibility: Reading the [release page](https://github.com/soulhotel/FF-CSS-ULTIMA/releases/latest) is always recommended. When new versions of the theme come out - and they include new preferences in the about:config page, you may want to open the new user.js file and compare it to your current settings. You can either add the settings manually in the about:config page... or load your own editted user.js file to add the new settings and keep your old the same way.
Documentation
Wiki
- FAQ
- Theme settings overview
- Sidebery config
- List of Color schemes
- Color scheme creation
- Spreadsheets
Enjoy