This is my desktop made with awesomewm! Here's some details:
- Operating System - endeavouros
- Window Manager - awesomewm
- File Manager - nemo
- Browser - librewolf
- Terminal - st
- Shell - bash
- Editor - vim
This installation script is built to hopefully make the installation process easier for you. I cannot guarantee that it will work; there may be missing packages and you may run into issues. If something is missing and/or doesn't work, I would recommend reading over the manual install instructions to find missing packages or steps. If that doesn't work, see contact.
Manual Installation
These packages use their names from the Arch repos and AUR. If you can't find them for your distribution, try using the source url from Arch repos.
- base-devel - utilities
- xorg - display server
- xclip - clipboard
- xorg-xprop - fetch dep
- xsettingsd - reload gtk/icons
- pipewire - audio
- brightnessctl - brightness
- inotify-tools - brightness widget dep
- awesome-git - window manager
- picom - compositor
- polkit-gnome - polkit
- xdg-user-dirs - generate home dirs
- maim - screenshot
- ttf-roboto - gtk font
- ttf-roboto-mono - mono font
- noto-fonts - general font support
- noto-fonts-cjk - cjk font support
- noto-fonts-emoji - emoji font support
- noto-fonts-extra - extra font support
- papirus-icon-theme - icon theme
- gvim - vim with clipboard
- librewolf - browser
- nemo - file manager
- network-manager-applet - network applet
- cbatticon - battery applet
- blueman - bluetooth applet
- copy contents of
hometo~/ - copy contents of
usr/shareto/usr/share - copy contents of
usr/binto/usr/bin - enable NetworkManager service (if network-manager-applet installed)
- update font cache
fc-cache -fv - update xrdb
xrdb ~/.Xresources - generate home dirs
xdg-user-dirs-update - make screenshots dir in
~/Pictures/Screenshots
Installation Script
First, you'll need to install the distribution of your choice. Currently supported distros are Arch-based, Debian-based, Fedora-based, Gentoo-based, Void, OpenSUSE, and Alpine. It's recommended to install xorg and pipewire manually prior to running the script. You will need to install git to clone the repository.
Other distributions are not officially supported and may be added in the future.
git clone https://github.com/stardust-kyun/dotfiles ~/dotfiles
cd ~/dotfiles
./install.sh
# Install with log
script -c ./install.sh ~/dotfiles-log.txt
Post-Install Setup
Since the minimal install doesn't include many programs/utilities, you'll need to install some before rebooting. I recommend installing a terminal, browser, file manager, and text editor.
This used to have a lot of stuff. Now most user variables are configured in a dedicated widget.
Keybindings
The file ~/.config/awesome/config/bind.lua contains awesome's keybindings:
| Keybinding | Description |
|---|---|
Mod+Shift+r |
Restart Awesome |
Mod+z |
Next Layout |
Mod+Shift+z |
Previous Layout |
Mod+Tab |
Focus Next Window |
Mod+Shift+Tab |
Focus Previous Window |
Mod+Space |
Show Menu |
Mod+d |
Show Launcher |
Mod+Shift+c |
Show Config |
Mod+Enter |
Open a Terminal |
Mod+p |
Kill Picom |
Mod+Shift+p |
Start Picom |
Mod+Delete |
Full Screenshot |
Mod+Ctrl+Delete |
Delayed Screenshot |
Mod+Shift+Delete |
Partial Screenshot |
Mod+1-6 |
Change Tag |
Mod+Ctrl+1-6 |
Move Client to Tag |
Mod+Shift+1-6 |
Move Client to Tag and Follow |
Mod+c |
Center Window |
Mod+f |
Toggle Fullscreen |
Mod+s |
Toggle Floating |
Mod+n |
Minimize Window |
Mod+m |
Toggle Maximize |
Mod+Shift+q |
Close Window |
Color Schemes
| Color | Hexcode |
|---|---|
| Background | #000f14 |
| Foreground | #a0a0b4 |
| Black | #0a191e |
| White | #a0a0b4 |
| Red | #824655 |
| Green | #468264 |
| Yellow | #827d50 |
| Blue | #326482 |
| Magenta | #645078 |
| Cyan | #327d7d |
| Color | Hexcode |
|---|---|
| Background | #fffaf5 |
| Foreground | #4b4646 |
| Black | #4b4646 |
| White | #ebe6e1 |
| Red | #eb8c8c |
| Green | #96e6a5 |
| Yellow | #f0cd96 |
| Blue | #9bb9f0 |
| Magenta | #d7a0e6 |
| Cyan | #a0e1d2 |
| Color | Hexcode |
|---|---|
| Background | #19191e |
| Foreground | #9999a8 |
| Black | #2b2b33 |
| White | #9999a8 |
| Red | #825a5a |
| Green | #5a825a |
| Yellow | #968264 |
| Blue | #505a82 |
| Magenta | #735a87 |
| Cyan | #5a7387 |
| Color | Hexcode |
|---|---|
| Background | #f0fafa |
| Foreground | #262626 |
| Black | #404040 |
| White | #dce6e6 |
| Red | #e68383 |
| Green | #a0e6af |
| Yellow | #ffcd96 |
| Blue | #83b4e6 |
| Magenta | #e1aae1 |
| Cyan | #8cd7d2 |
- AloneERO for help adding support for Void, Fedora, OpenSUSE, and Alpine!
- Frankfut for help adding support for Void and lots of help with debugging.
- Qwickdom for help adding support for Arch.
- Reverse for help adding support for Debian.
- Alyssa for help adding support for Gentoo.
- Crylia and Sammy for massive amounts of help learning awesomewm.
- Jimmy and Petrolblue for help with color schemes and lots of support.
You can find me on discord at stardustkyun, matrix at stardust-kyun:matrix.org, and email at stardust-kyun@proton.me. I also have a discord server with help available and updates for when new features are added.