walogram

Generate telegram-desktop themes based on generated by wal or user defined colors.

In pair with wal creates telegram-desktop theme, which harmonizes with other programs using those colors. walogram can create theme based on user-defined colors and is not dependent on.

walogram is based on wal-telegram which will not be maintained soon in favor of it's rewrite in rust wal-telegram-rs. Note, that walogram is incompatible with wal-telegram and has flags similar to wal.

Installation

Arch and Arch-based distros

Install walogram-git package from the AUR.

Manual

Install dependencies:

• ImageMagick
• Info-Zip (optional, but generated themes will not contain background image)

Run make install (as root if needed) to install, make uninstall to remove.

Usage

Run wal before generation theme with walogram. After you can run walogram without options to generate theme using wal colors and background image.

Detailed documentation can be viewed in the man page with man walogram or walogram -h.

Applying theme

1. Navigate to Settings > Chat Settings and click on choose from file
2. Toggle hidden files visibility in right click menu
3. Navigate to and double click on ~/.cache/walogram/wal.tdesktop-theme file
4. Click on keep changes

Screenshots

Screenshot 1 Screenshot 2 Screenshot 3

Theme specification

If you want, you can import the colors from file that needs to be written in the following way:

color0="#282828"
color1="#cc241d"
color2="#98971a"
color3="#d79921"
color4="#458588"
color5="#b16286"
color6="#689d6a"
color7="#a89984"
color8="#928374"
color9="#fb4934"
color10="#b8bb26"
color11="#fabd2f"
color12="#83a598"
color13="#d3869b"
color14="#8ec07c"
color15="#ebdbb2"

Colors from 8 to 15 are optional. Example above contains gruvbox color scheme and generated from it theme can bee seen on the first screenshot and applied in telegram from t.me/addtheme/pywal.

Important note

Some color constants in constants file, which is a key part or theme generation are marked as untested, because I could not find elements responsible for them in the app. So if you find something strange open an issue (with a screenshot of the element and it's name if possible) and I will try to fix it.

Compatibility

walogram can work not only with pywal, but also it's "clones", such as regular wal or rust rewrite wallust.

To make walogram work with wallust add those lines to templates section of your ~/.config/wallust/wallust.toml:

shell-colors = { src = "colors.sh", dst = "~/.cache/wal/colors.sh", new_engine = true }
wallpaper-path = { src = "wallpaper", dst = "~/.cache/wal/wal", new_engine = true}

For wallust 3.0.0 and later you need to remove new_engine parameter.

~/.config/wallust/colors.sh:

color0="{{color0}}"
color1="{{color1}}"
color2="{{color2}}"
color3="{{color3}}"
color4="{{color4}}"
color5="{{color5}}"
color6="{{color6}}"
color7="{{color7}}"
color8="{{color8}}"
color9="{{color9}}"
color10="{{color10}}"
color11="{{color11}}"
color12="{{color12}}"
color13="{{color13}}"
color14="{{color14}}"
color15="{{color15}}"

~/.config/wallust/wallpaper:

{{wallpaper}}

License

walogram is free/libre software. This program is released under the MIT/X Consortium License, which you can find in the LICENSE file.