Skip to content
ChlebqowyPublic

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

Chlebqowy Dotfiles

i3 (X11) screenshot Niri (Wayland) screenshot

Note

AI has been used a bit in this project but all design choices were done by me. Click here for more info

Currently includes

Cross-platform

  • starship
  • kitty/termux
  • dunst
  • fontconfig
  • micro
X11 Wayland
i3 niri
polybar waybar
dmenu rofi (defaults)
feh swaybg
picom built-in

Features

Cross-platform

  • 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

X11

  • 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)

Wayland

  • 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

Keybinds

  • 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.

Essential shortcuts:

  • Windows can be moved or focused with Super + ↑/←/↓/→ or w/a/s/d.
  • Resizing is done with Super + + / - and Super + Shift + + / -
  • The terminal is opened with Super + Enter, Firefox with Super+Shift+Enter and the launcher with Super + i
  • You can focus on the left monitor with Ctrl + Super + Left and on the right with Ctrl + Super + Right

Please read the Niri or i3 configs to learn more

How to install

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).

  1. Copy all of the contents of the cross-platform directory into ~/.config
  2. If you want to use X11, also copy all of the contents of the xorg directory into ~/.config
  3. If you want to use Wayland, also copy all of the contents of the wayland directory into ~/.config
  4. Put scripts into ~/scripts
  5. (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)
  6. Put the contents of pictures/ into ~/Pictures/Important/
  7. Add the contents of .bashrc to 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

Fonts

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)

Dependencies

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

Configuration

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

Contributing

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.

Building

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

Credits

  • i3wm for getting me into ricing
  • Unsplash for the photos
  • Suckless for the upstream dmenu
  • Every project for which configs I included

AI Disclosure

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.

License

MIT for the configs, scripts and my code
The Unsplash license for pictures
The dmenu license for the dmenu fork

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages