DOCSEARCHbyAlgolia
Submit Docs

FF Ultima Documentation

website·Indexed 30 days ago

https://ff-ultima.github.io

Documentation for FF Ultima, a modular userChrome theme for Firefox. Includes guides on installation, uninstallation, and automation via git, as well as configuration for the URL bar, navbar, and Sidebery. Features detailed settings accessible via about:config (e.g., ultima.navbar.autohide, ultima.urlbar.float) and a variety of color schemes including Catppuccin Mocha, Gruvbox, and Kanagawa Wave.

Tokens
14.9K
Snippets
76
Records
152
Agent score
69%

What's inside FF Ultima

  1. Configure FF Ultima layout and spacing

    Use the following about:config keys to adjust the visual density and spacing of the FF Ultima theme:
    ultima.spacing.compact: Removes borders, reduces rounding, and slightly shrinks tabs.
ultima.spacing.relaxed: Increases spacing between browser content (recommended for Ultra-Wide displays or Side View extensions).
ultima.spacing.compact.menus: Makes the menu and extension panels more compact.
ultima.spacing.compact.addonmanager: Changes the Add-on Manager and Themes page to a compact grid layout.

  4. Configure FF Ultima color schemes and theming

    Manage theme colors and integration:

    • user.theme.sidebery: Enables automatic Sidebery theming based on the current Color Scheme.
    • ultima.xstyle.highlight.aboutconfig: Matches the about:config page colors to the active color scheme and removes the tab border.
    • user.theme.dark.midnight.animated: Enables the animated background specifically for the Midnight color scheme.

  5. Manage FF Ultima Color Schemes and Themes

    FF Ultima uses a Color Scheme system to apply colors to the browser. Users can switch between different schemes and backgrounds using the user.theme setting in about:config.
    // In about:config, search for and modify:
user.theme

  6. Locate the Firefox Profile Folder

    To install FF Ultima, you must place theme files in the chrome folder located within your Firefox Profile folder. You can find this folder using two methods:

    Method 1: via about:support

    1. Navigate to about:support in the address bar.
    2. Locate the 'Profile Folder' section and click 'Open Directory'.

    Method 2: via about:profiles

    1. Navigate to about:profiles in the address bar.
    2. Identify the active profile (typically named 'default-release').
    3. Click 'Open Directory'.

  7. Access and configure FF-Ultima theme settings

    Theme settings for FF-Ultima are managed through the browser's internal configuration page. To find and modify these settings, navigate to about:config and search for the prefix ultima or user.theme.

  8. Enable the FF ULTIMA Default Edition color scheme

    To apply the Default Edition color scheme by FF ULTIMA, you must modify the Firefox configuration settings via the about:config page. Locate the user.theme preference and enable the specific default theme toggle.
    1. Navigate to about:config
    2. Search for user.theme
    3. Set user.theme.0.default to true (Turn on)

  9. Enable the Fluent color scheme in FF ULTIMA

    To activate the Fluent color scheme (designed based on Microsoft's Fluent colors), navigate to the about:config page in the browser and set the following preference to true:

    • For the standard Fluent theme: user.theme.fluent
    • For the Thinkpad variant (replaces accent colors with red): user.theme.fluent.thinkpad

  10. Enable useful Firefox browser features via about:config

    The following general Firefox settings are recommended for use alongside FF Ultima:
    browser.tabs.groups.enabled: Enables tab grouping, categorization, and collapsing.
toolkit.tabbox.switchByScrolling: Allows switching tabs using the scroll wheel.
browser.newtabpage.activity-stream.newtabWallpapers.v2.enabled: Enables more custom New Tab Page wallpapers.
browser.tabs.hoverPreview.enabled: Enables image previews when hovering over tabs.
browser.newtabpage.activity-stream.improvesearch.handoffToAwesomebar: Disables the search bar on the New Tab Page.

  12. Understand the use of user.js for theme configuration

    FF Ultima uses a user.js approach to manage preferences via about:config. This allows users to toggle specific styles, layouts, and modular settings (e.g., autohiding the navbar or sidebar) without needing to manually edit CSS files or restart the browser for every change. This modularity ensures that different settings (like navbar.autohide vs sidebar.autohide) do not interfere with one another.