Walcord - (Pywal)ing every themes for Vencord/Vesktop/BetterDiscord

<p align="center">

<a href="https://github.com/Danrus1100/walcord/tree/main/examples">More themes examples</a>

</p> <p align="center"> <a href="https://aur.archlinux.org/packages/walcord"><img alt="Static Badge" src="https://img.shields.io/badge/AUR-2.10-blue"></a> <a href="https://github.com/Danrus1100/walcord/releases/download/2.5/walcord.exe"><img alt="Static Badge" src="https://img.shields.io/badge/Windows-2.5-green"></a> </p>

How to install from AUR

using yay:

yay -S walcord

using git:

git clone https://aur.archlinux.org/walcord.git
cd walcord
makepkg -si

How to install from releases:

Linux:

1. Download Pywal / Hellwal / wallust
2. Download a binary file
3. Сopy in /usr/bin/ directory:

sudo cp <path_to>/walcord /usr/bin
walcord

How to build frome source:

git clone https://github.com/Danrus1100/walcord.git
cd walcord
python -m venv .venv/
source .venv/bin/activate 
pip install -r requirements-<your-system>.txt --upgrade
pyinstaller walcord.spec
./dist/walcord

Usage cases:

1. Using Default theme (easiest way)

1. run a walcord command
2. select Walcord Default Theme in Vesktop

2. Overwrite a existing theme

First, you need to prepare a theme that will be used as the template for your theme (or you can just take ready for use theme frome examples). To do this, download the theme (or write to yourself), and replace the colors you want with KEY(key_name, opacity). script will replace the KEY with the css color code in rgba format:

/* template.css */

--some-var: KEY(1, 0.5);

/* theme.css */

--some-var: rgba(19,31,44,0.5)

The KEY syntax will be discussed in more detail here

After that, you can use this theme (or folder with themes) in walcord:

walcord -t <path/to/themes>

3 Use for other applications

Walcord doesn't care what type of file is given to it, so it can be used in many places. the limit of possibilities is your imagination! to save a style file in a certain directory use --output:

walcord -t <path-to-some-file.txt> -o <path-and/or-name-a-new-file>

You can also use the image you want, from which the colors will be taken, using --image:

walcord -i <path-to-image>

KEY's syntax

KEY() can take background, foreground and numbers from 0 to 15 as the first argument:

--bg-3: KEY(background);
--text-3: KEY(2)

you can also set the transparency of the color from 0 to 1 and use short names:

--accent-1: KEY(F, 0.75)
--hover: KEY(br, 1)

<details> <summary>All names of colors and they short vesions (click me)</summary>

• background: b
• foreground: f
• border: br (color 2)
• text: t (color 15)
• accent: a (color 13)
• wallpaper: w

</details>

If you only want values from KEY, individual colors, or HEX format, you can use the output modifiers:

/* template.css */

--accentcolor: KEY(a).rgb_values; 
--foo: KEY(T).r 

/* theme.css */

--accentcolor: 146,172,200; 
--foo: 216 

***

<details> <summary>All output parameters (click me)</summary>

• rgba = rgba(r, g, b, a)
• rgb = rgba(r, g, b)
• hex = #RRGGBB
• hsl = hsl(h, s, l)
• rgba_values = r,g,b,a
• rgb_values = r,g,b
• hex_values = RRGGBB
• hsl_values = h, s, l
• red / r = r
• green / g = g
• blue / b = b
• opacity / o = a
• hue / h = h
• saturation / s = s
• lightness / l = l

</details>

You can also add, subtract a numeric value from a certain parameter, or invert colors with second modifiers:

/* template.css */

KEY(a).rgb  
KEY(a).rgb.add(0, 50) 
KEY(a).rgb.invert 

/* theme.css */

rgb(146,172,200)
rgb(196,172,200)
rgb(109,83,55) 

<details> <summary>All second modifiers (click me)</summary>

• add / a (position, value)
• sub / s (position, value)
• invert / i no params

</details>

Tips and Tricks:

• You can use the --json argument if you want to use a different palette creation backend, such as Hellwal:

walcord -j ~/.cache/hellwal/colors.json

• You should specify only 1 argument in a secondary modifier, if it is primary modifiers, where it is subroutine that the result will be only one number:

/* template.css */

KEY(B).r.a(10) /* will be ok */
KEY(B).r.a(1, 10) /* will be okn't */
KEY(B).r

/* theme.css */

29
KEY(B).r.a(1, 10) /* walcord said: Add modificator takes 1 parameters (value). You gave 2 parameters, FIXME please. */
19

Special thanks

• danihek/Themecord: The Mastermind
• dylanaraps/pywal: without it, this project would not exist