Now with GTK 4!
This is my bar & other assorted widgets that I use on my Linux desktop. Not particularly customizable; see Configuration section for more details.
It has some features I think are neat, notably dynamically colored system usage widgets, workspace widget scrolling, and workspace drag'n'drop (to move them between monitors).
Required things:
- AGS v2 (for build only)
- libastal (+ some of its extra libraries)
- GSound
- Hyprland (0.47.2+)
- GNOME System Monitor
- pavucontrol
- geoclue (and an agent running; in the future this may become an agent itself, use
/usr/lib/geoclue-2.0/demos/agentfor now)
Included is a meson.build file allowing this project to be bundled and installed with Meson.
A Hyprland configuration file should be sourced from (INSTALL PREFIX)/share/mabi-shell/hyprland.conf
(where INSTALL_PREFIX is /usr/local by default)
Running in development mode involves running ./run-dev.sh
and sourcing the Hyprland configuration directly from the source directory.
In the future, I may make a PKGBUILD for this or something.
This isn't particularly customizable, but some options do exist (they should live in ~/.config/mabi-shell/config.json).
A configuration file is not required; all options have defaults.
interface OklabColor {
l: number;
a: number;
b: number;
}
interface Config {
/** Override for the primary monitor. Useful if you don't have one set as primary. */
primary_monitor?: string;
/** Whether to enable notifications. */
enable_notifications: boolean;
/** The network usage considered to be 100%. In bytes per second. */
max_network_usage: number;
/** The style of the bar. "floating" is rounded with a margin, "attached" has no margins */
bar_style: "floating" | "attached";
/** The first theme color, used for inactive workspace buttons and badges with 0 usage. */
theme_inactive: OklabColor;
/** The second theme color, used for active workspace buttons and badges with maximum usage. */
theme_active: OklabColor;
/** The options to show in the power menu. Hibernate is disabled by default. */
power_menu_options: ("suspend" | "hibernate" | "shutdown" | "reboot")[];
}
const CONFIG_DEFAULTS: Config = {
enable_notifications: true,
max_network_usage: 12_500_000,
bar_style: "floating",
theme_inactive: { l: 0.646, a: 0.1412, b: -0.1027 },
theme_active: { l: 0.52, a: 0.1106, b: -0.139 },
power_menu_options: ["suspend", "shutdown", "reboot"],
};In addition, if a ~/.config/mabi-shell/overrides.css file exists, it will be loaded as extra CSS
if you want to customize further (but this is in no way stable and may change at any time)
Some actions may be dispatched to the running instance via the astal CLI.
capslock_update: update Caps Lock statusosdn <icon-name: string> <value: number>: show OSD with the specified icon and bar fullnessosdt <icon-name: string> <text: string>: show OSD with the specified icon and text (no level bar)wpctl <args...>: execute awpctlcommand, then show OSD for the default audio sinkquit: exit
- Notification animations
- Make notification center actually usable