{"id":17694326,"url":"https://github.com/dgsasha/qualia-gtk-theme","last_synced_at":"2025-03-12T22:32:54.367Z","repository":{"id":41351256,"uuid":"509219951","full_name":"dgsasha/qualia-gtk-theme","owner":"dgsasha","description":"A Yaru and Libadwaita inspired theme for GTK desktops","archived":true,"fork":false,"pushed_at":"2023-05-02T00:52:22.000Z","size":188776,"stargazers_count":69,"open_issues_count":4,"forks_count":3,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-02-13T07:17:16.365Z","etag":null,"topics":["cinnamon-theme","firefox-theme","gnome","gnome-shell-theme","gtk3-theme","gtk4-theme","linux","theme","vscode-theme"],"latest_commit_sha":null,"homepage":"","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/dgsasha.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-06-30T20:11:00.000Z","updated_at":"2025-01-09T10:33:02.000Z","dependencies_parsed_at":"2024-10-24T16:47:46.499Z","dependency_job_id":"3a2a9661-efbb-4369-bc63-456b925ee6ee","html_url":"https://github.com/dgsasha/qualia-gtk-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/dgsasha%2Fqualia-gtk-theme","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dgsasha%2Fqualia-gtk-theme/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dgsasha%2Fqualia-gtk-theme/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dgsasha%2Fqualia-gtk-theme/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dgsasha","download_url":"https://codeload.github.com/dgsasha/qualia-gtk-theme/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243307050,"owners_count":20270253,"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":["cinnamon-theme","firefox-theme","gnome","gnome-shell-theme","gtk3-theme","gtk4-theme","linux","theme","vscode-theme"],"created_at":"2024-10-24T13:48:27.191Z","updated_at":"2025-03-12T22:32:53.894Z","avatar_url":"https://github.com/dgsasha.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# qualia GTK theme\n**A Yaru and Libadwaita inspired theme designed to provide a consistent experience across GTK desktops.**\n\nRead more about the theme [here](https://github.com/dgsasha/qualia-gtk-theme/wiki/About).\n\n**Supports GNOME 42+, Budgie 10.6+, Cinnamon, Unity7, Xfce, and Mate.**\n\n**[Other Desktop Environments](https://github.com/dgsasha/qualia-gtk-theme/wiki/Other-Desktop-Environments)**\n\n![Screenshot of the dark theme](.github/images/dark.png)\n\n![Screenshot of the light theme](.github/images/light.png)\n\n**There is also a variant of the theme with Libadwaita style window controls.**\n![Screenshot of the symbolic window controls variant](.github/images/symbolic_window_controls.png)\n\nMore screenshots can be seen [here](https://github.com/dgsasha/qualia-gtk-theme/wiki/Screenshots).\n\n**This repo contains a GTK3 theme, a configuration for Libadwaita, a Firefox theme, a VS Code theme, and themes for the desktops listed above.**\n  \n**The Yaru icon, cursor, sound, and GtkSourceView themes are also included.**\n\n# How to Install\n\n## Installing Dependencies\n\nA modern version of Python is required. Any currently supported version should work.\n\nIf you are going to install the VS Code theme, you will need to install pyjson5 along with the other dependencies listed below.\nTo install it, run this:\n```\npip install json5\n```\n\n\u003cdetails\u003e\n\u003csummary\u003e\n\n### Arch based distros\n*Includes Arch, Manjaro, Garuda, EndeavourOS, etc.*\n\n\u003c/summary\u003e\n\n```\nsudo pacman -S sassc git ninja meson rsync\n```\n\n**If you are going to install the GNOME Shell theme, also run this and then log out and log back in:**\n\n```\nsudo pacman -S gnome-shell-extensions\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\n\n### Debian/Ubuntu based distros\n*Includes Debian, Ubuntu (and all Ubuntu Remixes), Pop!_OS, Zorin OS, etc.*\n\n\u003c/summary\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\n\n#### Debian base \u003e= 'bookworm' or Ubuntu base \u003e= 22.04\n*Also includes [bullseye-backports](https://backports.debian.org/Instructions/) and Debian branches like sid/testing.*\n\n\u003c/summary\u003e\n\n```\nsudo apt-get install sassc git ninja-build meson\n```\n\n**If you are going to install the GNOME Shell theme, also run this and then log out and log back in:**\n\n```\nsudo apt-get install gnome-shell-extensions\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\n\n#### Debian base \u003c= 'bullseye' or Ubuntu base \u003c= 20.04\n*Includes some Ubuntu based distros like Zorin OS.*\n\n*The GNOME Shell theme will not work on distros this old.*\n\n\u003c/summary\u003e\n\n```\nsudo apt-get install sassc git python3-pip\n```\n```\nsudo pip install meson ninja\n```\n\n\u003c/details\u003e\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\n\n### Fedora based distros\n*Includes Fedora (and all Fedora Spins), Nobara, risiOS, etc.*\n\n\u003c/summary\u003e\n\n```\nsudo dnf install sassc git ninja-build meson\n```\n\n**If you are going to install the GNOME Shell theme, also run this and then log out and log back in:**\n\n```\nsudo dnf install gnome-shell-extension-user-theme\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\n\n### OpenSUSE based distros\n*Includes OpenSUSE Tumbleweed and GeckoLinux Rolling, openSUSE Leap probably isn't supported.*\n\n\u003c/summary\u003e\n\n```\nsudo zypper install sassc git ninja meson\n```\n\n**If you are going to install the GNOME Shell theme, also run this and then log out and log back in:**\n\n```\nsudo zypper install gnome-shell-extension-user-theme\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\n\n### Solus\n*Includes all Solus editions.*\n\n\u003c/summary\u003e\n\n```\nsudo eopkg install sassc git ninja meson rsync gnome-shell-extensions\n```\n\n**If you are going to install the GNOME Shell theme, also run this and then log out and log back in:**\n\n```\nsudo eopkg install gnome-shell-extensions\n```\n\n\u003c/details\u003e\n\n## Downloading and Installing\n\n#### First, download the repository.\n\nIf storage space / network usage is not a problem, run this:\n```\ngit clone https://github.com/dgsasha/qualia-gtk-theme -b main \u0026\u0026 cd qualia-gtk-theme\n```\nIf you want to limit the download size and don't plan on contributing, run this instead:\n```\ngit clone --depth=1 --recurse-submodules --shallow-submodules https://github.com/dgsasha/qualia-gtk-theme -b main \u0026\u0026 cd qualia-gtk-theme\n```\n\n#### Next, run the install script to configure and install the theme.\n\nWhen configuring the theme you get to choose the install directory and [accent color](#available-accent-colors), choose between the light and dark theme, choose the window controls variant, and choose which themes you want to install.\n\nIf you are going to install the Firefox theme, read [this](https://github.com/dgsasha/qualia-gtk-theme/wiki/Firefox-Theme) first, and if you are going to install the VS Code theme, read [this](https://github.com/dgsasha/qualia-gtk-theme/wiki/VS-Code-Theme) first.\n\n```\n./install.py\n```\n\n\u003c/div\u003e\n\n```\nusage: install.py [-h] [-c] [-r] [-d] [-t] [-w] [-s] [-F] [-a] [-f] [-n] [-v]\n\nThis script is used to install, update, and reconfigure the theme\n\noptions:\n  -h, --help         show this help message and exit\n  -c, --clean        clean build directories and exit\n  -r, --reconfigure  reconfigure the theme\n  -d, --install-dir  change install dir\n  -t, --theme        change theme variant\n  -w, --window       change window controls variant\n  -s, --syntax       change VS Code syntax highlighting\n  -F, --firefox      change Firefox settings theming\n  -a, --accent       change accent color\n  -f, --force        force install the theme\n  -n, --no-update    don't update the submodules, useful if you made local changes\n  -v, --verbose      verbose mode\n```\n\n\u003cdiv align=\"center\"\u003e\n\n#### Available Accent Colors:\n![Accent Colors](.github/images/accents-dark.svg#gh-dark-mode-only)\n![Accent Colors](.github/images/accents-light.svg#gh-light-mode-only)\n\n## Updating\n\nYou should try to update the theme frequently, and always make sure it is up to date before opening issues.\n\nTo update, pull in changes from the git repo and run the install script again.\n\n```\ngit pull\n```\n```\n./install.py\n```\n\nOnly the themes that have updates will be reinstalled, if you want to force reinstall everything, use the `--force` option.\n\nYour previous configuration will be used again unless you use the `--reconfigure` option.\n\nThere are other options to change parts of the configuration, all of them are listed above in the [Downloading and Installing](#downloading-and-installing) section.\n\nIf for some reason the update fails, try running `./install.py -c` and then run the install script again before you open an issue. This cleans the build directories, and often has to be done when there are major changes. \n\n\u003cdetails\u003e\n\u003csummary\u003e\n\n#### Warning about GNOME\n\n\u003c/summary\u003e\n\nThe GNOME Shell often changes a lot between major releases. For this reason you will always need to run `./install.py` after updating GNOME to make sure the latest version of the theme is installed. You should probably do this for other desktops as well, just in case there are changes.\n\nYou should also probably avoid using alpha builds of GNOME because I might not have the theme updated to support them yet.\n\n\u003c/details\u003e\n\n## Uninstalling\n\nRun the uninstall script followed by any number of the below themes to choose what to uninstall.\n\nOr run the uninstall script with no arguments to uninstall the entire theme.\n\n```\n./uninstall.py\n```\n\n\u003c/div\u003e\n\n```\nUsage:\n    ./uninstall.py \u003coption\u003e \u003ctheme\u003e ...\n\nThemes:\n    gtk3            gtk4-libadwaita  gnome-shell\n    cinnamon-shell  metacity         unity\n    xfwm4           firefox          icons\n    cursors         sounds           gtksourceview\n    snap            vscode           gtk4-config\n\nOptions:\n    -v, --verbose   Verbose mode.\n    -d, --dry-run   Similar to verbose mode, except nothing is actually deleted.\n    -h, --help      Show this screen.\n```\n\n\u003cdiv align=\"center\"\u003e\n\n## Other things you should read\n\n### [Snap Apps](https://github.com/dgsasha/qualia-gtk-theme/wiki/Snap-Apps) \u0026nbsp; [GDM Theme](https://github.com/dgsasha/qualia-gtk-theme/wiki/GDM-Theme) \u0026nbsp; [Copying](https://github.com/dgsasha/qualia-gtk-theme/wiki/Copying) \u0026nbsp; [Issues](https://github.com/dgsasha/qualia-gtk-theme/wiki/Issues) \u0026nbsp; [Contributing](https://github.com/dgsasha/qualia-gtk-theme/wiki/Contributing)\n\n## :heart:\u0026nbsp; Credits \u0026nbsp;:heart:\n### A huge thanks to:\n### [Ubuntu](https://ubuntu.com/) for [Yaru](https://github.com/ubuntu/yaru), [vinceliuice](https://github.com/vinceliuice) for [WhiteSur-gtk-theme](https://github.com/vinceliuice/WhiteSur-gtk-theme), [rafaelmardojai](https://github.com/rafaelmardojai) for [firefox-gnome-theme](https://github.com/rafaelmardojai/firefox-gnome-theme), [piousdeer](https://github.com/piousdeer) for [vscode-adwaita](https://github.com/piousdeer/vscode-adwaita), and [lassekongo83](https://github.com/lassekongo83) for [adw-gtk3](https://github.com/lassekongo83/adw-gtk3).\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdgsasha%2Fqualia-gtk-theme","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdgsasha%2Fqualia-gtk-theme","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdgsasha%2Fqualia-gtk-theme/lists"}