https://github.com/pop-os/gtk-theme
System76 Pop GTK+ Theme
https://github.com/pop-os/gtk-theme
Last synced: about 1 month ago
JSON representation
System76 Pop GTK+ Theme
- Host: GitHub
- URL: https://github.com/pop-os/gtk-theme
- Owner: pop-os
- License: gpl-3.0
- Created: 2017-08-02T15:37:04.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2024-08-16T16:55:31.000Z (over 1 year ago)
- Last Synced: 2025-05-11T03:42:26.491Z (10 months ago)
- Language: SCSS
- Homepage:
- Size: 28.1 MB
- Stars: 795
- Watchers: 30
- Forks: 80
- Open Issues: 30
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: COPYING
- Code of conduct: CODE_OF_CONDUCT.md
- Authors: AUTHORS
Awesome Lists containing this project
- awesome-github-repos - pop-os/gtk-theme - System76 Pop GTK+ Theme (SCSS)
README
-------------------
A GTK+ theme for Pop!_OS
### Required Components
-------------------
Pop supports Gtk+ 3.22.x
```
* Gtk+-3.0 >= 3.22
* Gtk+-2.0 >= 2.24.30
* gtk2-engines-pixbuf >= 2.24.30
* gtk2-engines-murrine >= 0.98.1
```
### Recommendations
- For GTK, use icons alongside [Pop Icon Theme](https://github.com/pop-os/icon-theme)
- For fonts, use:
> Window Titles: Fira Sans SemiBold 10
> Interface: Fira Sans Book 10
> Documents: Roboto Slab Regular 11
> Monospace: Fira Mono Regular 11
### Installation
Pop is intended to be installed through the package manager. Packages for Pop are available in PPA:
```
sudo add-apt-repository ppa:system76/pop
sudo apt update
sudo apt install pop-theme
```
It's recommended to use the `pop-theme` metapackage, as this will pull in all components of the look. However, individual components can be installed separately, e.g:
```
sudo apt install pop-gtk-theme
```
It's also recommended to restart the GNOME Shell after applying the theme of your choice.
Enter the Shell's command launcher
```
Alt + F2
```
This will restart the Shell after you hit Enter
```
r
```
### Installation from Git Source
----------------------------
This is the recommended method for users who aren't on Pop.
###### Note: You must have sassc installed in order to build Pop. Users of 17.04 or later can all build-dependencies using:
```
sudo apt install sassc meson libglib2.0-dev
```
For making modifications to assets, you will additionally need these two:
```
sudo apt install inkscape optipng
```
1. If previous versions were installed/existed, remove them first.
```
sudo apt remove pop-gtk-theme
sudo rm -rf /usr/share/themes/Pop*
rm -rf ~/.local/share/themes/Pop*
rm -rf ~/.themes/Pop*
```
2. Clone the repository.
```
git clone https://github.com/pop-os/gtk-theme.git
cd gtk-theme
```
3. Generate the theme files.
```
meson build && cd build
ninja
```
4. Install the theme.
```
ninja install
```
#### Rebuilding after modifications:
You shouldn't need to rebuild the entire theme after modifications. If you make
changes to any GTK3 or GTK2 assets, delete the old rendered copies and use the
`render-assets.sh` script to regenerate those with new ones with your
modifications.
TODO
----
* Prepare for Steam theming (priority: Low)
Public License
--------------
Most files: GPL-3.0+
Upstream Adwaita: LGPLv2.1
Sound theme: CC-BY-SA-4.0
> **Note:**
>
> SVG files are licensed under CC BY-SA 4.0
Special Thanks to
--------------
Nana-4, the developer of Materia.
tista500 and the Adapta Theme Project: https://github.com/adapta-project/