/tsukiyomi

An elegant AwesomeWM configuration focused on beauty and a carefully crafted UI.

Primary LanguageLua

Tsukiyomi

An elegant AwesomeWM configuration focused on beauty. Comes with a carefully crafted UI, three colorschemes, and a couple of variables to tweak the interface to the user's likings. A WIP currently. You can see this repo as a hybrid between dotfiles and an AWM configuration, but it should be modular enough to only pick what you really plan to use.

WARNING: This configuration was not tested on other machines or OS's outside of mine, my code is also not perfect, since this is my first real attempt at AWM, the code may or may not work on your end, some things here need manual tweaking and errors may occur, procceed at your own caution, you've been warned.


Dependencies

Awesome-related, obligatory

WARNING 2: As of November 6 2023 you need to manually build awesome from source with this patch for this configuration to work, this is because of a small screen signal for properly setting wallpapers, everything else can be used as is

Music related, optional

  • mpd
  • playerctl
  • mpDris2
  • ncmpcpp
  • clematis

Misc Software

  • picom (optional)
  • bluez (optional)
  • maim, xclip, slop (obligatory)
  • IBM Plex Sans (optional) and/or any Nerd Font
  • Pipewire and Wireplumber (obligatory)
  • nemo (optional)

Your suite of apps can be swapped out with relative ease, but if you want to use exactly what i have, siduck's build of st, my custom neovim configuration and firefox.


Features

Tsukiyomi has a powerful user configuration in which you can tweak things like:

  • Colorscheme
  • Suite of apps
  • Font and icon theme
  • UI elements (gaps, spacing, borders)
  • Toggleable UI elements and signals
  • Accent color
  • Layouts and tags
  • Wallpaper, avatar, home icon
  • Dock widget
  • Vertical bar
  • Titlebars
  • Modkeys

And other aspects can also be tweaked outside of user configuration, like keybinds and scratchpads.


File structure

  • assets: images and svgs

  • base: keybinds, autostart, scratchpad config

  • modules: external libraries

  • signals: for awm signals

  • theme: theme variables and colorschemes

  • widget: bar, launcher, notifications, titlebar config and others

  • helpers.lua: helper functions

  • user.lua: user configuration

  • rc.lua: file that loads everything


Keybinds

  • Super + Return opens a terminal.
  • Super + / shows the keybinds.

TODO

  • Control center widget
  • Better keybinds popup
  • Overall cleanup of code

Gallery

Colorschemes

biscuit oxocarbon sakura camellia adwaita latte catppuccin fullerene


Credits

  • Stardust kyun's Sakura dotfiles and support, since they gave me the courage needed to tackle this project and also some sweet reference for how to do things, also the nice colorscheme
  • Gwynsav's gwdawful and gwileful rices, from which I borrowed some code, widgets and insight on how to execute ideas
  • Chadcat's Crystal rice, for the battery and dock widgets
  • Ner0z's dotfiles for the music widget
  • Garado's script for changing nvim themes
  • The Unixporn discord server for a lot of insight and troubleshooting
  • Nyoom for the oxocarbon colorscheme
  • Sinomor's dotfiles for some helper functions and the execution of inner and outer gaps
  • My mom, she's very cool