hatDE

A minimal X11 desktop.

INCOMPLETE!!

Build

Install X11/Xpm/Xft development headers first.

Debian/Ubuntu (APT):

sudo apt install libx11-dev libxpm-dev libxft-dev libfontconfig-dev pkg-config

Arch (Pacman):

sudo pacman -S --needed libx11 libxpm libxft fontconfig pkgconf

Then build:

make

See all available make targets:

make help

Run (inside an X11 session)

echo "exec /path/to/hatde" >> "~/.xinitrc"
startx

Config

hatDE reads ~/.config/hatDE/config (based on config_example).

Full config docs: see docs/CONFIG.md.

Example:

WINDOW: "/usr/bin/xterm"
CURSOR: "~/hatDE/src/assets/cursor.svg"
FONT "~/hatDE/src/assets/JetBrainsMonoNerdFont-Regular.ttf"

# desktop
BACKGROUND: "image" # color | gradient | image
BIMAGE: "/path/to/wallpaper.xpm"

Notes:

• BACKGROUND: "image" uses XPM files for now.
• The launcher appears at the bottom-left and starts commands like /usr/bin/xterm.
• No app window is created on startup until you launch one.
• Apps launched from the terminal (for example firefox) are reparented into frames when they map on X11.