{"id":13455351,"url":"https://github.com/vinceliuice/WhiteSur-gtk-theme","last_synced_at":"2025-03-24T08:32:23.502Z","repository":{"id":37566865,"uuid":"279638102","full_name":"vinceliuice/WhiteSur-gtk-theme","owner":"vinceliuice","description":"MacOS like theme for all gtk based desktops","archived":false,"fork":false,"pushed_at":"2024-10-24T05:29:42.000Z","size":118492,"stargazers_count":5901,"open_issues_count":411,"forks_count":607,"subscribers_count":58,"default_branch":"master","last_synced_at":"2024-10-24T23:25:24.524Z","etag":null,"topics":["gnome","gtk","gtk-theme","gtk3","gtk4","macos"],"latest_commit_sha":null,"homepage":"","language":"SCSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vinceliuice.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":"COPYING","code_of_conduct":".github/CODE_OF_CONDUCT.md","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":"2020-07-14T16:30:18.000Z","updated_at":"2024-10-24T21:39:07.000Z","dependencies_parsed_at":"2022-07-10T22:48:16.975Z","dependency_job_id":"a3e83aea-f6f6-436b-a8ab-4a145d2766cb","html_url":"https://github.com/vinceliuice/WhiteSur-gtk-theme","commit_stats":null,"previous_names":[],"tags_count":25,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vinceliuice%2FWhiteSur-gtk-theme","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vinceliuice%2FWhiteSur-gtk-theme/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vinceliuice%2FWhiteSur-gtk-theme/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vinceliuice%2FWhiteSur-gtk-theme/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vinceliuice","download_url":"https://codeload.github.com/vinceliuice/WhiteSur-gtk-theme/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":221947535,"owners_count":16906139,"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":["gnome","gtk","gtk-theme","gtk3","gtk4","macos"],"created_at":"2024-07-31T08:01:04.264Z","updated_at":"2025-03-24T08:32:23.495Z","avatar_url":"https://github.com/vinceliuice.png","language":"SCSS","funding_links":["https://www.paypal.me/vinceliuice"],"categories":["CSS","Desktop Customization","Applications","SCSS","应用"],"sub_categories":["VoIP","Desktop Customization","桌面个性化"],"readme":"\u003ch1 align=\"center\"\u003e WhiteSur GTK Theme \u003c/h1\u003e\n\u003cp align=\"center\"\u003e \u003cimg src=\"https://github.com/vinceliuice/WhiteSur-gtk-theme/blob/pictures/pictures/macbook.png\"/\u003e \u003c/p\u003e\n\n\u003cbr\u003e\n\u003cp align=\"center\"\u003e \u003cb\u003e A macOS like theme for Linux GTK Desktops \u003c/b\u003e \u003c/p\u003e\n\u003cbr\u003e\n\n## Donate\n\nIf you like my project, you can buy me a coffee, many thanks ❤️ !\n\n\u003cspan class=\"paypal\"\u003e\u003ca href=\"https://www.paypal.me/vinceliuice\" title=\"Donate to this project using Paypal\"\u003e\u003cimg src=\"https://www.paypalobjects.com/webstatic/mktg/Logo/pp-logo-100px.png\" alt=\"PayPal donate button\" /\u003e\u003c/a\u003e\u003c/span\u003e\n\n# Installation is easy!\n\u003cdetails\u003e \u003csummary\u003e Required dependencies \u003cb\u003e(click to open)\u003c/b\u003e \u003c/summary\u003e\n\n### \"Install from source\" deps\n- sassc\n- libglib2.0-dev-bin     `ubuntu 20.04`\n- libglib2.0-dev         `ubuntu 18.04` `debian 10.03` `linux mint 19`\n- libxml2-utils          `ubuntu 18.04` `debian 10.03` `linux mint 19`\n- glib2-devel            `Fedora` `Redhat`\n\n### Misc deps\n- imagemagick            `(optional for GDM theme tweak)`\n- dialog                 `(optional for installation in dialog mode)`\n- optipng                `(optional for asset rendering)`\n- inkscape               `(optional for asset rendering)`\n\nDon't worry, WhiteSur installer already provides all of those dependencies.\n\u003c/details\u003e\n\n\u003cdetails\u003e \u003csummary\u003e Recommended GNOME Shell extensions \u003cb\u003e(click to open)\u003c/b\u003e \u003c/summary\u003e\n\n- [user-themes](https://extensions.gnome.org/extension/19/user-themes/) to enable gnome-shell theme (and not just the application theme)\n- [dash-to-dock](https://extensions.gnome.org/extension/307/dash-to-dock)\n- [blur-my-shell](https://extensions.gnome.org/extension/3193/blur-my-shell)\n\n\u003c/details\u003e\n\n## Quick install\n\n### Installing from source\n\n1. Run `git clone https://github.com/vinceliuice/WhiteSur-gtk-theme.git --depth=1`\n\n2. Run `./install.sh` to install the default WhiteSur GTK theme pack.\n\n### Uninstall\n\n- uninstall Gtk themes: `./install.sh -r`\n- uninstall GDM theme: `sudo ./tweaks.sh -g -r`\n- uninstall Firefox theme: `./tweaks.sh -f -r`\n- uninstall Flatpak Gtk themes: `./tweaks.sh -F -r`\n\n## There's so many customizations you can do!\nUsage:  `./install.sh [OPTIONS...]`\n\n\u003cdetails\u003e \u003csummary\u003e Options \u003cb\u003e(click to open)\u003c/b\u003e \u003c/summary\u003e\n\n```bash\n\nOPTIONS:\n  -d, --dest DIR\n   Set destination directory. Default is '/home/[USER_NAME]/.themes'\n\n  -n, --name NAME\n   Set theme name. Default is 'WhiteSur'\n\n  -o, --opacity [normal|solid]\n   Set theme opacity variants. Repeatable. Default is all variants\n\n  -c, --color [light|dark]\n   Set theme color variants. Repeatable. Default is all variants\n\n  -a, --alt [normal|alt|all]\n   Set window control buttons variant. Repeatable. Default is 'normal'\n\n  -t, --theme [default|blue|purple|pink|red|orange|yellow|green|grey|all]\n   Set theme accent color. Repeatable. Default is BigSur-like theme\n\n  -s, --scheme [standard|nord]\n   Set theme colorscheme style. Repeatable. Default is 'standard'\n\n  -m, --monterey \n   Set to MacOS Monterey style. \n\n  -N, --nautilus [stable|normal|mojave|glassy|right]\n   Set Nautilus style. Default is BigSur-like style (stabled sidebar)\n\n  -l, --libadwaita \n   Install theme into gtk4.0 config for libadwaita. Default is dark version\n\n  -f, --fixed \n   Install fixed accent color version. Default is adaptive version\n\n  -HD, --highdefinition \n   Set to High Definition size. Default is laptop size\n\n  --shell, --gnomeshell \n   Tweaks for gnome-shell. Options:\n\n     1. -i, -icon [apple|simple|gnome|ubuntu|tux|arch|manjaro|fedora|debian|void|opensuse|popos|mxlinux|zorin|budgie|gentoo]\n     Set gnome-shell panel 'Activities' icon. Default is 'standard'\n\n     2. -b, -background [default|blank|IMAGE_PATH]\n     Set gnome-shell background image. Default is BigSur-like wallpaper\n\n     3. -p, -panelopacity [default|30|45|60|75]\n     Set gnome-shell panel transparency. Default is 15%\n\n     4. -h, -panelheight [default|smaller|bigger]\n     Set gnome-shell panel height size. Default is 32px\n\n     5. -sf, -smallerfont \n     Set gnome-shell font size to smaller (10pt). Default is 11pt\n\n     6. normal, -normal \n     Set gnome-shell show apps button style to normal. Default is BigSur\n\n  --round, --roundedmaxwindow \n   Set maximized window to rounded. Default is square\n\n  --black, --blackfont \n   Set panel font color to black. Default is white\n\n  --darker, --darkercolor \n   Install darker 'WhiteSur' dark themes. \n\n  --dialog, --interactive \n   Run this installer interactively, with dialogs. \n\n  --silent-mode \n   Meant for developers: ignore any confirm prompt and params become more strict. \n\n  -r, --remove, -u, --uninstall \n   Remove all installed WhiteSur themes. \n\n  -h, --help \n   Show this help. \n\n```\n\n\u003c/details\u003e\n\n## Fix for libadwaita (not perfect)\n\n\u003cdetails\u003e \u003csummary\u003e Details \u003cb\u003e(click to open)\u003c/b\u003e \u003c/summary\u003e\n\n  Since the release of `Gnome 43.0`, more and more built-in apps use `libadwaita` now, and libadwaita does not support custom themes, which means we cannot change the appearance of app using libadwaita through `gnome-tweaks` or `dconf-editor`. For users who love custom themes, it’s really sucks!\n\n  Anyway if anybody who still want to custom themes we can only do this way:\n\n  that is to use the `theme file` to overwrite the `gtk-4.0 configuration file`. The result is that only Fixed making all gtk4 apps use one theme and cannot be switched (even can not switch to dark mode) If you want to change a theme, you can only re-overwrite the `gtk-4.0 configuration file` with a new theme, I know this method is not perfect, But at the moment it is only possible to continue using themes for libadwaita's apps ...\n\n\u003c/details\u003e\n\nRun this command to install `WhiteSur` into `gtk-4.0 configuration folder` ($HOME/.config/gtk-4.0)\n\n```bash\n./install.sh -l                # Default is the normal dark theme\n./install.sh -l -c light       # install light theme for libadwaita\n```\n\n## \u003cp align=\"center\"\u003e \u003cb\u003e Change theme color and accent \u003c/b\u003e \u003c/p\u003e\n\u003cp align=\"center\"\u003e \u003cimg src=\"https://github.com/vinceliuice/WhiteSur-gtk-theme/blob/pictures/pictures/colors-themes.png\"/\u003e \u003c/p\u003e\n\n#### - Install theme accent\nParameter: `--theme` `-t` (repeatable)\n\nExample:\n\n```bash\n./install.sh -t red            # install red theme accent only\n./install.sh -t red -t green   # install red and green theme accents\n./install.sh -t all            # install all available theme accents\n```\n\n## \u003cp align=\"center\"\u003e \u003cb\u003e Change Nautilus style \u003c/b\u003e \u003c/p\u003e\n\u003cp align=\"center\"\u003e \u003cimg src=\"https://github.com/vinceliuice/WhiteSur-gtk-theme/blob/pictures/pictures/nautilus.png\"/\u003e \u003c/p\u003e\n\nParameter: `--nautilus` `-N`\n\nExample: `./install.sh -N mojave`\n\n## \u003cp align=\"center\"\u003e \u003cb\u003e Explore more customization features! \u003c/b\u003e \u003c/p\u003e\nYou can run `./install.sh -h` to explore more customization features we have\nlike changing panel opacity, theme opacity (normal and solid variant), window\ncontrol button variant, etc.\n\n# \u003cp align=\"center\"\u003e \u003cb\u003e Let's tweak! \u003c/b\u003e \u003c/p\u003e\nUsage:  `./tweaks.sh [OPTIONS...]`\n\n\u003cdetails\u003e \u003csummary\u003e Options \u003cb\u003e(click to open)\u003c/b\u003e \u003c/summary\u003e\n\n```bash\n\nOPTIONS:\n  -o, --opacity [normal|solid]\n   Set 'WhiteSur' GDM/Flatpak theme opacity variants. Default is 'normal'\n\n  -c, --color [light|dark]\n   Set 'WhiteSur' GDM/Flatpak theme color variants. Default is 'light'\n\n  -t, --theme [default|blue|purple|pink|red|orange|yellow|green|grey]\n   Set 'WhiteSur' GDM/Flatpak theme accent color. Default is BigSur-like theme\n\n  -s, --scheme [standard|nord]\n   Set 'WhiteSur' GDM/Flatpak theme colorscheme style. Default is 'standard'\n\n   \n Tweaks for GDM theme. options\n\n  -g, --gdm    Without options default GDM theme will install... \n\n      1. -i, -icon [apple|simple|gnome|ubuntu|tux|arch|manjaro|fedora|debian|void|opensuse|popos|mxlinux|zorin|budgie|gentoo]   Set GDM panel 'Activities' icon Default is 'standard'\n\n      2. -b, -background [default|blank|IMAGE_PATH]   Set GDM background image Default is BigSur-like wallpaper\n\n      3. -p, -panelopacity [default|30|45|60|75]   Set GDM panel transparency Default is 15%\n\n      4. -h, -panelheight [default|smaller|bigger]   Set GDM panel height size Default is 32px\n\n      5. -sf, -smallerfont    Set GDM font size to smaller (10pt) Default is 11pt\n\n      6. -nd, -nodarken    Don't darken 'WhiteSur' GDM theme background image \n\n      7. -nb, -noblur    Don't blur 'WhiteSur' GDM theme background image \n\n   \n Tweaks for firefox. options\n\n  -f, --firefox         [(monterey|flat)|alt|(darker|adaptive)]   Without options default WhiteSur theme will install...   Options:\n\n      1. monterey       [3+3|3+4|3+5|4+3|4+4|4+5|5+3|5+4|5+5]   Topbar buttons number: 'a+b'   a: left side buttons number, b: right side buttons number\n\n      2. flat           Monterey alt version    Flat round tabs...\n\n      3. alt            Alt windows button version    Alt windows button style like gtk theme\n\n      4. darker         Darker Firefox theme version    Darker Firefox theme version\n\n      5. nord           Nord Firefox colorscheme version    Nord Firefox colorscheme version\n\n      6. adaptive       Adaptive color version   You need install adaptive-tab-bar-colour plugin first   https://addons.mozilla.org/firefox/addon/adaptive-tab-bar-colour/\n\n  -e, --edit-firefox [(monterey|flat)|alt|(darker|adaptive)]\n   Edit 'WhiteSur' theme for Firefox settings and also connect the theme to the current Firefox profiles. \n\n   \n Others. options\n\n  -F, --flatpak Support options: [-o, -c, -t...]   Connect 'WhiteSur' theme to Flatpak Without options will only install default themes\n\n      1.  -o, --opacity [normal|solid]   Set 'WhiteSur' flatpak theme opacity variants Default is 'normal'\n\n      2.  -c, --color [Light|Dark]   Set 'WhiteSur' flatpak theme color variants Default is 'light'\n\n      3.  -t, --theme [default|blue|purple|pink|red|orange|yellow|green|grey]   Set 'WhiteSur' flatpak theme accent color Default is BigSur-like theme\n\n      4.  -s, --scheme [standard|nord]   Set 'WhiteSur' flatpak theme colorscheme style Default is 'standard'\n\n  -d, --dash-to-dock \n   Fixed Dash to Dock theme issue. \n\n  -r, --remove, --revert \n   Revert to the original themes, do the opposite things of install and connect. \n\n  --silent-mode \n   Meant for developers: ignore any confirm prompt and params become more strict. \n\n  -h, --help \n   Show this help. \n\n```\n\n\u003c/details\u003e\n\n## There's more themes you can try!\n### \u003cp align=\"center\"\u003e \u003cb\u003e Install and edit Firefox theme \u003c/b\u003e \u003c/p\u003e\n\n\u003cp align=\"center\"\u003e \u003ca href=\"src/other/firefox\"\u003e\n\u003cimg src=\"https://github.com/vinceliuice/WhiteSur-gtk-theme/blob/pictures/pictures/firefox.svg\"/\u003e\n\u003c/a\u003e \u003c/p\u003e\n\n#### - [Install Firefox theme](src/other/firefox)\nParameter: `--firefox` `-f`\n\nExample: `./tweaks.sh -f`\n\n#### - Edit Firefox theme\nParameter: `--edit-firefox` `-e`\n\nExample:\n\n```bash\n./tweaks.sh -e           # edit the installed Firefox theme\n./tweaks.sh -f -r        # remove installed Firefox theme\n./tweaks.sh -f monterey  # install Monterey Firefox theme\n```\n\n##\n\n### \u003cp align=\"center\"\u003e \u003cb\u003e Install and customize GDM theme \u003c/b\u003e \u003c/p\u003e\n\u003cp align=\"center\"\u003e \u003cimg src=\"https://github.com/vinceliuice/WhiteSur-gtk-theme/blob/pictures/pictures/gdm.png\"/\u003e \u003c/p\u003e\n\n#### - Install GDM theme\nParameter: `--gdm` `-g` (requires to be run as root)\n\nExample: `sudo ./tweaks.sh -g`\n\n#### - Change the background\nParameter: `--background` `-b`\n\nExample:\n\n```bash\nsudo ./tweaks.sh -g -b \"my picture.jpg\" # use the custom background\nsudo ./tweaks.sh -g -b default          # use the default background\nsudo ./tweaks.sh -g -b blank            # make it blank\n```\n\n#### - Don't darken the background\nParameter: `--nodarken` `-nd`\n\nExample:\n\n```bash\nsudo ./tweaks.sh -g -nd                          # darken the default background\nsudo ./tweaks.sh -g -nd -b \"wallpapers/snow.jpg\" # darken the custom background\n```\n\n#### - Don't blur the background\nParameter: `--noblur` `-nb`\n\nExample:\n\n```bash\nsudo ./tweaks.sh -g -nb                           # don't blur the default background\nsudo ./tweaks.sh -g -nb -b \"wallpapers/rocks.jpg\" # don't blur the custom background\n```\n\n#### - Do more GDM customizations\nYou can do [the similar customization features in `./install.sh`](#theres-so-many-customizations-you-can-do)\nlike changing theme color (dark and light variant) and accent, GNOME Shell\n'Activities' icon, etc. related to GDM. Run `./tweaks.sh -h` to explore!\n\n##\n\n### \u003cp align=\"center\"\u003e \u003cb\u003e Fix for Flatpak \u003c/b\u003e \u003c/p\u003e\n\n#### 1. Run command to fix it\n\n```sh\nsudo flatpak override --filesystem=xdg-config/gtk-3.0 \u0026\u0026 sudo flatpak override --filesystem=xdg-config/gtk-4.0\n```\n\nIf you use flatpak apps, you can run this to fix theme issue\n\n#### 2. Connect WhiteSur theme to Flatpak (gtk 3.0) (Snap not support)\n\nParameter: `--flatpak` `-F`\n\nExample: `./tweaks.sh -F`\n\n## \u003cp align=\"center\"\u003e \u003cb\u003e Other recommended stuff \u003c/b\u003e \u003c/p\u003e\n### \u003cp align=\"center\"\u003e \u003cb\u003e WhiteSur Icon Theme \u003c/b\u003e \u003c/p\u003e\n\u003cp align=\"center\"\u003e \u003ca href=\"https://github.com/vinceliuice/WhiteSur-icon-theme\"\u003e\n  \u003cimg src=\"https://github.com/vinceliuice/WhiteSur-gtk-theme/blob/pictures/pictures/icon-theme.png\"/\u003e\n\u003c/a\u003e \u003c/p\u003e\n\u003cbr\u003e\n\u003cp align=\"center\"\u003e \u003ca href=\"https://github.com/vinceliuice/WhiteSur-icon-theme\"\u003e\n  \u003cimg src=\"https://github.com/vinceliuice/WhiteSur-gtk-theme/blob/pictures/pictures/download-button.svg\"/\u003e\n\u003c/a\u003e \u003c/p\u003e\n\u003cbr\u003e\n\n### \u003cp align=\"center\"\u003e \u003cb\u003e WhiteSur Wallpapers \u003c/b\u003e \u003c/p\u003e\n\u003cp align=\"center\"\u003e \u003ca href=\"https://github.com/vinceliuice/WhiteSur-wallpapers\"\u003e\n  \u003cimg class=\"image\" src=\"https://github.com/vinceliuice/WhiteSur-gtk-theme/blob/pictures/pictures/wallpaper.gif\"/\u003e\n\u003c/a\u003e \u003c/p\u003e\n\u003cbr\u003e\n\u003cp align=\"center\"\u003e \u003ca href=\"https://github.com/vinceliuice/WhiteSur-wallpapers\"\u003e\n  \u003cimg src=\"https://github.com/vinceliuice/WhiteSur-gtk-theme/blob/pictures/pictures/download-button.svg\"/\u003e\n\u003c/a\u003e \u003c/p\u003e\n\u003cbr\u003e\n\n## Technical details and getting involved\nPlease go read [CONTRIBUTING.md](.github/CONTRIBUTING.md) for more info\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvinceliuice%2FWhiteSur-gtk-theme","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvinceliuice%2FWhiteSur-gtk-theme","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvinceliuice%2FWhiteSur-gtk-theme/lists"}