d77void Docs

This is the community documentation of d77void: Void Linux, with runit and without systemd, ready to use with one of many window managers and desktops, each with its own configuration already in place.

These pages explain what each variant brings and where to change things: keyboard shortcuts, wallpaper, bar, autostart and the rest. Every detail is checked against the files the ISOs are built from.

Where to start

• New to d77void? Read What d77void is.
• Ready to install? See Installing.
• Want to change something? Read Where things are configured, then the page of your variant.

d77void Immutable

d77void Immutable, a variant where the system is a read-only image updated as a whole, has its own documentation: d77void Immutable Docs. What is written here about installing packages and updating does not apply to it.

Not affiliated with Void Linux

d77void is not affiliated with or endorsed by the Void Linux project or its maintainers. For general Void Linux topics, the Void Linux Handbook applies; these pages only cover what is specific to d77void.

License

This documentation is licensed under CC BY-SA 4.0.

What d77void is

d77void is Void Linux with a window manager or desktop already set up: packages chosen, configuration files written, wallpapers, a login screen and a few helper tools. Underneath it is a regular Void installation: xbps, runit, and the Void repositories, plus d77void’s own repository for a few extra packages.

Variants

Each variant is a separate ISO built around one window manager or desktop:

These pages currently cover wasp, Plasma, Sway, niri, Hyprland, labwc, mango, river, spitfire and Wayfire; more variants will follow.

d77void can be built for glibc (x86_64) and musl (x86_64-musl). glibc builds come with Brave (LibreWolf on Plasma); musl builds with Firefox.

What every variant has

• The d77void identity: /etc/os-release says d77void GNU/Linux, with ID_LIKE=void.
• d77-welcome, a small graphical helper shown after installation, for common tasks: setting the root password, updating, installing an office suite, a browser, Flatpak, Steam, Bluetooth and more. See Updating and installing software.
• A ready configuration in your home, copied from the image when your user is created. See Where things are configured.
• d77run, a quick run dialog, bound to a key in most variants.
• runit services, as on any Void system.

How it differs from installing Void yourself

Everything else, such as xbps-install, runit services and the Void Handbook, works as on plain Void.

Installing

The live session

Boot the ISO from a USB stick. The live session logs in as the user anon (password voidlinux), and opens the installer by itself on ISOs that have Calamares.

With Calamares

Most ISOs include Calamares, a graphical installer. In the live session it starts on its own; if you closed it, open it again from the menu.

Calamares asks for the language, keyboard, disk and user, then installs. At the end it also:

• adds d77void’s package repository to the installed system (/etc/xbps.d/d77void-repo.conf);
• removes itself and its files from the installed system.

The keyboard layout chosen in Calamares is written for X11 (/etc/X11/xorg.conf.d/00-keyboard.conf). Wayland compositors read their own setting; see Where things are configured.

Without Calamares

ISOs built without Calamares use a text installer:

sudo d77void-installer

Its menu goes through keyboard, network, source, mirror, hostname, locale, time zone, root password, user account, boot loader, partitions and file systems, like Void’s own void-installer. For Source, choose Local (packages from the ISO image) to install the live system with its configuration; Network installs only Void’s base system.

After installing

d77-welcome opens on every login until you press Don’t show this again. Use it to set the root password, update the system and install common software; see Updating and installing software.

Then read the page of your variant to learn its shortcuts.

Updating and installing software

d77void is a regular Void Linux system: software is installed and updated with xbps, from Void’s repositories and from d77void’s own.

Updating

sudo xbps-install -Su

Run it again if it says that xbps itself was updated first. Graphical alternatives:

• OctoXBPS, a graphical package manager, included in most variants; several variants also start its notifier, which tells you when updates are available.
• d77-welcome, with Update Software Sources and Upgrade Installed Packages; see below.

Installing and removing software

xbps-query -Rs <word>          # search
sudo xbps-install -S <package>  # install
sudo xbps-remove -R <package>   # remove, with what it pulled in

The Void Linux Handbook covers xbps in full.

d77void’s repository

