{"id":13475021,"url":"https://github.com/ddnexus/equilux-theme","last_synced_at":"2025-03-26T22:31:44.319Z","repository":{"id":43390569,"uuid":"89661134","full_name":"ddnexus/equilux-theme","owner":"ddnexus","description":"A Material Design-like theme for GNOME/GTK+ based desktop environments.","archived":true,"fork":true,"pushed_at":"2023-03-08T07:15:04.000Z","size":24922,"stargazers_count":324,"open_issues_count":8,"forks_count":18,"subscribers_count":17,"default_branch":"equilux-dev","last_synced_at":"2024-10-30T08:51:17.614Z","etag":null,"topics":["dark-theme","flat","gray","gtk3-theme","low-contrast-theme","neutral"],"latest_commit_sha":null,"homepage":"","language":"CSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"nana-4/materia-theme","license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ddnexus.png","metadata":{"files":{"readme":"README.md","changelog":"change_color.sh","contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-04-28T02:52:37.000Z","updated_at":"2024-08-21T02:47:42.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/ddnexus/equilux-theme","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ddnexus%2Fequilux-theme","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ddnexus%2Fequilux-theme/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ddnexus%2Fequilux-theme/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ddnexus%2Fequilux-theme/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ddnexus","download_url":"https://codeload.github.com/ddnexus/equilux-theme/tar.gz/refs/heads/equilux-dev","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245747905,"owners_count":20665884,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["dark-theme","flat","gray","gtk3-theme","low-contrast-theme","neutral"],"created_at":"2024-07-31T16:01:16.747Z","updated_at":"2025-03-26T22:31:40.426Z","avatar_url":"https://github.com/ddnexus.png","language":"CSS","funding_links":[],"categories":["CSS","HarmonyOS"],"sub_categories":["Windows Manager"],"readme":"# Equilux Theme\n\n![Screenshot](screenshot.png)\n\nThe Equilux Theme provides a couple of full-dark, neutral-gray theme for GNOME/GTK+ based desktop environments. It supports GTK+ 3, GTK+ 2, GNOME Shell, Budgie, MATE, Unity, LightDM, GDM, Chrome theme, etc.\n\nIt is based on the [Materia Theme](https://github.com/nana-4/materia-theme). For detailed features and documentation, please, check upstream.\n\n### Motivation\n\nThe Equilux themes provide a neutral dark-balanced color-scheme not designed to be __fancy__, but to be __useful__ for a few specific goals.\n\n1. __Minimize eye strain__: when you pass many hours in front of the screen or you are hyper-sensitive to light, saturation and contrast, your eyes will benefit from a dull UI\n\n2. __Avoid disrupting your circadian rhythms__: a neutral color-cast-free UI helps your body to produce enough melatonin at night time and sleep better, working nicely with software like `f.lux`, `redshift`, `NightLight`, ...\n\n3. __Professional use in image editing, graphic design, 3D rendering__: in that fields any color cast or excessive contrast, brightness or darkness introduced by the UI would affect the overall perception of the color and balance of the images\n\n4. __You may just like it__: even if the style is not the main goal, many people find that its very clean and minimalistic UI looks cool and professional\n\n\n### Technical Focus\n\nThe Equilux Theme sticks to the upstream theme as much as possible, and is exclusively focused on the following points:\n\n- Total removal of any color cast from the background elements (neutral base)\n- Use of a neutral base for all the UI elements, with exception of a few button/boxes\n- Maximum reduction of contrast/saturation\n- Medium overall brightness/darkness of the UI\n\n### Changes from the Upstream Theme\n\n- The installer script installs only the Equilux variants\n- Addition of Ubuntu font family and removal of the \"M+ c1\" font.\n- A few minor cosmetic fixes\n- Minimal changes in the color assignations in order to make the Equilux palette work OK with the theme.\n\n## Theme Installation/Uninstallation\n\n**Installation**: Download the latest `equilux-theme-*.tar.xz` version listed in the __Files__ tab [here](https://www.opendesktop.org/p/1182169/), unzip it and move the Equilux* dirs to `/usr/share/themes`. As an alternative you can download the source of the latest release [here](https://github.com/ddnexus/equilux-theme/releases) and run the `install.sh` script as privileged user.\n\n**Uninstallation**: Delete the installed directories: `sudo rm -rf /usr/share/themes/Equilux{,-compact}`\n\n## Font Customization\n\nAfter you install the themes, you may want to customize the fonts by editing the `font-family` CSS rule inside the installed CSS file(s) `/usr/share/themes/Equilux{,-compact}/gnome-shell/gnome-shell.css`.\n\nHere is the current line that affects the fonts:\n\n```\nfont-family: Roboto, Ubuntu, Cantarell, Sans-Serif;\n```\n\nYou can edit it manually with any text-editor, or you can run a simple command (courtesy of nana-4). Just remember to edit the \"your-preferred-font\" string :).\n\nFor example: prepending `your-preferred-font`:\n\n```\nsudo sed -i 's/Roboto/your-preferred-font, Roboto/g' /usr/share/themes/Equilux{,-compact}/gnome-shell/gnome-shell.css\n```\n\nor switching priority between `Roboto` and `Ubuntu`:\n\n```\nsudo sed -i 's/Roboto, Ubuntu/Ubuntu, Roboto/g' /usr/share/themes/Equilux{,-compact}/gnome-shell/gnome-shell.css\n```\n\nor change it as you prefer.\n\n## GDM Theme Installation/Uninstallation\n\nSee the the upstream instruction [here](https://github.com/nana-4/materia-theme/wiki/GDM-Theme).\n\n## Related Items\n\nA quick list of items that - for different reasons - fit well with the Equilux style and concept. Please, submit your suggestions as a new Issue, so I will add a note in this section.\n\n### Wallpapers\n\nSeamless textures from various sources and authors, converted to low contrast/brightness grayscale available in the __Files__ tab [here](https://www.opendesktop.org/p/1182169/)\n\n### Icons\n\n- [Circle Numix Icons](https://github.com/numixproject/numix-icon-theme-circle): a circle themed icon set well maintained and not too bright (if you use Numix Folders below to tame the folder colors)\n\n- [Numix Folders](https://github.com/numixproject/numix-folders): Customization script to change the colors and style of the numix folders (otherwise too bright and saturated). Recommended settings: Style: 6, Primary color: #9c9c9c, Secondary color; #9c9c9c, Symbol: #656565\n\n- [Zafiro icons](https://github.com/zayronxio/Zafiro-icons): a flat theme with \"washed\" pastel colors\n\n- [Papirus-Icon-Theme](https://github.com/PapirusDevelopmentTeam/papirus-icon-theme/): a flat, sticker-like icon theme with a few variants (recommended Papirus-Dark)\n\n- [Papirus Folders Script](https://github.com/PapirusDevelopmentTeam/papirus-folders): Customization script to change the colors of the papirus folders. Recommended command: `papirus-folders -C grey --theme Papirus-Dark`\n\n### GNOME Extensions\n\n- [Darker Overview](https://extensions.gnome.org/extension/1177/darker-overview/): Customize the darkness of the background in the Overview. It can also remove the ugly vignette effect\n\n- [Desaturate All](https://extensions.gnome.org/extension/1102/desaturate-all/): Desature the entire gnome workspace (I hacked a copy to have 4 deaturation levels instead of all-or-none: ask if interested)\n\n- [AppMenu Regular Icons](https://extensions.gnome.org/extension/970/appmenu-regular-icons/): Disables Symbolic Icons in the app menu. In the mostly grayscale UI, a small colored icon is useful to quickly identify the app you are in. Besides it normalizes the icons that otherwise would be grey or colored with no particular consistence.\n\n- [Background Logo](https://extensions.gnome.org/extension/889/background-logo/): Overlay an icon/pict in the bottom right corner. A bit buggy and useless :) but a nice touch.\n\n### App Themes and Settings\n\n- [Equilux-Telegram](https://github.com/aquatix/Equilux-Telegram-Theme)\n\n- [Equilux-Flubox](https://www.opendesktop.org/p/1193958/)\n\n- [HexChat](https://dl.hexchat.net/themes/Zenburn.hct): the Zenburn theme fits well with Equilux\n\n- [Smyck terminal](https://github.com/DarthWound/smyck-gnome-terminal): a script to use SMYCK palette in GNOME Terminal\n\n- [Equilux-Firefox](https://github.com/cj-sv/equilux-firefox): an Equilux color scheme for Firefox userContent.css and userChrome.css.\n\n- [Tint2](https://gist.github.com/meskarune/329826937aea0effdbfa9f3bdc7e7989): tint2 panel theme that matches Equilux.\n\n- TBD: add the style settings consistent with the Equilux Palette for apps like Vivaldi, Tilix, RubyMine, SmartGit, DeepGit, ...\n\n### Browser Extensions\n\n- [Dark Reader](https://github.com/darkreader/darkreader): Chrome and FireFox extension that inverts brightness of web pages and aims to reduce eyestrain while browsing the web.\n\n## Branches\n\nMaster is always the upstream master: no changes from the base theme there.\nThe `equilux-*` branch(es) are the branches with the changes from the upstream master.\nPlease, notice that the `*-dev` branches are getting rebased on top of master at each new release. The old versions will be tagged and will not be removed/rebased.\n\n## License\n\nThe Equilux Theme is distributed under the terms of the GNU General Public License, version 2 or later. See the [`COPYING`](COPYING) file for details.\n\n## Credits\n\n- All credits go to the [Materia Theme](https://github.com/nana-4/materia-theme), its author and contributors.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fddnexus%2Fequilux-theme","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fddnexus%2Fequilux-theme","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fddnexus%2Fequilux-theme/lists"}