https://github.com/k4zoku/nowm
🚫 Managing window without a window manager. (59 slocs)
https://github.com/k4zoku/nowm
bash-script linux no-wm nowm sh shell shell-script unix unix-shell window-manager wm x11 xorg
Last synced: 12 months ago
JSON representation
🚫 Managing window without a window manager. (59 slocs)
- Host: GitHub
- URL: https://github.com/k4zoku/nowm
- Owner: K4zoku
- License: mit
- Created: 2022-01-14T16:54:44.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2023-08-10T15:24:30.000Z (almost 3 years ago)
- Last Synced: 2023-08-10T20:53:18.374Z (almost 3 years ago)
- Topics: bash-script, linux, no-wm, nowm, sh, shell, shell-script, unix, unix-shell, window-manager, wm, x11, xorg
- Language: Shell
- Homepage:
- Size: 51.8 KB
- Stars: 45
- Watchers: 4
- Forks: 4
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
nowm
Managing window without a window manager
## 💡 About
A dead simple tool to managing windows from the [tty](https://en.wikipedia.org/wiki/Tty_(Unix)), written in shell script.
### ✨ Features
- No [virtual desktops](https://en.wikipedia.org/wiki/Virtual_desktop).
- No [window decorations](https://en.wikipedia.org/wiki/Window_(computing)#Window_decoration).
- No [widgets](https://nnbnh.github.io/blog/en/posts/5/#widgets).
- No [hotkeys](https://nnbnh.github.io/blog/en/posts/5/#hotkeys).
- No [wallpaper](https://nnbnh.github.io/blog/en/posts/5/#wallpaper).
- No [ICCCM](https://web.archive.org/web/20190617214524/https://raw.githubusercontent.com/kfish/xsel/1a1c5edf0dc129055f7764c666da2dd468df6016/rant.txt).
- No [EWMH](https://en.wikipedia.org/wiki/Extended_Window_Manager_Hints).
- And everything is float.
## 🚀 Setup
### 🧾 Dependencies
- [`sh`](https://en.wikipedia.org/wiki/Unix_shell)
- [`xorg`](https://www.x.org)
- [`xorg-xinit`](https://x.org/releases/X11R7.6/doc/man/man1/xinit.1.xhtml) _(optional)_
- [`xdotool`](https://github.com/jordansissel/xdotool)
### 📥 Installation
#### 🔧 Manually
Option 1: using `curl`
```sh
curl https://raw.githubusercontent.com/K4zoku/nowm/master/bin/nowm > ~/.local/bin/nowm
chmod +x ~/.local/bin/nowm
```
Option 2: using `git`
```sh
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](https://github.com/bpkg/bpkg) user:
```sh
bpkg install K4zoku/nowm
```
For [Basher](https://github.com/basherpm/basher) user:
```sh
basher install K4zoku/nowm
```
Using [Arch User Repository](https://aur.archlinux.org):
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](https://aur.archlinux.org/packages/nowm) (stable release) and [nowm-git](https://aur.archlinux.org/packages/nowm-git) (latest commits). Choose which one you want to install and use your preferred AUR helper, eg:
```sh
yay -S nowm-git
```
or install it manually using `makepkg` command:
```sh
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](https://en.wikipedia.org/wiki/Tty_(Unix)):
```sh
nowm
```
this will launch NoWM inside X display server with `startx`.
##### Manually
```sh
startx $(which nowm)
```
or
```sh
xinit $(which nowm)
```
or
You can put NoWM inside `~/.xinitrc`:
```sh
exec nowm
```
### Using display manager
If you using a display manager, create a file called `nowm.desktop` in `/usr/share/xsessions` with following content:
```ini
[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](examples).
## 💌 Credits
Special thanks to:
- [**NNB**](https://github.com/NNBnh) for polish this project's `README.md`, write the manpage and design [new logo](https://www.figma.com/file/NuxUjGNgfnCZ5fY5Q554ME/NoWM-Logo?node-id=0%3A1).
---
>
Made with ❤️ by @K4zoku