Packages that Void does not carry (d77void’s tools, some window managers and shells, Calamares) come from d77void’s repository on SourceForge. Calamares adds it during installation, in /etc/xbps.d/d77void-repo.conf:

repository=https://sourceforge.net/projects/d77void/files/d77void-repo

On musl the address ends in d77void-musl instead.

d77-welcome can add two more optional repositories, Hyprland Repository and Cosmic Repository, with d77void’s packages of those desktops (hypr-d77 and cosmic-d77 on SourceForge).

d77-welcome

d77-welcome opens on every login until you press Don’t show this again. Run it again any time:

d77-welcome

It asks for your password when an action needs administrator rights, and your user must be in the wheel group (administrators).

Each action shows the packages and the command it runs before running it.

Services

Services are managed with runit, as on any Void system:

sudo sv status /var/service/*            # what is running
sudo ln -s /etc/sv/<name> /var/service/  # enable a service
sudo rm /var/service/<name>              # disable it

See the Void Linux Handbook.

Where things are configured

Your configuration is in your home

Each variant’s configuration ships in the image as a template, in /etc/skel. When a user is created, the template is copied into that user’s home, and from then on the copy in your home is the one that counts:

Editing a file in /etc/skel changes nothing for users that already exist; it only affects users created afterwards. To start over with a variant’s original file, copy it from /etc/skel into your home again, for example:

cp /etc/skel/.config/sway/config ~/.config/sway/config

Keyboard layout

The installer writes the layout you chose for X11 (/etc/X11/xorg.conf.d/00-keyboard.conf), which X11 window managers use. Wayland compositors take it from their own configuration file instead; each variant’s page says where. For example, a Portuguese layout:

Wallpapers

The variants pick their wallpapers from ~/Wallpaper/ (also in /usr/share/Wallpaper/). Put your own images there. How a variant sets or changes the wallpaper is on its page; two helpers are shared:

Web browser

Key bindings, menus and bars open the browser through d77-browser, which runs whichever one is installed: Brave on glibc builds, LibreWolf on Plasma, Firefox on musl builds (ISOs built from 16 October 2026 on). To make those keys open another browser, change the command in your variant’s configuration from d77-browser to the one you want, for example firefox.

Power menu

Most Wayland variants use fuzzel-power-menu (suspend, log out, reboot, shut down; reboot and shut down ask for confirmation). The X11 variants with dmenu use power_menu. Both use loginctl, so they work in any window manager.

Night light

Several variants start wlsunset with the location of Porto, Portugal (latitude 41.6, longitude −8.62), to warm the screen colours at night. Change the numbers in the line that starts it, in your variant’s configuration, to your own location.

Login screen

wasp

wasp is a Wayland compositor in the style of dwm: windows are tiled automatically, and workspaces are numbered tags. It is a fork of dwl with its configuration in Lua, read again live, without recompiling. The desktop shell on top (bar, launcher, lock screen, session menu, wallpaper picker) is Utumno, driven by qsd77.

Where to change things

Everything is in ~/.config/wasp/config.lua: key bindings, programs started with the session (wasp.autostart), keyboard layout (wasp.keyboard), terminal (wasp.terminal), layouts and colours. The file explains itself and has examples. After saving it, press Alt + Shift + R to apply it, with no need to log out.

The original is in /etc/skel/.config/wasp/config.lua.

Keys

Alt is the main modifier (wasp.modkey). Super (the Windows key) is used for Utumno’s own actions.

The drop-down terminal key is the one with ` on a US keyboard, left of

1. Installations made from ISOs built before 16 October 2026 have it on Alt + , instead, where it also stops Alt + , from focusing the left monitor; change "comma" to "grave" in its toggle-scratchpad line to match.

Idle

After 5 minutes without input the screen locks, after 5.5 it turns off (any key or mouse movement turns it back on), and it always locks before the computer suspends. A full-screen video keeps it awake. This is the swayidle entry in wasp.autostart; change the numbers of seconds there.

Installations made from ISOs built before 16 October 2026 do not have it. To add it, install the two programs:

sudo xbps-install -S swayidle wlopm

and add this entry to wasp.autostart in config.lua, then log out and in again:

{ "swayidle", "-w",
  "timeout", "300", "qsd77 -c utumno locker",
  "timeout", "330", "wlopm --off '*'", "resume", "wlopm --on '*'",
  "before-sleep", "qsd77 -c utumno locker" },

Wallpaper

Press Super + Y to pick one. Utumno’s wallpaper script sets it at start-up (through awww); put your own images in ~/Wallpaper/.

Changing the keyboard layout

In config.lua:

wasp.keyboard = {
  layout = "pt",
  ...
}

Then Alt + Shift + R.

Plasma

KDE Plasma, the full desktop, with KDE’s applications, configured with d77void’s look.

Where to change things

Almost everything is changed in System Settings: panel, widgets, wallpaper, theme, keyboard layout and shortcuts. Plasma writes those choices into files in ~/.config/ (kdeglobals, kwinrc, plasma-org.kde.plasma.desktop-appletsrc and others); there is no need to edit them by hand.

The original files are in /etc/skel/.config/.

Keys

Plasma’s own shortcuts apply: for example, the Super key opens the application launcher. Check and change them in System Settings → Shortcuts. d77void adds:

Keyboard layout

System Settings → Keyboard → Layouts.

Wallpaper

Right-click the desktop, Desktop and Wallpaper. d77void’s wallpapers are in /usr/share/backgrounds/Wallpaper/.

Sway

Sway is a tiling Wayland compositor compatible with i3: windows are placed side by side automatically and workspaces are numbered. d77void installs SwayFX, a Sway with extra visual effects, and uses Sway’s own bar.

Where to change things

After saving config, press Super + Shift + C to reload it. The originals are in /etc/skel/.config/.

Keys

Super is the modifier ($mod).

Volume, microphone and brightness keys work, also on the lock screen.

Keyboard layout

In ~/.config/sway/config:

input type:keyboard {
    xkb_layout "pt"
    xkb_variant ""
}

Wallpaper

The line output * bg ~/Wallpaper/background3.png fill in config sets the wallpaper at start-up; change the file name to use another image. Super + Y picks a random one from ~/Wallpaper/ for the current session.

niri

niri is a scrollable-tiling Wayland compositor: windows are arranged in columns on an endless strip that scrolls sideways, and workspaces are stacked vertically.

Where to change things

niri applies config.kdl as soon as it is saved. The originals are in /etc/skel/.config/.

Programs started with the session are the spawn-at-startup lines in config.kdl.

Keys

Super is the modifier (Mod).

Volume and microphone keys work, also on the lock screen.

Idle

After 5 minutes without input the screen locks (swaylock), after 10 it turns off and comes back on with any input, and it always locks before the computer suspends. This is /usr/bin/screenlock, started with the session.

On installations made from ISOs built before 16 October 2026 the screen locks but never turns off. To fix it, install wlopm:

sudo xbps-install -S wlopm

and, in /usr/bin/screenlock, replace both swaymsg "output * power off" and swaymsg "output * power on" with wlopm --off '*' and wlopm --on '*'.

Keyboard layout

In config.kdl:

input {
    keyboard {
        xkb {
            layout "pt"
        }
    }
}

Wallpaper

The wallpaper is set at start-up by sww, which shows ~/Wallpaper/background2.png with swww. To use another image now:

swww img ~/Wallpaper/<image>

Hyprland

Hyprland is a dynamic tiling Wayland compositor with animations and rounded corners. In d77void its configuration is written in Lua (hyprland.lua).

Where to change things

The programs the keys open are set near the top of hyprland.lua:

local terminal    = "kitty"
local fileManager = "pcmanfm"
local menu        = "fuzzel"
local mail        = "geary"
local web         = "d77-browser"

Programs started with the session are the hl.exec_cmd(...) lines. Hyprland applies the file as soon as it is saved. The originals are in /etc/skel/.config/hypr/.

Keys

Super is the modifier (mainMod).

Volume, microphone, brightness and media keys work, also on the lock screen.

Idle

hypridle dims the screen after 2.5 minutes without input, locks it after 5 and turns it off after 5.5; it also locks before the computer goes to sleep. Change the times in hypridle.conf.

Installations made from ISOs built before 16 October 2026 do not start hypridle. To add it:

1. In d77-welcome, add the Hyprland Repository if it is not there yet (Hyprland’s packages come from it).

2. Install it:

   sudo xbps-install -S hypridle
   

3. In ~/.config/hypr/hyprland.lua, inside hl.on("hyprland.start", ...), add the line:

   hl.exec_cmd("hypridle")
   

   It starts with the next session; to start it now, run hypridle & in a terminal.

Keyboard layout

In hyprland.lua, in the input settings:

kb_layout  = "pt",

Wallpaper

At start-up, ~/.azotebg-hyprland sets the wallpaper with swaybg. To choose another one, use Azote (included), which saves the image you pick for the next start-up too, or edit the image path in that file.

labwc

labwc is a stacking Wayland compositor in the style of Openbox: windows float and overlap as on a classic desktop, with a right-click menu and window decorations, configured with XML files.

Where to change things

All of labwc’s own files are in ~/.config/labwc/:

labwc-tweaks-qt, included, changes the theme and other settings from a window. To apply changes to rc.xml or menu.xml, log out and in again, or run labwc --reconfigure. The originals are in /etc/skel/.config/labwc/.

On every login ~/.lmu rebuilds menu.xml from the installed applications (labwc-menu-generator), so edits to menu.xml are replaced; to keep a hand-made menu, remove the ./.lmu & line from autostart.

Keys

Super is shown as W- in rc.xml.

labwc’s own default bindings also apply, for example Alt + Tab to switch windows and Alt + F4 to close one.

Keyboard layout

In ~/.config/labwc/environment:

XKB_DEFAULT_LAYOUT=pt

Log out and in again to apply it.

Wallpaper

The swaybg line in autostart sets ~/Wallpaper/background1.png at start-up; change the file name to use another image. Super + B picks a random one from ~/Wallpaper/ for the current session.

Weather in the bar

Waybar’s weather module, ~/.config/waybar/wittr.sh, asks wttr.in for the weather at latitude 41.6, longitude −8.62 (Porto, Portugal); change the two numbers in it to your own location.

mango

MangoWC (mango) is a Wayland compositor descended from dwl, with several layouts (tiling, scrolling, dwindle and more), an overview of all windows, animations and numbered tags as workspaces. It is configured with one text file.

Where to change things

Programs started with the session are the exec_once= lines. Press Super + R after saving to reload the configuration. The originals are in /etc/skel/.config/mango/.

Keys

Most actions use Alt; workspace and session actions use Super.

Idle

After 5 minutes without input the screen locks, after 10 it turns off and comes back on with any input, and it always locks before the computer suspends. This is the exec_once=swayidle … line in config.conf. Installations made from ISOs built before 16 October 2026 have no lock screen; to add it, install swaylock, swayidle and wlopm and copy that line and the bind=SUPER,t,spawn,swaylock -f line from /etc/skel/.config/mango/config.conf of a newer ISO, or from this page:

exec_once=swayidle -w timeout 300 'swaylock -f' timeout 600 "wlopm --off '*'" resume "wlopm --on '*'" before-sleep 'swaylock -f'
bind=SUPER,t,spawn,swaylock -f

Keyboard layout

In config.conf:

xkb_rules_layout=pt

Wallpaper

The line exec_once=swaybg -i Wallpaper/d77void_2560x1600.png -m fill sets it at start-up; change the file name to another image in ~/Wallpaper/.

river

river is a dynamic tiling Wayland compositor. Its configuration is a shell script, init, that runs riverctl commands; the layout (where windows go) is drawn by a separate program, rivertile. Workspaces are tags, as in dwm.

Where to change things

Programs started with the session are the riverctl spawn lines. init runs when river starts, so log out and in again after changing it (or run a single riverctl command in a terminal to try it right away). The original is in /etc/skel/.config/river/init.

Keys

Super is the modifier.

Idle

After 5 minutes without input the screen locks (swaylock), after 10 it turns off and comes back on with any input, and it always locks before the computer suspends. This is /usr/bin/screenlock, started with the session.

On installations made from ISOs built before 16 October 2026 the screen locks but never turns off. To fix it, install wlopm:

sudo xbps-install -S wlopm

and, in /usr/bin/screenlock, replace both swaymsg "output * power off" and swaymsg "output * power on" with wlopm --off '*' and wlopm --on '*'.

Keyboard layout

In init:

riverctl keyboard-layout pt

Wallpaper

The line riverctl spawn "swaybg -i ~/Wallpaper/background1.png" sets it at start-up; change the file name to another image in ~/Wallpaper/.

spitfire

spitfire is a tiling Wayland compositor in the spirit of dwm, written by the d77void author, with its whole configuration in one Lua file that is read again live. The desktop shell on top (launcher, lock screen, session menu, wallpaper picker, on-screen volume) is Utumno, driven by qsd77, as on wasp.

Where to change things

Everything is in ~/.config/spitfire/config.lua: key bindings (spitfire.bind), programs started with the session (spitfire.autostart), keyboard (spitfire.keyboard), gaps, borders and colours. After saving it, press Super + Shift + R (or run spitfirectl reload) to apply it.

The original is in /etc/skel/.config/spitfire/config.lua.

Keys

Super is the main modifier; Alt moves windows between workspaces.

The volume keys show Utumno’s on-screen volume.

Idle

ISOs built from 16 October 2026 on start swayidle from spitfire.autostart: the screen locks after 5 minutes without input and before the computer suspends. It needs spitfire 0.5.3 or later (xbps-query -p pkgver spitfire); with an older spitfire, swayidle simply exits. Turning the screen off when idle is not available on spitfire yet.

To add it to an older installation, update the system, install swayidle, and add this line to spitfire.autostart, then log out and in again:

"swayidle -w timeout 300 'qsd77 -c utumno locker' before-sleep 'qsd77 -c utumno locker'",

Keyboard layout

In config.lua, the default is the US international layout:

spitfire.keyboard = { layout = "us", variant = "intl", model = "", options = "", repeat_delay = 600, repeat_rate = 25 }

For a Portuguese layout, set layout = "pt" and variant = "".

Wallpaper

Press Super + Y to pick one from ~/Wallpaper/.

Wayfire

Wayfire is a Wayland compositor with visual effects (a 3D desktop cube, wobbly windows, workspace overview), built from plugins. Windows float by default, as on a classic desktop; the panel, dock and wallpaper come from wf-shell.

Where to change things

WCM (Wayfire Config Manager), included, changes wayfire.ini from a window: plugins, key bindings and effects. Wayfire applies changes to wayfire.ini as soon as the file is saved. The originals are in /etc/skel/.config/.

Programs started with the session are in the [autostart] section of wayfire.ini; key-to-command bindings are in the [command] section, as pairs such as binding_terminal = <super> KEY_ENTER and command_terminal = kitty.

Keys

Volume and brightness keys work.

Idle

After 5 minutes without input the screen locks (swaylock, from the idle = line in [autostart]), and it always locks before the computer suspends. Wayfire’s own idle plugin ([idle] in wayfire.ini) also starts a screensaver (the spinning cube) at 5 minutes and turns the screen off at 10; a full-screen window prevents both, and Super + Z switches them off and on.

On installations made from ISOs built before 16 October 2026 the screen does not lock by itself. To fix it, replace the idle = line in [autostart] with:

idle = swayidle -w timeout 300 'swaylock -f' before-sleep 'swaylock -f'

Keyboard layout

In the [input] section of wayfire.ini:

xkb_layout = pt

Wallpaper

The wallpaper is drawn by wf-background, from the image = line in the [background] section of ~/.config/wf-shell.ini (/usr/share/Wallpaper/background3.png at first). Point it at any image, for example one in ~/Wallpaper/.