Skip to content
ArchEclipse

Common pages

↑↓to navigate↵to openescto close
First Boot
On this page

Getting Started

First Boot

What happens after the installer, how the greetd login works, and the first commands to try.

Installation finishes by reloading Hyprland, but the login stack and user services need a reboot. This page covers the first login and a quick health check.

Reboot and log in#

bash
sudo reboot

The installer configures greetd and points it at the ArchEclipse Quickshell greeter. It also disables SDDM, LightDM and GDM if they are enabled, adds the greeter user to the video and input groups, and enables a text login on VT2 as a rescue path.

At the login screen, pick your session and sign in with your normal user account. The session list is read from the greeter's sessions.json; the default session starts Hyprland with the greeter compositor configuration.

What starts with the session#

~/.config/hypr/config/exec.lua runs the following on hyprland.start:

ProcessPurpose
walleclipseWallpaper daemon (static and animated wallpapers, per workspace)
lua ~/.config/hypr/config/scripts/bar.luaStarts the Quickshell shell, or restarts it if already running
systemctl --user start hyprpolkitagentGraphical authentication agent
coloreclipse applyApplies the current light/dark theme and palette to system apps
nm-appletNetworkManager tray applet
blueman-appletBluetooth tray applet

The shell creates its cache directories, primes the wallpaper store, fastfetch pins, power-profile probe and clipboard watcher at startup. The first open of a panel should therefore be fast, though video wallpaper thumbnails may still be generating in the background.

First five things to try#

ActionShortcut
Open a terminal (foot)SUPER + Return
Open the application launcherSUPER twice (SUPER + SUPER_L)
Pick a wallpaperSUPER + W
Open the right panelSUPER + R
Open the left panel (settings live here)SUPER + L
Take a screenshotSUPER + SHIFT + S
Start or stop a recordingSUPER + SHIFT + R
Open the welcome tourSUPER + F1

The full list is in Keyboard Shortcuts. If the bar is missing, it can be restarted with SUPER + B or by running:

bash
lua ~/.config/hypr/config/scripts/bar.lua

Quick health check#

Run these in a terminal:

bash
hyprctl version
hyprctl monitors
pgrep -a qs
coloreclipse get
walleclipse current

Expected results:

  • hyprctl version prints the running Hyprland build. ArchEclipse requires the Lua configuration support; a Hyprland build without it will not load hyprland.lua.
  • pgrep -a qs shows a Quickshell process using ~/.config/quickshell/archeclipse.
  • coloreclipse get reports light or dark.
  • walleclipse current prints the wallpaper state for the current output. The exact output format is defined by WallEclipse; TODO: document its fields.

If qs is not running, inspect /tmp/qs-bar-$USER.log. If the bar starts but looks unstyled, check that ~/.cache/coloreclipse/colors.scss exists and run coloreclipse apply.

First configuration changes#

The Settings tab in the left panel writes changes immediately to ~/.cache/quickshell/settings/settings.json. Hyprland-specific rows write a machine-local module under ~/.config/hypr/config/custom/ and push it live. Base configuration lives in ~/.config/hypr/config/; see Configuration for the load order.

For changes that survive updates, use ~/.config/hypr/config/custom/ and ~/.config/zsh/custom/local.zsh. The updater resets tracked files.