Skip to main content
Version: 2.2 (dev)

Installation

Install dependencies for your distribution, then build the development version below. You can also try SomeWM in a nested session without installing it system-wide.

Dependencies​

SomeWM uses system wlroots 0.20.2 or newer in the 0.20 series, including development headers. No wlroots patch is needed.

Install Wayland 1.24.0, libdrm 2.4.129, xkbcommon 1.8.0 and wayland-protocols 1.47 or newer, plus the packages below.

XWayland support is always built in. Install the Xwayland binary to run X11 applications.

Arch Linux​

From the AUR​

yay -S somewm-git

paru -S somewm-git is an alternative. This package follows development. For a released version, use the documentation version switcher.

The package builds against LuaJIT. To build against another Lua, install its LGI package and set SOMEWM_LUA:

sudo pacman -S lua54-lgi
SOMEWM_LUA=5.4 yay -S somewm-git

SOMEWM_LUA accepts luajit, 5.1, 5.3, 5.4 and 5.5. yay still installs LuaJIT, because the AUR lists the default dependencies. Add --rebuild if yay already built this version with a different Lua.

Manual Build​

sudo pacman -S --needed base-devel git meson ninja pkgconf luajit lua51-lgi \
cairo pango gdk-pixbuf2 librsvg glib2 dbus wayland wayland-protocols \
wlroots0.20 libinput libxkbcommon pixman libdrm mesa libglvnd libffi \
xorg-xwayland libxcb xcb-util-wm

Debian/Ubuntu​

If your release does not package libwlroots-0.20-dev at the required version, install it separately or upgrade your distribution.

sudo apt install build-essential git meson ninja-build pkg-config \
luajit libluajit-5.1-dev lua-lgi libcairo2-dev libpango1.0-dev \
libgdk-pixbuf-2.0-dev librsvg2-dev libglib2.0-dev libdbus-1-dev \
libwlroots-0.20-dev libwayland-dev libwayland-bin wayland-protocols \
libdrm-dev libinput-dev libxkbcommon-dev libegl-dev libgles-dev \
libpixman-1-dev libffi-dev xwayland libxcb1-dev libxcb-icccm4-dev

Optional packages:

  • libpam0g-dev for built-in lockscreen authentication
  • systemd-dev for systemd session integration

Fedora​

sudo dnf install gcc make git meson ninja-build pkgconf-pkg-config \
luajit luajit-devel lua-lgi cairo-devel pango-devel gdk-pixbuf2-devel \
librsvg2-devel glib2-devel dbus-devel wayland-devel wayland-protocols-devel \
wlroots-devel libdrm-devel libinput-devel libxkbcommon-devel \
libglvnd-egl-devel libglvnd-gles-devel pixman-devel libffi-devel \
systemd-devel xorg-x11-server-Xwayland libxcb-devel xcb-util-wm-devel

Gentoo​

The third-party somewm-gentoo-overlay packages SomeWM. As root:

eselect repository add somewm git https://github.com/shuber2/somewm-gentoo-overlay.git
emaint sync -r somewm
echo 'gui-wm/somewm ~amd64' >> /etc/portage/package.accept_keywords/somewm
emerge -av gui-wm/somewm

Check the selected ebuild's version. A 9999 ebuild follows development rather than a fixed release.

Build and Install​

git clone --branch main https://github.com/trip-zip/somewm
cd somewm
make
sudo make install

A manual build uses the first Lua it finds: LuaJIT, then 5.5, 5.4, 5.3, 5.2 and 5.1. To choose one, name it on the first build, for example make LUA_PKG=lua5.4. An existing build/ directory keeps its Lua; delete it to change.

Then follow Launch.

LGI​

LGI provides Cairo, Pango and GLib bindings. It must match the Lua interpreter used by the build. LuaJIT is the default and uses Lua 5.1 modules. On Arch, this requires lua51-lgi. Debian/Ubuntu and Fedora package it as lua-lgi.

If startup reports module 'lgi' not found, check the interpreter and module paths before installing another Lua version. somewm -L /path/to/modules adds a search directory for modules installed elsewhere.

NixOS​

From the source checkout:

nix build .
./result/bin/somewm

nix-build also works if your nixpkgs channel provides a compatible wlroots_0_20.

The package installs the default configuration and Lua libraries, and wraps the binary with its Lua and typelib paths.

NixOS Details​

GTK3 typelibs are included by default. To add GI libraries or Lua modules, save this as with-libraries.nix in the checkout and run nix-build with-libraries.nix:

{ pkgs ? import <nixpkgs> {} }:
(import ./default.nix { inherit pkgs; }).override {
extraGIPackages = [ pkgs.networkmanager ];
extraLuaPackages = ps: [ ps.luafilesystem ];
}

Uninstallation​

From the checkout used to install:

sudo make uninstall
make clean