-
Notifications
You must be signed in to change notification settings - Fork 2
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge branch 'bottom-window-control-buttons' into bottom-window-contr…
…ol-buttons-dev3
- Loading branch information
Showing
3 changed files
with
7 additions
and
173 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,179 +1,14 @@ | ||
# About | ||
|
||
My tailor-fitted, highly customized, and advanced [Firefox](https://www.mozilla.org/en-US/firefox) configuration. | ||
This branch adds window control buttons at the bottom. | ||
|
||
> [!NOTE] | ||
> This repository is not meant to be used as a whole but rather as a reference for my own configuration. I do not recommend using it as is, as it is not meant to be used by anyone else. I do not provide any support for this repository. If you want to use it, you are on your own. | ||
> | ||
> Firefox occasionally changes its codebase, which may break some of the configurations on newer versions of Firefox. I try to keep this repository updated, but I cannot guarantee that everything will work as expected. To deal with it yourself, refer to the [Customizing Firefox](#customizing-firefox) section. | ||
> | ||
> For other experimental features, check out the other branches of this repository. | ||
![Window Control Buttons](misc/screenshots/window-control-buttons.png) | ||
|
||
> [!TIP] | ||
> Disable Telemetry and Data Collection: Ensure that all telemetry and data collection features are turned off in Firefox. You can use my `user.js` as a reference, and explore other `user.js` files and hardened Firefox configurations for additional security. | ||
> | ||
> Cookie Management: With cookie isolation enabled, clearing cookies may be less effective. Instead, consider using temporary containers for better privacy. | ||
> | ||
> Customizing Firefox: For detailed guidance on customizing Firefox to suit your needs, refer to the [Customizing Firefox](#customizing-firefox) section. | ||
> | ||
> JPEG XL (JXL): Firefox 128 now supports JPEG XL images. You can use the [JPEG XL](https://jpeg.org/jpegxl/) format for images to save bandwidth and improve loading times. It is available as `image.jxl.enabled` in `about:config` preference. You can enable it by setting it to `true`. Note that it is currently an experimental feature in Firefox 128+. | ||
> [!WARNING] | ||
> It's currently experimental and may not work as expected. Please report any issues you find. | ||
## Features | ||
## Credits | ||
|
||
- Smooth scrolling | ||
- Animations | ||
- Sidebar (Sidebery) with auto-hide mechanism | ||
- Hovercards | ||
- Scrollable through tabs | ||
- Search bar for tabs in the sidebar | ||
- Custom toolbar button icons | ||
- Custom (bouncing) loading indicator animation | ||
- Only icons in extensions menu | ||
- Icons in main menu items | ||
- Round UI items | ||
- Dark UI in pages (e.g., addons.mozilla.org) | ||
- Custom centered status panel at the top with animations | ||
- Compact about:config list | ||
- Compact items and menus (e.g., context menu) | ||
- Various sidebar (Sidebery, Tree Style Tab) tweaks, including auto-hide | ||
- Animations in tabs that's playing audio | ||
- Consistent and matching colors across various elements and the UI | ||
- Glow and scale effect on hover on toolbar buttons | ||
- Findbar as floating box at the top | ||
- Hidden horizontal tab bar | ||
- Bottom main toolbar and search/url bar | ||
- Hidden bookmarks toolbar visible on hover | ||
- Custom colors on various items | ||
- Centered text in the url bar | ||
- Colored overlay on the url bar based on the type of connection | ||
- RGB animation on the url bar address | ||
- Global font family and size | ||
- Other various fixes and tweaks | ||
- Custom addons configuration | ||
- Various Context menu tweaks (e.g no separators, compact, custom colors & icons, rounded borders) | ||
- Userscripts | ||
- Userstyles | ||
- Custom theme | ||
- Icons in menus (appmenu, context menu, main menu, etc.) | ||
- Various performance and privacy tweaks | ||
- JPEG XL (JXL) enabled by default | ||
It's based on [FrameUIForFirefox](https://github.com/FineFuturity/FrameUIForFirefox/), created by [FineFuturity](https://github.com/FineFuturity). | ||
|
||
## Screenshots and GIFs | ||
|
||
![Firefox-1](misc/screenshots/firefox-1.png) | ||
![Firefox-2](misc/screenshots/firefox-2.png) | ||
![Page loading animation](misc/gifs/page-loading-animation.gif) | ||
![RGB URL bar](misc/gifs/rgb-urlbar.gif) | ||
![Navigation Buttons](misc/gifs/navigation-buttons.gif) | ||
![Other buttons](misc/gifs/other-buttons.gif) | ||
![Findbar](misc/screenshots/findbar.png) | ||
![Status Panel](misc/screenshots/statuspanel.png) | ||
![Searchbar](misc/screenshots/searchbar.png) | ||
![Downloads Menu](misc/screenshots/downloads-menu.png) | ||
![Menu](misc/screenshots/menu-0.png) | ||
![Context Menu](misc/screenshots/context-menu.png) | ||
![Context Menu 2](misc/screenshots/context-menu-2.png) | ||
![Menu Bar Menu](misc/screenshots/menu-bar-menu.png) | ||
![Sidebery Context Menu](misc/screenshots/sidebery-context-menu.png) | ||
|
||
## File Locations | ||
|
||
Both `user.js` and `chrome` files should be placed in the following locations depending on your operating system: | ||
|
||
| OS | Location | | ||
| ------- | ---------------------------------------------------------------------- | | ||
| Linux | `~/.mozilla/firefox/<profile_ID>.default/` | | ||
| Windows | `%APPDATA%\Mozilla\Firefox\Profiles\<profile_ID>.default/` | | ||
| macOS | `~/Library/Application Support/Firefox/Profiles/<profile_ID>.default/` | | ||
|
||
Replace `<profile_ID>` with your Firefox profile ID. | ||
|
||
For addons and userscripts configuration, you can find them in the respective directories. | ||
|
||
### Finding Your Default Profile | ||
|
||
- **Linux**: You can find your default profile in `~/.mozilla/firefox/profiles.ini` OR go to `about:support` in Firefox, you'll see your default profile directory in the `Profile Directory` section. Click on `Open Directory`. | ||
|
||
- **Windows**: Your default profile can be found at `%APPDATA%\Mozilla\Firefox\Profiles\`. Alternatively, navigate to `about:support` in Firefox, and click on `Open Folder` next to the `Profile Directory` section. | ||
|
||
- **macOS**: Locate your default profile in `~/Library/Application Support/Firefox/Profiles/`. Or, go to `about:support` in Firefox, and click on `Show in Finder` next to the `Profile Directory` section. | ||
|
||
## Enabling `userChrome.css` and `userContent.css` | ||
|
||
Enable `userChrome.css` and `userContent.css` support in Firefox: | ||
|
||
1. Go to `about:config` and click the "Accept the Risk and Continue" button. | ||
2. In the search box, type `toolkit.legacyUserProfileCustomizations.stylesheets`. | ||
3. Double-click the `toolkit.legacyUserProfileCustomizations.stylesheets` entry to set its value to **`true`**. | ||
4. Restart Firefox. | ||
|
||
## Additional Tweaks | ||
|
||
### Toolbar | ||
|
||
Go to `Open application menu > More tools > Customize toolbar...` and make the following changes: | ||
|
||
![Toolbar Settings](misc/screenshots/toolbar.png) | ||
|
||
Set Density to `Normal` and uncheck Title Bar. | ||
|
||
To disable bookmarks toolbar: | ||
|
||
![Disable Bookmarks Toolbar](misc/screenshots/disable-bookmarks-toolbar.png) | ||
|
||
## Customizing Firefox | ||
|
||
If you're planning to make multiple and extensive alterations to your UI, learning how to use the [Browser Toolbox](https://firefox-source-docs.mozilla.org/devtools-user/browser_toolbox/index.html) is essential. It allows you to create modifications to the UI and fix those modifications if a newer version of the Firefox codebase causes issues. | ||
|
||
While the Browser Toolbox isn't particularly user-friendly to set up or use initially, perseverance will pay off as it is key to inspecting Firefox's UI. Check out the [r/firefoxcss wiki](https://www.reddit.com/r/FirefoxCSS/wiki/index/) and search the subreddit for specific posts. | ||
|
||
Investigate how to use Mozilla's source code indexing tool [SearchFox](https://searchfox.org) as well. | ||
|
||
Most of your "How to" questions can be answered by the Browser Toolbox and SearchFox, though it takes some time to understand them both from scratch. | ||
|
||
As an alternative to using the Browser Toolbox and SearchFox, you can explore the wealth of information in subreddits like [r/FirefoxCSS](https://www.reddit.com/r/FirefoxCSS), [r/firefox](https://www.reddit.com/r/firefox/), and [r/unixporn](https://www.reddit.com/r/unixporn/). Finding the precisely relevant information often requires diligent searching with a variety of **keywords**. A useful trick is to search with a section of CSS userstyle, a selector, or a rule related to the UI element you want to modify. You can also look on GitHub, GitLab, and other code hosting sites, or simply use your favorite search engine. There are various articles and blogs online as well. Discord servers like [unixporn](https://discord.com/invite/unixporn) can be helpful too. | ||
|
||
Look for specific topics on GitHub: [userchrome](https://github.com/topics/userchrome), [firefox-css](https://github.com/topics/firefox-css), [firefox-tweaks](https://github.com/topics/firefox-tweaks), [userchrome-styles](https://github.com/topics/userchrome-styles), [userchromecss](https://github.com/topics/userchromecss). | ||
|
||
More handy resources: [userchrome.org](https://www.userchrome.org), [FirefoxCSS Store](https://firefoxcss-store.github.io), [Mozilla Bugzilla](https://bugzilla.mozilla.org), [The other guide to CSS hacking](https://mrotherguy.github.io/ToyfoCSS/). | ||
|
||
### Live Debug and Update `userChrome.css` | ||
|
||
1. Set `devtools.debugger.remote-enabled` to `true` in `about:config`. | ||
2. Set `devtools.chrome.enabled` to `true` in `about:config`. | ||
3. Open remote debugger using **Ctrl+Alt+Shift+I**. | ||
4. Allow the incoming connection. | ||
5. Select Style Editor tab, then open `userChrome.css`. | ||
6. Edit and save the file for it to take effect (hot reload). | ||
|
||
## Theme | ||
|
||
The theme I'm currently using: [RosyBrown Dark by Me](https://addons.mozilla.org/en-US/firefox/addon/rosybrown_dark/) | ||
|
||
## Addons | ||
|
||
You can find a list of addons I use [here](https://addons.mozilla.org/en-US/firefox/collections/17970682/TAT-Collection/). | ||
|
||
## Userscripts | ||
|
||
![Userscripts](misc/screenshots/violentmonkey-userscripts.png) | ||
|
||
## Stylus Styles | ||
|
||
![Stylus styles](misc/screenshots/stylus-userstyles.png) | ||
|
||
## Ublock Origin | ||
|
||
Enabled all filters except for the regional ones. Added some custom filters: | ||
|
||
![Ublock origin](misc/screenshots/ublock-origin-custom-filters.png) | ||
|
||
## Notable Mentions | ||
|
||
- [schizofox](https://github.com/schizofox/schizofox) - Hardened Firefox flake for the delusional and the schizophrenics. You might find some interesting stuff there. | ||
- [Betterfox](https://github.com/yokoffing/Betterfox) - Firefox user.js for speed, privacy, and security. Your favorite browser, but better. | ||
- [FirefoxCSS-Store](https://firefoxcss-store.github.io) - A collection site of Firefox userchrome themes. | ||
- [r/FirefoxCSS](https://www.reddit.com/r/FirefoxCSS) - A subreddit dedicated to Firefox customization. | ||
- [SearchFox](https://searchfox.org) - A source code indexing tool for Mozilla Firefox. It indexes C++, Rust, and JavaScript code. | ||
- [ArkenFox GUI](https://arkenfox.github.io/gui) - Site to help you explore the information from the [arkenfox user.js](https://github.com/arkenfox/user.js) | ||
- [fx-autoconfig](https://github.com/MrOtherGuy/fx-autoconfig) - A toolkit to load arbitrary javascript files to be run in Firefox browser context. Relies on autoconfig functionality available in Firefox. | ||
Initial idea from [rpcarvalheira](https://github.com/rpcarvalheira). See: [#32](https://github.com/TanvirOnGH/firefox-config/issues/32) |