Quickshell

My waybar inspired quickshell config.

About

A minimalist and customizable quickshell config inspired by waybar.

Features

• Simple configuration.
• Modular and easily extendable widget system.
• Clean default theme using system colours.
• QML provides a simple JSON-like syntax.

Most configuration can be done from one of two files, shell.qml to configure the widgets, and GlobalVariables.qml to configure default values.

An example config:

import QtQuick
import Quickshell
import "widgets"

Scope {
	// create a bar on every screen
	Variants {
		model: Quickshell.screens
		delegate: Bar {
			leftItems: [
				MusicPlayer {},
				Audio {},
				Shazam {}
			]
			
			centreItems: [
				NiriWorkspaces {}
			]
			
			RightItems [
				Tray {},
				Seperator {},
				Clock {},
				Network {},
				Bluetooth {},
				Battery {},
				NotificationTray {}
			]
		}
	}
	
	// only show on main/active screen
	Notifications {}
	Volume {}
	Brightness {}
}

Installation

Dependencies

• quickshell
• brightnessctl
• networkmanager
• songrec
• qt6-base

Arch

yay -S quickhsell
git clone https://github.com/rdnamil/quickshell
mv quickshell $HOME/.config/quickshell
qs

Note

Make a line in your WM config to startup quickshell on session start.

Ex. Niri: spawn-at-startup "qs"

IPC

You can run qs ipc show to see a comprehensive list of ip calls. You can make an IPC call with qs ipc call <target> <function>.

A short list of common calls:

• qs ipc call launcher toggle
• qs ipc call settings launch
• qs ipc call notificationServer toggleDnd
• qs ipc call lock lockScreen