{"id":13418682,"url":"https://github.com/numixproject/elegance-colors","last_synced_at":"2025-03-15T03:31:53.855Z","repository":{"id":6138518,"uuid":"7367226","full_name":"numixproject/elegance-colors","owner":"numixproject","description":"A highly customizable chameleon theme for Gnome Shell","archived":true,"fork":false,"pushed_at":"2015-02-28T19:52:53.000Z","size":6695,"stargazers_count":117,"open_issues_count":19,"forks_count":7,"subscribers_count":15,"default_branch":"master","last_synced_at":"2024-07-31T22:43:40.862Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"CSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/numixproject.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2012-12-29T14:39:19.000Z","updated_at":"2023-06-21T08:55:29.000Z","dependencies_parsed_at":"2022-09-14T18:50:54.443Z","dependency_job_id":null,"html_url":"https://github.com/numixproject/elegance-colors","commit_stats":null,"previous_names":[],"tags_count":19,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/numixproject%2Felegance-colors","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/numixproject%2Felegance-colors/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/numixproject%2Felegance-colors/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/numixproject%2Felegance-colors/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/numixproject","download_url":"https://codeload.github.com/numixproject/elegance-colors/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243681024,"owners_count":20330152,"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":[],"created_at":"2024-07-30T22:01:05.501Z","updated_at":"2025-03-15T03:31:48.845Z","avatar_url":"https://github.com/numixproject.png","language":"CSS","funding_links":[],"categories":["CSS"],"sub_categories":[],"readme":"### Introduction\n\nElegance Colors is a highly customizable chameleon theme for Gnome Shell. It can change colors according to the current GTK theme, current wallpaper (uses imagemagick to get color) or use a user defined color.\n\n### License\n\nThis program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.\n\nThis program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.\n\nYou should have received a copy of the GNU General Public License along with this program.  If not, see [gnu.org/licenses](http://www.gnu.org/licenses/).\n\nCopyright (C) [Satyajit Sahoo](mailto:satyajit.happy@gmail.com)\n\n### Installation\n\nUbuntu users can install Elegance Colors from our themes PPA using the following commands,\n\n\tsudo add-apt-repository ppa:satyajit-happy/themes\n\tsudo apt-get update \u0026\u0026 sudo apt-get install gnome-shell-theme-elegance-colors\n\nFedora and OpenSUSE users can add the appropriate repo from [opensuse build service](http://download.opensuse.org/repositories/home:/satya164:/elegance-colors/) and install the package `gnome-shell-theme-elegance-colors` via the distro's package manager.\n\nArch Linux users can install Elegance Colors from [aur](https://aur.archlinux.org/packages/gnome-shell-themes-elegance-colors/).\n\nIf you use another distro, you need to compile from source. This is needed for the GUI.\n\nDon't worry, it is easy and straight forward.\n\nYou need to install the build-dependencies first (package names may vary depending on your distro),\n\n`glib2-devel gtk3-devel vala`\n\nExtract the archive, navigate to the directory and type the following commands in a terminal,\n\n`make`\n`sudo make install`\n\nTo derive color from wallpaper, you need to install ImageMagick\n\nAlso install the [User Theme Extension](https://extensions.gnome.org/extension/19/user-themes/) for Gnome Shell.\n\n### Setup\n\nA process runs in background which detects changes, generates the theme and reloads the theme accordingly. After installation, you must run the following command to start the background process,\n\n`elegance-colors`\n\nTo set the theme, choose the theme via Gnome Tweak Tool or run the following commands,\n\n`gsettings set org.gnome.shell.extensions.user-theme name 'elegance-colors'`\n\nYou can launch the GUI from the menu which lets you customise various aspects of the the theme. You can also export your customized theme, import/export settings from the GMenu. Click on the title in the Gnome Shell top bar to get the GMenu.  You can also launch the GUI by running:\n\n`elegance-colors-prefs`\n\n### Advanced configuration\n\nApart from the included presets, Elegance Colors supports user presets installed under `~/.config/elegance-colors/presets/`\n\nTo create a preset, just export your customized settings from the GMenu and give it a name by editing the exported file and adding the following at the beginning,\n\n`# Name: Your Awesome Name`\n\nYou can also change the settings by editing the file `~/.config/elegance-colors.ini` instead of using the GUI. It also gives more power to you by enabling you to use symbolic colors.\n\nFor example, you can use,\n\n`button_activebg1=@mode`\n\nWhere `@mode` is the color derived from the wallpaper, GTK theme or a custom color.\n\nThere are 3 methods for manipulating colors, `alpha` - for making a color translucent, `shade` - to darken or lighten a color, `tint` - to mix a color with another.\n\nFor example, you can use,\n\n`button_activebg1=shade;@mode;-10`\n\nIt takes the symbolic color `@mode`, and darkens it by \"10\". You can have a look at the included presets to have more understanding.\n\nIf you want even more customization, you can include single line custom CSS code,\n\nFor example,\n\n\t[Include]\n\tinclude_code=.toggle-switch-us:checked,.toggle-switch-intl:checked{background-color:rgba(83,169,63,1.0);}\n\nIf that's not enough, you can also include a custom CSS file to override the values in the default template.\n\nTo include a custom CSS file, create a directory under `~/.config/elegance-colors/presets/` and put all required files there. Then list the files to be included in the configuration file,\n\nFor example,\n\n\t[Include]\n\tinclude_dir=custom\n\tinclude_css=close.css;switches.css\n\tinclude_files=close.png;on.png;off.png\n\n### Troubleshooting\n\nIt is recommended to stop any previous instances of elegance-colors when updating to a new version. You can stop the running process of elegance-colors with the command,\n\n`elegance-colors stop`\n\nTo view any error messages produced, run the process in Terminal,\n\n`elegance-colors start`\n\nTo manually apply changes, run,\n\n`elegance-colors apply`\n\nIf your theme fails to apply after an upgrade, it is likely that the config file doesn't include new options. To update the config file, run,\n\n`elegance-colors update`\n\nTo export the theme, run,\n\n`elegance-colors export /path/to/themefile.zip`\n\n### Getting the source\n\nYou can get the latest source code from the [GitHub page](https://github.com/satya164/elegance-colors).\n\n`git clone git@github.com:satya164/elegance-colors.git`\n\n### Bugs and feature requests\n\nPlease submit bugs and feature requests [here](http://github.com/satya164/elegance-colors/issues).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnumixproject%2Felegance-colors","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnumixproject%2Felegance-colors","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnumixproject%2Felegance-colors/lists"}