Official Apps

Official GNARUS applications and commands use the gnarus- prefix. They are maintained as part of the GNARUS desktop rather than treated as generic third-party utilities.

Desktop commands

The gnarus package ships gnarus-setup:

Command	Role
`gnarus-setup`	Optional helper that copies packaged defaults from `/usr/share/gnarus` to `~/.config` for customization.

The session launchers are owned by the separate gnarus-session package:

Command	Role
`gnarus-session`	Display-manager wrapper that prepares the environment and starts the session.
`gnarus-start`	Starts the GNARUS runtime and Hyprland session.
`gnarus-tty`	Manual TTY launcher for systems without a display manager.

GNARUS Calendar

gnarus-calendar is an official Rust application maintained in gnarus-sh/gnarus-calendar. It renders a native GTK4 calendar popup as a layer-shell surface, opened from the Waybar date module, with SQLite storage, ICS import/export and configurable reminders.

Installed layout:

/usr/bin/gnarus-calendar
/etc/gnarus-calendar/config.toml
/etc/gnarus-calendar/style.css
/etc/gnarus-calendar/theme.css
/etc/gnarus-calendar/themes/
/usr/lib/systemd/user/gnarus-calendar.service

The gnarus package depends on gnarus-calendar, and the calendar package owns its binary, config and themes.

See Calendar for usage, configuration and commands.

GNARUS Storage

gnarus-storage is an official Rust application maintained in gnarus-sh/gnarus-storage. It watches removable storage through UDisks2 and feeds the Waybar custom/storage module.

Installed layout:

/usr/bin/gnarus-storage
/etc/gnarus-storage/config.json
/etc/gnarus-storage/theme.css
/etc/gnarus-storage/themes/
/usr/share/licenses/gnarus-storage/LICENSE

User overrides live in:

~/.config/gnarus-storage/config.json
~/.config/gnarus-storage/theme.css
~/.config/gnarus-storage/themes/

The GNARUS environment does not vendor these files anymore. The gnarus package depends on gnarus-storage, and the storage package owns its binary, default config and themes.

See Removable Storage for command usage and configuration keys.

GNARUS Appearance

gnarus-appearance ships the shared visual assets used by the desktop:

/usr/share/backgrounds/gnarus/
/usr/share/fonts/

Keeping these assets in a separate package avoids duplicating wallpapers and fonts inside the gnarus configuration package.

Internal shell helpers

The environment also includes shell helpers under config/gnarus/sh/. They are part of the desktop implementation and are called by keybindings, Waybar modules and the sidebar.

Common helpers include:

theme-switch.sh for applying a theme family across desktop components.
accent-switch.sh for changing the accent color.
spaces-switch.sh for workspace gaps and spacing modes.
brightness-switch.sh for brightness actions.
weather-location.sh for the weather module.
toggle-mode.sh for mode switching.

These helpers are not packaged as public /usr/bin/gnarus-* commands. They are installed as configuration support files under /usr/share/gnarus and copied to the user config by gnarus-setup --copy gnarus when customization is desired.