{"id":13455364,"url":"https://github.com/GradienceTeam/Gradience","last_synced_at":"2025-03-24T08:32:09.865Z","repository":{"id":46270605,"uuid":"515181834","full_name":"GradienceTeam/Gradience","owner":"GradienceTeam","description":"Change the look of Adwaita, with ease","archived":false,"fork":false,"pushed_at":"2024-04-12T14:38:34.000Z","size":21198,"stargazers_count":1203,"open_issues_count":56,"forks_count":48,"subscribers_count":15,"default_branch":"main","last_synced_at":"2024-04-12T22:20:33.761Z","etag":null,"topics":["adw-gtk3","adwaita","adwaita-theme","blueprint","gnome","gnome-shell","gnome-shell-theme","gnome-theme","gtk","gtk-theme","gtk3","gtk3-theme","gtk4","gtk4-theme","hacktoberfest","libadwaita","python","python3"],"latest_commit_sha":null,"homepage":"https://gradienceteam.github.io","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/GradienceTeam.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":"ROADMAP.md","authors":null,"dei":null}},"created_at":"2022-07-18T12:48:27.000Z","updated_at":"2024-04-15T11:22:09.302Z","dependencies_parsed_at":"2023-12-23T19:06:14.894Z","dependency_job_id":"c857e5ed-9849-442f-9e90-e66402ce30e7","html_url":"https://github.com/GradienceTeam/Gradience","commit_stats":{"total_commits":3720,"total_committers":103,"mean_commits":"36.116504854368934","dds":0.7650537634408602,"last_synced_commit":"223724657dbc4e9e2e43cccd1a9433b6cbba6844"},"previous_names":[],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GradienceTeam%2FGradience","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GradienceTeam%2FGradience/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GradienceTeam%2FGradience/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GradienceTeam%2FGradience/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/GradienceTeam","download_url":"https://codeload.github.com/GradienceTeam/Gradience/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":221518326,"owners_count":16836536,"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":["adw-gtk3","adwaita","adwaita-theme","blueprint","gnome","gnome-shell","gnome-shell-theme","gnome-theme","gtk","gtk-theme","gtk3","gtk3-theme","gtk4","gtk4-theme","hacktoberfest","libadwaita","python","python3"],"created_at":"2024-07-31T08:01:04.443Z","updated_at":"2024-10-28T22:30:54.733Z","avatar_url":"https://github.com/GradienceTeam.png","language":"Python","funding_links":[],"categories":["Customizations","Applications","Python","应用","Development"],"sub_categories":["Linux","Desktop Customization","桌面个性化","UI Design"],"readme":"\u003e [!IMPORTANT]\n\u003e Gradience has been archived as of June 29, 2024. See the [blog post](https://daudix.one/blog/archiving-gradience/) for some information on the rationale behind this decision.\n\n\u003e [!NOTE]\n\u003e Gradience is looking for a maintainer(s)! if you know Python and GTK4/Libadwaita and willing to work on it, chip in on [Matrix](https://matrix.to/#/#Gradience:matrix.org) and [Discord](https://discord.com/invite/4njFDtfGEZ).\n\n\u003ch1 align=\"center\"\u003e\n  \u003cimg src=\"data/icons/hicolor/scalable/apps/com.github.GradienceTeam.Gradience.svg\" alt=\"Gradience\" width=\"192\" height=\"192\"/\u003e\n  \u003cbr\u003e\n  Gradience\n\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eChange the look of Adwaita, with ease\u003c/strong\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://flathub.org/apps/details/com.github.GradienceTeam.Gradience\"\u003e\n    \u003cimg width=\"200\" alt=\"Download on Flathub\" src=\"https://dl.flathub.org/assets/badges/flathub-badge-i-en.svg\"/\u003e\n  \u003c/a\u003e\n  \u003cbr\u003e\n\u003c/p\u003e\n\n\u003cbr\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://hosted.weblate.org/engage/GradienceTeam\"\u003e\n    \u003cimg alt=\"Translation status\" src=\"https://hosted.weblate.org/widgets/GradienceTeam/-/svg-badge.svg\"/\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/GradienceTeam/Gradience/actions/workflows/build.yml\"\u003e\n    \u003cimg alt=\"Build status\" src=\"https://github.com/GradienceTeam/Gradience/actions/workflows/build.yml/badge.svg\"/\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://flathub.org/apps/details/com.github.GradienceTeam.Gradience\"\u003e\n    \u003cimg alt=\"Flathub downloads\" src=\"https://img.shields.io/badge/dynamic/json?color=informational\u0026label=downloads\u0026logo=flathub\u0026logoColor=white\u0026query=%24.installs_total\u0026url=https%3A%2F%2Fflathub.org%2Fapi%2Fv2%2Fstats%2Fcom.github.GradienceTeam.Gradience\"/\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://repology.org/project/gradience/versions\"\u003e\n    \u003cimg alt=\"Packaging status\" src=\"https://repology.org/badge/tiny-repos/gradience.svg\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://matrix.to/#/#Gradience:matrix.org\"\u003e\n    \u003cimg alt=\"Chat on Matrix\" src=\"https://img.shields.io/matrix/Gradience:matrix.org?color=%230dbd8b\u0026label=Gradience\u0026logo=matrix\u0026logoColor=white\"/\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://discord.com/invite/4njFDtfGEZ\"\u003e\n    \u003cimg alt=\"Chat on Discord\" src=\"https://dcbadge.vercel.app/api/server/4njFDtfGEZ?style=flat\u0026theme=default-inverted\"/\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://stopthemingmy.app\"\u003e\n    \u003cimg alt=\"Please do not theme this app\" src=\"https://stopthemingmy.app/badge.svg\"/\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/GradienceTeam/Design/raw/main/Covers/preview.png\" alt=\"Preview\"/\u003e\n\u003c/p\u003e\n\nGradience is a tool for customizing Libadwaita applications and the adw-gtk3 theme.\n\n\u003e [!IMPORTANT]\n\u003e [Gradience, stopthemingmy.app and Adwaita Developers](#%EF%B8%8F-gradience-stopthemingmyapp-and-adwaita-developers)\n\nThe main features of Gradience include the following:\n\n- 🎨️ Changing any color of Adwaita theme\n- 🖼️ Applying Material 3 color scheme from wallpaper\n- 🎁️ Usage of other users presets\n- ⚙️ Changing advanced options with CSS\n- 🧩️ Extending functionality using plugins\n\n\u003cdetails\u003e\n  \u003csummary\u003e📷️ More screenshots\u003c/summary\u003e\n\n  ![Monet Tab](https://github.com/GradienceTeam/Design/raw/main/Screenshots/monet_purple.png)\n\n  ![Proof of Work](https://github.com/GradienceTeam/Design/raw/main/Screenshots/proof_purple.png)\n\u003c/details\u003e\n\n## 🎨️ Theming setup\n\n\u003e [!NOTE]\n\u003e You can go to `Preferences` and apply overrides for Flatpak\n\n\u003cdetails\u003e\n  \u003csummary\u003e🪛️ Manual setup\u003c/summary\u003e\n\n### Libadwaita applications\n\nNo additional setup is required for native Libadwaita applications.\n\nFor Flatpak Libadwaita applications, you need to override their permissions:\n\n- Run `sudo flatpak override --filesystem=xdg-config/gtk-4.0` or\n- Use [Flatseal](https://github.com/tchx84/Flatseal) and adding `xdg-config/gtk-4.0` to **Other files** in the **Filesystem** section of **All Applications**\n\n### Vanilla GTK 4 applications\n\nUse [this guide](https://github.com/lassekongo83/adw-gtk3/blob/main/gtk4.md) to theme vanilla GTK 4 applications.\n\n### GTK 3 applications\n\n- Install and apply the [adw-gtk3](https://github.com/lassekongo83/adw-gtk3#readme) theme (don't forget to install the Flatpak package!)\n- For Flatpak applications, you need to override their permissions:\n  - Run `sudo flatpak override --filesystem=xdg-config/gtk-3.0` or\n  - Use [Flatseal](https://github.com/tchx84/Flatseal) and adding `xdg-config/gtk-3.0` to **Other files** in the **Filesystem** section of **All Applications**\n\n\u003c/details\u003e\n\n## 🔄 Revert Theming\n1. Open Preferences window\n\n![Main Gradience Menu](https://i.imgur.com/bJMNX6d.png)\n\n2. Go to Theming tab\n\n3. In _Reset \u0026 Restore Presets_ group, click Reset button for either GTK 3 or Libadwaita applications\n\n![Reset \u0026 Restore Presets Group](https://i.imgur.com/SynxTJT.png)\n\n\u003cdetails\u003e\n  \u003csummary\u003e🪛️ Manual revert\u003c/summary\u003e\n\n### Remove GTK 3 and GTK 4 configs\n\n- Run `rm -rf .config/gtk-4.0 .config/gtk-3.0`\n\n### Remove adw-gtk3 theme\n\n- Run `flatpak uninstall adw-gtk3` to remove Flatpak adw-gtk3 theme\n- Run `rm -rf .themes/adw-gtk3 .themes/adw-gtk3-dark .local/share/themes/adw-gtk3 .local/share/themes/adw-gtk3-dark` to remove local adw-gtk3 theme\n\n### Reset Flatpak overrides\n\n- Run `sudo flatpak override --reset`\n\n\u003e [!WARNING]\n\u003e This will reset all Flatpak overrides, such as Firefox Wayland override\n\n\u003c/details\u003e\n\n## 📦️ Alternative installation methods\n\n\u003e [!IMPORTANT]\n\u003e The main installation method is Flatpak from Flathub\n\n\u003e [!NOTE]\n\u003e There are number of Gradience packages that are not tested by Gradience Team and not listed here, available at [Repology](https://repology.org/project/gradience/versions)\n\n### Fedora (COPR)\n\nGradience is available for Fedora via COPR:\n\n```shell\ndnf copr enable lyessaadi/gradience\ndnf install gradience\n```\n\n### Debian (And derivatives)\n\n\u003e [!WARNING]\n\u003e Not available yet.\n\n### Arch Linux (AUR)\n\nGradience is available for Arch Linux via AUR:\n\nUsing [Paru](https://github.com/morganamilo/paru):\n\n```shell\nparu -S gradience\n```\n\nFor latest changes:\n\n```shell\nparu -S gradience-git\n```\n\n\u003cdetails\u003e\n  \u003csummary\u003e🪛️ Without AUR helpers\u003c/summary\u003e\n\n```shell\ngit clone https://aur.archlinux.org/gradience.git\ncd gradience\nmakepkg -sic\n```\n\nFor latest changes:\n\n```shell\ngit clone https://aur.archlinux.org/gradience-git.git\ncd gradience-git\nmakepkg -sic\n```\n\n\u003c/details\u003e\n\n### NixOS\n\nGradience is available for NixOS 23.05 (Stoat) and later:\n\nTo run in a temporary shell:\n```shell\nnix-shell -p gradience\n```\n\nTo install:\n```shell\nnix-env -iA nixos.gradience\n```\n\n## 🏗️ Building from source\n\n### Nightly Build\n\nFirst of all, you need to have [GNOME Nightly](https://nightly.gnome.org) Flatpak remote added if it's not already:\n\n```shell\nflatpak remote-add --if-not-exists gnome-nightly https://nightly.gnome.org/gnome-nightly.flatpakrepo\n```\n\nThen, download the Gradience nightly from [here](https://nightly.link/GradienceTeam/Gradience/workflows/build/main)\n\nFinally, extract the ZIP and install Gradience by running:\n\n```shell\nflatpak install gradience-devel.flatpak\n```\n\n### GNOME Builder\n\nGNOME Builder is the environment used for developing this application.\nIt can use Flatpak manifests to create a consistent building and running\nenvironment cross-distro. Thus, it is highly recommended you use it.\n\n1. Download [GNOME Builder](https://apps.gnome.org/Builder).\n2. In Builder, click the \"Clone Repository\" button at the bottom, using `https://github.com/GradienceTeam/Gradience.git` as the URL.\n3. Click the build button at the top once the project is loaded.\n\nFor more building and installation methods, see [HACKING.md](HACKING.md)\n\n## 🎛️ Miscellaneous\n\n### Show welcome window again\n\nThe following command will make Gradience show welcome screen on next launch, like you just installed it\n\n#### Flatpak\n\n```shell\nflatpak run --command=gsettings com.github.GradienceTeam.Gradience reset com.github.GradienceTeam.Gradience first-run\n```\n\n#### Alternative installation methods\n\n```shell\ngsettings reset com.github.GradienceTeam.Gradience first-run\n```\n\n## ℹ️ FAQ\n\n### How can I launch a CLI?\nRefer to [temporary CLI documentation](https://github.com/GradienceTeam/Gradience/wiki/Using-CLI) in repo's wiki for instructions on how to launch a CLI.\n\n## 🙌 Contribute to Gradience\n\nSee [HACKING.md](HACKING.md)\n\n## ✨️ Contributors\n\n[![Contributors](https://contrib.rocks/image?repo=GradienceTeam/Gradience)](https://github.com/GradienceTeam/Gradience/graphs/contributors)\n\n## 🏷️ About the Name\n\nGradience was originally named Adwaita Manager.\n\nYou can see the meaning of Gradience on [Wiktionary](https://en.wiktionary.org/wiki/gradience).\n\nThe icon represents: _A Paint Roller repainting an Adwaita window, keeping its functionality._\n\n##  🖌️ About the \"Pretty Purple\"\n\nThe Pretty Purple theme comes from the very beginning, directly from the original author of Gradience, [Artyom Fomin](https://github.com/ArtyIF).\n\nIt was called \"Purple Guy\", presumably as a reference to the FNaF, later it was renamed to Pretty Purple.\n\nPretty Purple preset was originally shared in the https://github.com/GradienceTeam/Gradience/discussions/23.\n\nPretty Purple is built-in in the Gradience and used in all Gradience artworks.\n\n## 🌱️ Gradience, [stopthemingmy.app](https://stopthemingmy.app) and Adwaita Developers\n\n\u003e See [gradienceteam.github.io/hack](https://gradienceteam.github.io/hack)\n\nGradience Team is not against the ideas of [stopthemingmy.app](https://stopthemingmy.app) and the developers of Adwaita. Gradience is a tool for tinkerers who want to theme their desktop to their liking, and **not a tool for distributions** to ship in their releases. Gradience Team agrees with importance of unified look of Adwaita to make sure that all apps function correctly and that developers have a unified and stable tool for creating their apps.\n\n## 💝 Acknowledgment\n\nSpecial thanks to:\n\n- Original author of Gradience, [Artyom Fomin](https://github.com/ArtyIF) for creating this project\n- [Weblate](https://weblate.org) for providing translation platform\n\nThis README is based on README from [Kooha](https://github.com/SeaDve/Kooha) by [Dave Patrick Caberto](https://github.com/SeaDve)\n\n## 🪞 Mirrors\n\n- [GitLab](https://gitlab.com/GradienceTeam/Gradience)\n- [GitHub](https://github.com/GradienceTeam/Gradience)\n- [Codeberg](https://codeberg.org/GradienceTeam/Gradience)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FGradienceTeam%2FGradience","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FGradienceTeam%2FGradience","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FGradienceTeam%2FGradience/lists"}