Toggles - soulhotel/userChrome-Companion GitHub Wiki

How Toggling Options work

🛈 When an option is toggled ON (like: 🌀 an example option) , the options character (🌀) is added +1 to the Firefox Window Title. And any userChrome style(s) that apply to the character (🌀) will be applied to Firefox. Note: the toggled "character" can be anything from an emoji, to numbers, to plain text characters.

  • You can toggle an option on by double clicking it.
  • When an option is on you will see a visual ON indicator attached to it.
  • clicking the ON indicator can toggle the option off.

The Toggle userChrome Button

  • The Toggle userChrome Button at the top of the option's list has one task.
  • It looks for all options that are currently on, and turns them all off.
  • It remembers all options that were previously on, and turns them all on.
  • The Toggle All button in Preset Settings does the same thing.

🛈 This is all managed via a recently Toggled and currently Toggled list.

img or gif

Importing and Exporting Toggles

🛈 You can manually type in Toggle States to the Text Area then use Import Toggles to set/save them to your currently Toggled list. Importing/Exporting Toggles are carefully handled separately from importing/exporting Options. This is to limit potential errors.

  1. Import Toggles will prompt you, to Import from the Text Area or via a 📂 ... 🌐 (file or URL)
    • Text Area will read and parse the Text Area for options that should be toggled on (setting them on and saving the states)
    • 📂 ... 🌐 will prompt you, to import a file with toggle states or import a URL with toggle states (setting them on and saving the states)
  2. Export Toggles will prompt you to Export your currently Toggled Settings to the Text Area or via a 📂 File
    • to Text Area will paste your currently toggled settings to the Text Area for you to copy/paste
    • to a 📂 File will generate a .txt file with your currently toggled settings inside

Toggle Format

🛈 As long as you follow the format example below, you can successfully import/export and keep your Currently Toggled list clean and precise.

1️⃣ ON
2️⃣ ON
456 ON
~ ON
  1. Import Toggles - Assuming these are options all exist in your options list (the extension will double check), all of these options (1️⃣, 2️⃣, 456, ~) will be
    • toggled ON and your currently Toggled List & recently Toggled List will be set/saved.
  2. Export Toggles - Assuming these are options already in your currently Toggled List, all of these Toggle States will be exported
    • either to the Text Area (for you to copy/paste)
    • or to a file (.txt) for you to save/share
⚠️ **GitHub.com Fallback** ⚠️