Compare commits

...

40 Commits

Author SHA1 Message Date
Himanshu
5b6c477850 chore: update colloid submodule
chore: update colloid submodule
2024-04-01 23:27:44 +05:30
ghostx31
4f4501f83b chore: update colloid submodule 2024-04-01 23:15:54 +05:30
Alyx
8d9803f089 docs(README.md): update nixos instructions (#146) 2024-03-14 23:36:16 +00:00
Sahil Nihalani
26b0d12b1b docs: add GDM instructions (#21) 2024-02-24 21:28:45 +05:30
rubyowo
5b043b61c6 docs: slimmer warning 2024-02-24 18:43:24 +04:00
rubyowo
3b802c6b03 docs: add gdm warning 2024-02-24 18:39:54 +04:00
rubyowo
939386a30a docs: add GDM instructions
Closes #21.
2024-02-24 18:18:28 +04:00
Mood
e279ceffca docs: add gtk4 symlink instructions for Nix (#151)
Co-authored-by: winston <hey@winston.sh>
2024-02-24 12:51:41 +00:00
backwardspy
c577226e9c fix(install): pin catppuccin to <2.0.0 (#153) 2024-02-20 18:26:22 +01:00
ghostx31
76cccfa215 chore: update colloid 2023-11-16 18:42:45 +05:30
ghostx31
9082969c1c docs: remove murrine-engine requirement 2023-10-05 20:12:40 +05:30
Pranav Nedungadi
f3faf6d9da Merge pull request #120 from iruzo/main
docs: add window manager guide
2023-10-05 15:51:12 +05:30
Pranav Nedungadi
761a075ca9 Merge pull request #121 from D3faIt/patch-1
docs: added cd, reworded text in README.md
2023-10-05 15:49:47 +05:30
ghostx31
9849cea54f fix: Gnome 45 issues 2023-10-01 20:13:44 +05:30
Dixon Sean Low Yan Feng
0f516404fd docs(nix): update theme name capitalization again (#122)
This reverts commit eb7ed7ab2c.

f13a2b2 changed the naming convention for the theme names again so that
the theme style (dark or light) is capitalized again. The docs were
updated accordingly for Home Manager.

However, eb7ed7a changed the documentation for Home Manager back to the
non-capitalized names. This was likely because the capitalization change
had not made its way to `nixos-unstable`. The change has now made it to
`nixos-unstable`, so this commit reverts eb7ed7 to reflect the
capitalization.
2023-10-01 14:10:55 +02:00
D3faIt
23a48d8b81 fix README.md
Added `cd` to "using the script" instructions. Reworded some text
2023-09-23 13:39:28 +02:00
ruzo
03376d1003 docs: add window manager guide 2023-09-16 17:30:34 +02:00
Pranav
5255501faf chore: script: update colloid
Signed-off-by: Pranav <npv12@iitbbs.ac.in>
2023-09-07 00:41:39 +05:30
Himanshu
1897b09f23 fix(docs): theme name in README (home-manager)
fix theme name in readme
2023-08-13 11:35:13 +05:30
éclairevoyant
eb7ed7ab2c fix theme name in readme 2023-08-13 00:28:02 -04:00
Pranav Nedungadi
831a06c672 Merge pull request #104 from bagelwaffle/patch-1
docs: minor fixes
2023-08-04 20:18:17 +05:30
Pranav
f13a2b2e08 Revert "fix: do not capitalise theme style"
* stay inline with upstream

This reverts commit 3fc72208de.

Signed-off-by: Pranav <npv12@iitbbs.ac.in>
2023-08-04 14:26:44 +05:30
Pranav
a40e058320 chore: update colloid version
Signed-off-by: Pranav <npv12@iitbbs.ac.in>
2023-08-04 14:25:34 +05:30
Pranav Nedungadi
d6d1e951e4 Merge pull request #105 from avanderbergh/issue99
Use correct for `theme_style` case in Readme.md
2023-07-04 13:33:18 +05:30
Adriaan van der Bergh
59a26aa3cd Fix readme 2023-07-04 07:32:14 +00:00
Bagel Waffle
dbcaeb738f docs: small fixes 2023-07-01 16:09:29 -07:00
Bagel Waffle
50203b06bb docs: fixed capitalization of "It's FOSS" 2023-07-01 15:54:32 -07:00
Pranav
329e522c08 chore: update colloid
Signed-off-by: Pranav <npv12@iitbbs.ac.in>
2023-06-21 19:16:02 +05:30
Pranav
3fc72208de fix: do not capitalise theme style
fixes #100

Signed-off-by: Pranav <npv12@iitbbs.ac.in>
2023-06-21 19:15:34 +05:30
Pranav
b75165df4d feat: Enable option for float panel
Signed-off-by: Pranav <npv12@iitbbs.ac.in>
2023-06-03 08:42:16 +05:30
Pranav
1a5f20809a chore: update colloid 2023-06-03 08:41:01 +05:30
Pranav
5c05af916a chore: update colloid
Signed-off-by: Pranav <npv12@iitbbs.ac.in>
2023-05-21 15:03:46 +05:30
spooky
19d4e9cd5b docs(README): fix install instructions for --link 2023-05-02 15:43:46 +05:30
bronsen
d5f542f484 docs(README): fix long option for linking gtk-4.0
The install script actually uses `--link` as long option for linking
gtk-4.0 themes.
2023-05-02 10:59:45 +02:00
Pranav
0997e92071 chore: update index.theme theme name correctly
fixes #90

Signed-off-by: Pranav <npv12@iitbbs.ac.in>
2023-04-16 16:25:50 +05:30
Pranav
d11e6465bd chore: update colloid
Signed-off-by: Pranav <npv12@iitbbs.ac.in>
2023-04-14 15:59:42 +05:30
Pranav
6c350cc3eb chore: update colloid
fixes #81

Signed-off-by: Pranav <npv12@iitbbs.ac.in>
2023-04-12 10:56:41 +05:30
Pranav
7c470654a7 workflow: recreate assets
Signed-off-by: Pranav <npv12@iitbbs.ac.in>
2023-03-26 17:03:39 +05:30
Pranav
50e9e0120b fix: script: do not fail if supplementing a theme name
fixes #76

Signed-off-by: Pranav <npv12@iitbbs.ac.in>
2023-03-26 16:55:15 +05:30
Pranav
f2b5321c23 fix: Do not generate assets for all types.
Signed-off-by: Pranav <npv12@iitbbs.ac.in>
2023-03-26 16:43:20 +05:30
7 changed files with 131 additions and 44 deletions

View File

@@ -23,7 +23,7 @@ jobs:
- name: Install colloid specific dependencies
run: sudo apt update && sudo apt install -y sassc inkscape optipng
- name: Generate themes
run: python ./install.py all -a all --zip -d $PWD/releases
run: python ./install.py all -a all --zip -d $PWD/releases --recreate-asset
- name: Add zips to release
uses: softprops/action-gh-release@v1
with:

3
.gitignore vendored
View File

@@ -3,6 +3,9 @@ pkgs/
__pycache__
venv/
.venv
bin/
lib*/
*.cfg
# Releases folder
releases

148
README.md
View File

@@ -23,44 +23,54 @@ This GTK theme is based on the [Colloid](https://github.com/vinceliuice/Colloid-
### Requirements
- GTK `>=3.20`
- `gnome-themes-extra` (or `gnome-themes-standard`)
- Murrine engine
- GTK `>=3.20`
- `gnome-themes-extra` (or `gnome-themes-standard`)
### Installation
1. Download and extract the theme zip from [releases](https://github.com/catppuccin/gtk/releases/) or you can install the theme from the [AUR](#for-arch-linux-users).
1. Download and extract the theme zip from [releases](https://github.com/catppuccin/gtk/releases/).
2. Move the theme folder to **".themes"** in your home directory. **(~/.themes)** (Skip this step if you are using the AUR package)
3. Select the downloaded theme via your desktop specific tweaks application (**gnome-tweaks** on Gnome 3+).
### For Arch Linux users
We have 4 AUR packages for all the 4 flavours of the theme:
- [Latte](https://aur.archlinux.org/packages/catppuccin-gtk-theme-latte)
- [Frappe](https://aur.archlinux.org/packages/catppuccin-gtk-theme-frappe)
- [Macchiato](https://aur.archlinux.org/packages/catppuccin-gtk-theme-macchiato)
- [Mocha](https://aur.archlinux.org/packages/catppuccin-gtk-theme-mocha)
With your favourite AUR helper, install them:
```bash
yay -S catppuccin-gtk-theme-mocha catppuccin-gtk-theme-macchiato catppuccin-gtk-theme-frappe catppuccin-gtk-theme-latte
```
```bash
yay -S catppuccin-gtk-theme-mocha catppuccin-gtk-theme-macchiato catppuccin-gtk-theme-frappe catppuccin-gtk-theme-latte
```
### For Nix users
The [catppuccin-gtk](https://github.com/NixOS/nixpkgs/blob/master/pkgs/data/themes/catppuccin-gtk/default.nix) package in Nixpkgs allows you to specify the accents, size, tweaks and variant (flavour) of the theme by overriding the package.
By default, the variant is `frappe`, the accent is `blue`, the size is `standard`, and no tweaks are enabled. To change them, override the package. A list of valid choices are available in the package definition [here](https://github.com/NixOS/nixpkgs/blob/7ce8e7c4cf90492a631e96bcfe70724104914381/pkgs/data/themes/catppuccin-gtk/default.nix#L16).
Example:
```nix
pkgs.catppuccin-gtk.override {
accents = [ "pink" ]; # You can specify multiple accents here to output multiple themes
size = "compact";
tweaks = [ "rimless" "black" ]; # You can also specify multiple tweaks here
variant = "macchiato";
}
# as per wiki examples
environment.systemPackages = with pkgs; [
...
(catppuccin-gtk.override {
accents = [ "pink" ]; # You can specify multiple accents here to output multiple themes
size = "compact";
tweaks = [ "rimless" "black" ]; # You can also specify multiple tweaks here
variant = "macchiato";
})
...
];
```
To use it in home-manager:
```nix
# home.nix
{
@@ -80,11 +90,19 @@ To use it in home-manager:
};
};
}
# Now symlink the `~/.config/gtk-4.0/` folder declaratively:
xdg.configFile = {
"gtk-4.0/assets".source = "${config.gtk.theme.package}/share/themes/${config.gtk.theme.name}/gtk-4.0/assets";
"gtk-4.0/gtk.css".source = "${config.gtk.theme.package}/share/themes/${config.gtk.theme.name}/gtk-4.0/gtk.css";
"gtk-4.0/gtk-dark.css".source = "${config.gtk.theme.package}/share/themes/${config.gtk.theme.name}/gtk-4.0/gtk-dark.css";
};
```
### For gtk-4.0 users
### For GTK 4 users
To theme GTK 4 applications you have to manually symlink the `~/.config/gtk-4.0/` to the themes folder. Use the following commands
To theme gtk-4.0 applications you have to manually symlink the `~/.config/gtk-4.0/` to the themes folder. Use the following commands
```bash
mkdir -p "${HOME}/.config/gtk-4.0"
ln -sf "${THEME_DIR}/gtk-4.0/assets" "${HOME}/.config/gtk-4.0/assets"
@@ -95,30 +113,84 @@ ln -sf "${THEME_DIR}/gtk-4.0/gtk-dark.css" "${HOME}/.config/gtk-4.0/gtk-dark.css
### For Flatpak users
1. To give your Flatpaks access to your themes folder run:
```bash
sudo flatpak override --filesystem=$HOME/.themes
```
```bash
sudo flatpak override --filesystem=$HOME/.themes
```
2. To set the theme for all Flatpaks, replace `##theme##` with the name of the theme you want to use and run this command:
```bash
sudo flatpak override --env=GTK_THEME=##theme##
```
3. For a more in depth tutorial see Hamza Algohary's tutorial on [It's Foss](https://itsfoss.com/flatpak-app-apply-theme/)
```bash
sudo flatpak override --env=GTK_THEME=##theme##
```
3. For a more in depth tutorial see Hamza Algohary's tutorial on [It's FOSS](https://itsfoss.com/flatpak-app-apply-theme/)
### Handling GTK theme installation from window manager
1. Install unzip and curl.
2. Go to your window manager config file.
3. Add an entrance to the config file to be executed when your window manager is loaded.
- i3/sway example:
```
# catppuccin
set $ctp-version v0.6.1
exec_always if [ ! -e ~/.themes/Catppuccin-Frappe-Standard-Lavender-dark ]; then \
mkdir -p ~/.themes \
&& curl -L https://github.com/catppuccin/gtk/releases/download/$ctp-version/Catppuccin-Frappe-Standard-Lavender-dark.zip -o ~/.themes/catppuccin.zip \
&& unzip ~/.themes/catppuccin.zip -d ~/.themes/ \
&& rm -rf ~/.themes/catppuccin.zip; fi
```
> Note: The previous example execute that script every time i3/sway is reloaded.
4. Set the GTK_THEME environment variable:
```sh
export GTK_THEME='Catppuccin-Frappe-Standard-Lavender-dark:dark'
```
> [!NOTE]
> in order to update the theme's version, just change the variable `$ctp-version`.
### GDM Theme
> [!WARNING]
> Applying a custom theme to GDM is not recommended as it is not themeable, however you can do it through certain *hacks*.
To apply the theme to GDM, A new `gnome-shell-theme.gresource.xml` needs to be complied.
To achieve this, you can run the following:
```bash
# Backup the current gresource file.
sudo cp -av /usr/share/gnome-shell/gnome-shell-theme.gresource{,~}
sudo glib-compile-resources --target="/usr/share/gnome-shell/gnome-shell-theme.gresource" --sourcedir="$THEME_DIR" "$THEME_DIR/gnome-shell-theme.gresource.xml"
```
Make sure to replace `$THEME_DIR` to where the theme was extracted accordingly.
- For nix users, it'll be the nix store path of the package.
- For AUR users, it'll be in `~/.themes`
- Otherwise, it'll be wherever you extracted the theme.
### Using the script
**Note**: Ensure that you have atleast python version 3.10 installed
**Note**: Ensure that you have at least Python version 3.10 installed
Set up the installer using
Clone the repository using
```bash
git clone --recurse-submodules git@github.com:catppuccin/gtk.git
cd gtk
virtualenv -p python3 venv # to be created only once and only if you need a virtual env
source venv/bin/activate
source venv/bin/activate
pip install -r requirements.txt
```
To check out the install script, run
To check out the install script, run
```bash
python install.py --help
```
> Tip: `python install.py --help` allows the following options:
```
@@ -128,20 +200,25 @@ Compulsory field Specify color variant(s) [mocha|frappe|macchiato|latte|a
-a, --accent VARIANT... Specify theme color variant(s) [rosewater|flamingo|pink|mauve|red|maroon|peach|yellow|green|teal|sky|
sapphire|blue|lavender|all] (Default: blue)
-s, --size VARIANT... Specify size variant [standard|compact] (Default: standard variant)
-l, --libadwaita Link installed gtk-4.0 theme to config folder for all libadwaita app use this theme
--zip Zips up the finally produced themes.
--tweaks Specify versions for tweaks [black|rimless|normal]
-l, --link Link installed gtk-4.0 theme to config folder for all libadwaita app use this theme
--zip Zips up the finally produced themes.
--tweaks Specify versions for tweaks [black|rimless|normal|float]
1. black: Blackness color version
2. rimless: Remove the 1px border about windows and menus
3. normal: Normal windows button style (titlebuttons: max/min/close)
4. float: Floating gnome-shell panel style
-h, --help Show help
```
You can install any theme like the following example
```bash
python install.py mocha -a sky --tweaks rimless -d ~/.themes
```
You can build all possible variations of the theme possible using the following command and it will install it to releases folder
```bash
python install.py all -a all
```
@@ -149,6 +226,7 @@ python install.py all -a all
## Development
You need to install the following packages to build the theme. Check with your distribution for the package names in the repository
- `sassc`
- `inkscape`
- `optipng`
@@ -156,20 +234,24 @@ You need to install the following packages to build the theme. Check with your d
A few important notes to keep in mind
- `recolor.py` handles all changes that needs to be done to colloid to ensure it generated catppuccin colors. If vinceliuice changes anything in his theme in future, that is where you must change
- `var.py` includes all different variables that you can tinker around as per your personal requirements.
- `create_theme.py` consists of a wrapper that will recolor the colloid theme, install it as per the args provided and rename it accordingly.
- `var.py` includes all different variables that you can tinker around as per your personal requirements.
- `create_theme.py` consists of a wrapper that will recolor the colloid theme, install it as per the args provided and rename it accordingly.
## 💝 Thanks to
**Current maintainers**
- [npv12](https://github.com/npv12)
- [ghostx31](https://github.com/ghostx31)
- [Syndrizzle](https://github.com/Syndrizzle)
**Contributions**
- [rubyowo](https://github.com/rubyowo) - for working on the build and CI script
- [rubyowo](https://github.com/rubyowo) - CI and docs
- [braheezy](https://github.com/braheezy) - Instructions for the GDM theme.
**Previous maintainer(s)**
- [sadrach-cl](https://github.com/sadrach-cl)
&nbsp;

Submodule colloid updated: 6ddd8e1932...6cf7ea0237

View File

@@ -59,7 +59,7 @@ parser.add_argument("--tweaks",
default=[],
nargs="+",
dest="tweaks",
choices=["black", "rimless", "normal"],
choices=["black", "rimless", "normal", "float"],
help="Some specifc tweaks. like black, rimless, normal buttons")
parser.add_argument("-l", "--link",
@@ -79,7 +79,7 @@ parser.add_argument("--zip",
parser.add_argument("--recreate-asset",
help="Recreate assets for xfwm4 and such",
type=bool,
default=True,
default=False,
action=argparse.BooleanOptionalAction,
dest="rec_asset")

View File

@@ -1 +1 @@
catppuccin>=1.1.1
catppuccin>=1.1.1,<2.0.0

View File

@@ -6,12 +6,12 @@ from typing import List
from scripts.ctp_colors import ctp_colors
from scripts.patches import recreate_xfwm4_assets
from scripts.recolor import recolor
from scripts.utils import zip_multiple_folders
from scripts.utils import replacetext, zip_multiple_folders
from scripts.var import def_color_map, repo_dir, src_dir, theme_name, work_dir
def create_theme(types: List[str], accents: List[str], dest: str, link: bool = False,
name: str = theme_name, size: str = "standard", tweaks=[], zip = False, recreate_assets = True) -> None:
name: str = theme_name, size: str = "standard", tweaks=[], zip = False, recreate_assets = False) -> None:
try:
os.makedirs(dest) # Create our destination directory
@@ -19,11 +19,12 @@ def create_theme(types: List[str], accents: List[str], dest: str, link: bool = F
pass
for type in types:
if recreate_assets:
recreate_xfwm4_assets(type)
for accent in accents:
# Recolor colloid wrt our selection like mocha. latte
recolor(ctp_colors[type], accent)
if recreate_assets:
recreate_xfwm4_assets(type)
theme_style: str = "light" if type == "latte" else "dark"
install_cmd: str = f"./install.sh -c {theme_style} -s {size} -n {name} -d {dest} -t {def_color_map[accent]}"
if tweaks:
@@ -38,8 +39,8 @@ def create_theme(types: List[str], accents: List[str], dest: str, link: bool = F
try:
# Rename colloid generated files as per catppuccin
new_filename = dest + \
f"/{theme_name}-{type.capitalize()}-{size.capitalize()}-{accent.capitalize()}-{theme_style.title()}"
filename = f"{theme_name}"
f"/{name}-{type.capitalize()}-{size.capitalize()}-{accent.capitalize()}-{theme_style.title()}"
filename = f"{name}"
if def_color_map[accent] != 'default':
filename += f"-{def_color_map[accent].capitalize()}"
filename += f"-{theme_style.capitalize()}"
@@ -56,6 +57,7 @@ def create_theme(types: List[str], accents: List[str], dest: str, link: bool = F
os.rename(dest + "/" + filename + '-xhdpi',
new_filename + '-xhdpi')
os.rename(dest + "/" + filename, new_filename)
replacetext(new_filename + '/index.theme', filename, new_filename.split("/")[-1])
print("Successfully renamed file")
except Exception as e:
print("Failed to rename the files due to:", e)