This repository contains my personal dotfiles for an EndeavourOS Linux desktop setup, including a custom quickshell
configuration, various lightweight utilities, and desktop tweaks.
- fastfetch
- fuzzel
- ghostty
- mako
- niri
- quickshell
A waybar inspired quickshell config.
A minimalist bar written using quickshell, inspired by waybar. Intended to be used as a framework for easier quickshell adoptment.
- Minimal and modular configuration
- Easily extendable widget system
- Clean default theme
- Simple JSON-like syntax
Most customization and configuration can be done from just two seperate files, shell.qml
and GlobalConfig.qml
. Configs are simple and easy to read to users familiar with JSON and other like languages.
An example config:
/@ pragma UseQApplication
import QtQuick
import Quickshell
ShellRoot {
Bar {
height: 26
padding: 9
spacing: 6
leftItems: [
Network {},
Bluetooth {}
]
centreItems: [
NiriWorkspaces { command: ["niri", "msg", "action", "toggle-overview"]; }
]
rightItems: [
Tray {},
Clock {
format: "hh:mm"
},
Battery {}
]
}
}
Widgets are self-contained, in other words users do not need to add import statements to their configs to add new widgets; simply extract and add the widget to their shell.qml
.
- Install quickshell.
- Arch
yay -S quickshell
- Git clone this repository.
git clone https://github.com/rdnamil/dots.git
- Copy the quickshell folder to your config folder.
cp dots/config/quickshell ~/.config
- Run quickshell.
qs
This project is far from complete but I feel that it's at a stage now where it can be shared.
A couple of things still to do:
- refactor OSDs
- be able to change bar placement
- create more default widgets
This is by no means an exhaustive list and I will continue to fix/add things as I see the need.
Please share any comments, recommendations, or suggestions you may have. Also, if you've used this framework and created any bars or widgets, I'll happily link them here!