Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nuclearcodecat/shimmer
charming firefox userchrome with sidebery support
https://github.com/nuclearcodecat/shimmer
css firefox firefox-css firefox-userchrome sidebery userchrome
Last synced: about 17 hours ago
JSON representation
charming firefox userchrome with sidebery support
- Host: GitHub
- URL: https://github.com/nuclearcodecat/shimmer
- Owner: nuclearcodecat
- License: gpl-3.0
- Created: 2024-10-30T21:04:59.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2025-01-11T01:26:42.000Z (10 days ago)
- Last Synced: 2025-01-13T18:13:25.653Z (8 days ago)
- Topics: css, firefox, firefox-css, firefox-userchrome, sidebery, userchrome
- Language: CSS
- Homepage:
- Size: 1.37 MB
- Stars: 144
- Watchers: 6
- Forks: 5
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# shimmer - charming firefox userchrome with sidebery support (v2.25)
[](https://github.com/nuclearcodecat/shimmer/issues)[](https://ko-fi.com/nuclearcodecat)
see the [changelog](CHANGELOG.md) for a history of changes
## demonstration
### light theme with sidebery, sidebar on left side
| sidebery, light theme, sidebar on left side, bookmarks open | native tabs, "green in the night" theme |
|---------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------|
|  |  |
| menus | popover urlbar |
|---------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------|
|  |  |
### compact findbar
### quality of life improvements
### compact, macos-like window control buttons
## features
- popover url-bar (see demo animated image)
- works with custom themes
- rounded browser/sidebar corners
- minimized context menus
- subtle, non-obstructive transitions
- minimized findbar
- setting available to move sidebar to the right side
- config properties for customization
- compatible with firefox nightly
- semi-compatible with native vertical tabs
- floating statuspanel
## installation
- download code from github (green "code" button) and unzip it
- download sidebery from mozilla addons if wanted
- open sidebery settings, scroll to the bottom
- click on "import addon data"
- select "sidebery.json" from the downloaded archive
- keep the toggles at default and click "import"
- go to about:config
- toggle `toolkit.legacyUserProfileCustomizations.stylesheets` true
- toggle `svg.context-properties.content.enabled` true
- open about:profiles, find your profile and open the root folder
- create a `chrome` folder if nonexistent
- move `userChrome.css`, `userContent.css` files and `assets` folder into the `chrome` directory
- reopen firefox
- done! :3
- please please PLEASE visit this github page once in a while to download the latest version, see "updating" section of this readme
- see "customization" section of this readme for customization options
## updating
i am expecting to make frequent chagnes to this project. check this github page once in a while and check if a new version is available. your installation's version is visible next to the close button of the new tab settings menu (top right on new tab).
### how to update:
follow the installation instructions, allow your file explorer to replace files if asked (remember to update sidebery styles)
## customization
at the top of `userChrome.css`, there are customizable css variables. among them are tab sizing options, rounding, spacing between certain items etc. below these variable there also exist exclusions from the right click context menu. comment and uncomment whichever options you might want to enable or disable.
i've also implemented some custom `about:config` boolean values for you to modify. the list is small right now but i'm hoping to see some ideas and issues pop up
- `shimmer.disable-popover-urlbar` - toggle true to remove the popover effect on the urlbar
- `shimmer.native-vertical-tabs` - toggle true if using firefox vertical tabs instead of sidebery. don't toggle true if using *horizontal* tabs, they will disappear
- `shimmer.show-sidebar-header` - toggle true to show sidebar header
- `shimmer.show-sidebar-header-close-button` - even if you enable the header, the close button is automatically hidden. toggle this true to make it reappear
- `shimmer.sidebar-right-side` - toggle true if you use sidebery on the right side. you have to move the sidebar first in firefox using the sidebar header, which has to be reenabled in config
- `shimmer.reverse-winctr-buttons-side` - toggle true to move window control buttons to the left side
- `shimmer.taller-tabs` - toggle true to make the tabs as tall as default firefox tabs
- `shimmer.shorter-navbar` - toggle true to make the navbar as tall as on unmodified firefox (may require firefox restart)
- `shimmer.disable-compact-winctr-buttons` - toggle true to revert the compact window control buttons to default
- `shimmer.dont-expand-selected-tab` - toggle true to disable the effect of expanding the active tab when there are many tabs open
- `shimmer.shimmer.hide-sidebar-button` - toggle true to hide the "show sidebars" button
- `shimmer.nightly` - toggle true if using firefox nightly (v2.17 up, unused)
## maintaining
please keep in mind that i won't always have time to fix a problem created by a new version of firefox in a day. if you'd like to create a pull request, feel free to do so. if you find any issues, please report them at the "issues" tab on github.