Note
AI has been used a bit in this project but all design choices were done by me. Click here for more info
Cross-platform
- starship
- kitty/termux
- dunst
- fontconfig
- micro
| X11 | Wayland |
|---|---|
| i3 | niri |
| polybar | waybar |
| dmenu | rofi (defaults) |
| feh | swaybg |
| picom | built-in |
- Semi-minimalist style with a lot of roundness, thick borders, some transparency and blur
- Fresh green color scheme with many shades.
- Config files that are easy to modify
- Nice wallpapers of nature that change depending on the time of day
- Quick and clean custom animations
- Compositor shadows, blur and transparency
- Top bar with system info created using polybar
- Polybar module that lists the amount of packages to upgrade (Only apt, pacman, zypper and dnf)
- A separate bar for workspaces on the second screen made with a custom program
- Many custom scripts
- Modified version of dmenu included in the bin/ directory (x86_64 only)
- Smooth shadows, blur, transparency and animations
- Bar with an experimental design style and the same information as X11
- Tab indicators and notifications that are colored after the app icon
- Some windows moving slightly up and down
- Everything under Cross-platform applies here too
- All keybinds follow simple patterns such as all system shortcuts starting with super.
- The keybinds are made so that they can work if you have a single hand on the keyboard and the other on the mouse or both hands on the keyboard.
- Windows can be moved or focused with
Super+↑/←/↓/→orw/a/s/d. - Resizing is done with
Super++/-andSuper+Shift++/- - The terminal is opened with
Super+Enter, Firefox withSuper+Shift+Enterand the launcher withSuper+i - You can focus on the left monitor with
Ctrl+Super+Leftand on the right withCtrl+Super+Right
Please read the Niri or i3 configs to learn more
Warning
Back up your existing ~/.config and /etc/fonts first.
You can install it with sh install.sh, manually or sh autoinstall.sh (ONLY DO THE LAST ONE IF YOU READ THE SCRIPT).
- Copy all of the contents of the cross-platform directory into
~/.config - If you want to use X11, also copy all of the contents of the
xorgdirectory into~/.config - If you want to use Wayland, also copy all of the contents of the
waylanddirectory into~/.config - Put scripts into
~/scripts - (Currently X11-only) Copy all contents of the
bin/directory into~/.local/bin(per-user) or/usr/bin(REQUIRES SUDO) (if you don't trust me with the binaries, you can build them yourself. All source files are included and there's a building section in this readme) - Put the contents of
pictures/into~/Pictures/Important/ - Add the contents of
.bashrcto your~/.bashrc(needed for the command prompt to work)
(For other shells follow https://starship.rs/guide/#step-2-set-up-your-shell-to-use-starship)
Note
I recommend modifying niri and i3 files to reflect your monitor setup
Note
The c++ scripts and dmenu are prebuilt only for x86_64. If you use another architecture please compile the programs yourself. More info here
The .sh scripts are made for bash and might require some modifications for other shells
A nerd font is heavily recommended. You can find some at https://www.nerdfonts.com/font-downloads.
Your main font needs to be monospace
I personally use and recommend Departure Mono but it is a pixel font.
Put the nerd font into /etc/fonts/font-name (REQUIRES SUDO) or .fonts (Only for one user)
Optionally, copy the local.conf to /etc/fonts/local.conf (REQUIRES SUDO)
(This assumes you are using Departure Mono, otherwise you have to modify the file)
Both: Starship, kitty, dunst, micro-editor
X11: i3wm/i3 (4.22 or newer, or i3-gaps on older distros), i3bar, picom, polybar, feh, nvidia-smi (optional), activitywatch (optional)
Wayland: niri, waybar, swaybg, rofi
Building (optional): nlohmann_json-devel (workspace-bar), g++, make (dmenu), xlib, xft and xinerama headers (dmenu)
On opensuse you can automatically install them with bash opensuse-dependencies.sh
You have to modify the config files manually, although they are fairly simple.
Some resources I'd recommend are the wikis for each project, such as:
niri polybar starship, man pages dunst and the i3wm userguide.
Note
I only included apps that I feel like I've fully riced and the rice is up to date enough or has roughly the same style as my other apps. Also most settings aren't perfect because I don't have much time for ricing. I am planning to add a firefox config and rice rofi, sddm and fastfetch and update the superfile config in the future. And make the picom animation for resize smoother and make one for moving. Also add a color one and maybe add dimming to open and close. Also add blesh and make dunst an exception for picom
Please open an issue if something is broken. Format the issue however you want.
I generally don't accept pull requests, but I'd welcome AMD/Intel GPU support.
Feature requests are fine.
Optional, the files are included pre-built for x86_64
For c++ files (with the .cpp ending) such as chlebqowy-workspace-bar.cpp and chlebqowy-update-num.cpp, run g++ file.cpp -o file, for example
g++ src/chlebqowy-workspace-bar.cpp -o bin/chlebqowy-workspace-bar
g++ src/chlebqowy-update-num.cpp -o bin/chlebqowy-update-num
g++ src/chlebqowy-gpu-usage.cpp -o bin/chlebqowy-gpu-usage
(cd src/dmenu && make && mv dmenu ../../bin/dmenu)Make sure you have the dependencies required for building
dmenu_run and dmenu_path is not provided here but you can get it from the upstream as they haven't been changed
- i3wm for getting me into ricing
- Unsplash for the photos
- Suckless for the upstream dmenu
- Every project for which configs I included
ChatGPT and Claude for helping me when I couldn't find docs, so:
fontconfig, new picom syntax, and getting the i3 IPC
and to troubleshoot waybar and niri
This readme hasn't been AI generated but I've had a model proofread it.
MIT for the configs, scripts and my code
The Unsplash license for pictures
The dmenu license for the dmenu fork