Skip to content

Latest commit

 

History

History
109 lines (85 loc) · 3.37 KB

BUILD.md

File metadata and controls

109 lines (85 loc) · 3.37 KB
Raw

Table of Contents


Build Requirements

  • g++ >= 6.0
  • CMake >= 3.9
  • X11 headers
Distro X11 headers package name
Ubuntu libx11-dev
Fedora libX11-devel
Arch libx11
Gentoo libX11

Build and Install

  1. Build and install project (installed to /usr/local/bin/)
$ git clone https://github.com/aesophor/wmderland.git
$ cd wmderland && ./build.sh --install
  1. Copy the config file (IMPORTANT)
$ mkdir -p ~/.config/wmderland
$ cp /etc/xdg/wmderland/config ~/.config/wmderland/.
  1. If not using a Display Manager, add this to your ~/.xinitrc and execute startx
exec wmderland

Black Screen?

Before you start wmderland, you'll need to modify the config file (~/.config/wmderland/config) first, otherwise you'll get a black screen. How do I escape from the black screen!?


Configure and Run

Edit ~/.config/wmderland/config. The syntax is very similar to that of i3wm:

For example, to set a wallpaper using feh:

exec feh --bg-fill ~/Pictures/Wallpaper.jpg

To bind Mod+d to rofi -show drun:

bindsym $Mod+d exec rofi -show drun

By default, the Mod key is the Windows/Command key, but this option can be configured here:

set $Mod = $Cmd

Escape From the Black Screen

In case you are stucked in a black screen, you can try ONE of the following:

  • Mod (Windows/Command key) + Shift + Esc: the keybinding to exit the window manager

  • Ctrl + Alt + F2 and run pkill X, and Ctrl + Alt + F1


GDM Entry Not Present (Fedora Workstation 31)

If wmderland's entry just won't show up in GDM even after reboot, you can try to:

  1. autoremove GDM (this will break GNOME a bit, but it can be restored, see step 3)
  2. reinstall gdm
  3. reinstall gnome-desktop
  4. remove wmderland (./build.sh --uninstall)
  5. reboot
  6. recompile and reinstall wmderland (./build.sh --install)
$ sudo systemctl disable gdm.service
$ sudo dnf autoremove -y gdm
$ sudo dnf upgrade -y
$ sudo dnf install -y gdm
$ sudo dnf group install -y gnome-desktop
$ sudo systemctl enable gdm.service

# Now cd to wmderland's project directory
$ ./build.sh --uninstall
$ sudo reboot

# After rebooting, cd to wmderland's project directory
$ rm -rf build
$ ./build.sh --install

For further details, please see issue #39.