nowm

Managing window without a window manager

💡 About

A dead simple tool to managing windows from the tty, written in shell script.

✨ Features

• No virtual desktops.
• No window decorations.
• No widgets.
• No hotkeys.
• No wallpaper.
• No ICCCM.
• No EWMH.
• And everything is float.

🚀 Setup

🧾 Dependencies

• sh
• xorg
• xorg-xinit (optional)
• xdotool

📥 Installation

🔧 Manually

Option 1: using curl

curl https://raw.githubusercontent.com/K4zoku/nowm/master/bin/nowm > ~/.local/bin/nowm
chmod +x ~/.local/bin/nowm

Option 2: using git

git clone https://github.com/K4zoku/nowm.git ~/.local/share/nowm
ln -s ~/.local/share/nowm/bin/nowm ~/.local/bin/nowm

📦 Package manager

For Bpkg user:

bpkg install K4zoku/nowm

For Basher user:

basher install K4zoku/nowm

Using Arch User Repository:

First of all you need to have base-devel group installed as it contains necessary utilities - sudo pacman -Syu base-devel. There are two packages providing NoWM - nowm (stable release) and nowm-git (latest commits). Choose which one you want to install and use your preferred AUR helper, eg:

yay -S nowm-git

or install it manually using makepkg command:

git clone https://aur.archlinux.org/packages/nowm-git
cd nowm-git
makepkg -si

Note If you can and want to port NoWM to other package managers, feel free to do so.

⌨️ Usage

🖥️ Launch from TTY

Automatically

Simply launch it from the tty:

nowm

this will launch NoWM inside X display server with startx.

Manually

startx $(which nowm)

or

xinit $(which nowm)

or

You can put NoWM inside ~/.xinitrc:

exec nowm

Using display manager

If you using a display manager, create a file called nowm.desktop in /usr/share/xsessions with following content:

[Desktop Entry]
Encoding=UTF-8
Name=nowm
Comment=nowm - managing window without a window manager
Exec=nowm
Type=XSession

⚙️ Configuration

To config NoWM, you can make a executable file at ~/.config/nowm/autostart, NoWM will automatically start it at runtime.

Note Check out some examples.

💌 Credits

Special thanks to:

• NNB for polish this project's README.md, write the manpage and design new logo.

Made with ❤️ by @K4zoku