Add documentation
This commit is contained in:
parent
60d9f583de
commit
7d7233232a
111
DOC.md
Normal file
111
DOC.md
Normal file
@ -0,0 +1,111 @@
|
||||
## Install dependencies
|
||||
|
||||
```bash
|
||||
sudo apt-get install -y git xorg libx11-dev libxft-dev libxinerama-dev build-essential
|
||||
```
|
||||
|
||||
You can install another programs for your customization. This is for the example:
|
||||
|
||||
```bash
|
||||
sudo apt install -y pulseaudio pavucontrol pulseaudio-utils # For volume script
|
||||
sudo apt install -y nitrogen # For wallpaper
|
||||
sudo apt install -y lxpolkit # For polkit
|
||||
sudo apt install -y xcompmgr # For transparent supporting
|
||||
sudo apt install -y rofi # For menu launcher
|
||||
sudo apt install -y scrot # For screenshot
|
||||
sudo apt install -y htop kitty thunar # For another Apps
|
||||
```
|
||||
|
||||
## Clone from source
|
||||
|
||||
```bash
|
||||
git clone https://git.suckless.org/dwm ~/.dwm
|
||||
cd ~/.dwm
|
||||
```
|
||||
|
||||
## Modification the `config.h`
|
||||
|
||||
See `config.def.h` for a default configuration.
|
||||
|
||||
## Compile and Install
|
||||
|
||||
```bash
|
||||
sudo make clean install
|
||||
```
|
||||
|
||||
## Usage
|
||||
|
||||
### Add DWM as a Window Manager
|
||||
|
||||
If you want to use it without Display Manager, you can use this method:
|
||||
|
||||
Add this line on `~/.xinitrc`
|
||||
```bash
|
||||
exec dwm
|
||||
```
|
||||
|
||||
Then you can run it with `startx`
|
||||
```bash
|
||||
startx
|
||||
```
|
||||
|
||||
### Add DWM on X Session
|
||||
|
||||
If you want to use a Display Manager with a semi-automatic via custom session, you can use this method:
|
||||
|
||||
Add this line on `~/.xsession`
|
||||
```bash
|
||||
exec dwm
|
||||
```
|
||||
|
||||
### Add DWM to Display Manager
|
||||
|
||||
If you want to use a Display Manager with a GUI login, you can use this method:
|
||||
|
||||
As root, create file `/usr/share/xsessions/dwm.desktop` then type this:
|
||||
```bash
|
||||
[Desktop Entry]
|
||||
Encoding=UTF-8
|
||||
Name=DWM
|
||||
Comment=Dynamic Window Manager
|
||||
Exec=dwm
|
||||
Icon=dwm
|
||||
Type=XSession
|
||||
```
|
||||
|
||||
## Add the autostart
|
||||
|
||||
### Use patch
|
||||
|
||||
You can use official autostart patch method. Check the complete instruction in [here](https://dwm.suckless.org/patches/autostart/). It will change your `dwm.c`.
|
||||
|
||||
### Add autostart in `.xprofile`
|
||||
|
||||
For a simple method without updating a `dwm.c`, you can use this method.
|
||||
|
||||
Make or edit the file `~/.xprofile` and add autostart script inside:
|
||||
```bash
|
||||
if [ -f ~/.dwm/autostart.sh ]; then
|
||||
~/.dwm/autostart.sh &
|
||||
fi
|
||||
```
|
||||
|
||||
## Update DWM from origin
|
||||
|
||||
You can update your DWM version from the git repository with this command:
|
||||
|
||||
```bash
|
||||
git checkout mybranch
|
||||
|
||||
git fetch origin master
|
||||
git merge origin/master
|
||||
|
||||
git push myremote mybranch
|
||||
```
|
||||
|
||||
## Removing DWM
|
||||
|
||||
Just delete the binary file if you want to removing DWM.
|
||||
```bash
|
||||
sudo rm /usr/local/bin/dwm
|
||||
```
|
Loading…
Reference in New Issue
Block a user