archy-dwm/README.md

# Anas Elgarhy's dwm
## My fork from dwm 🍴, with a lot of beautiful patches 🥰

![dwm screenshot](./screenshots/dwm-6.3-0.1.0.png)
![dwm and 2 alacritty](./screenshots/dwm_bpytop_and_ufetch_tile_layout-6.3-0.1.0.png)
![dwm and alacritty](./screenshots/dwm_alacritty-6.3-0.1.0.png)
![dwm and alacritty and cmus and cava](./screenshots/dwm_alacritty_cmus_cava-6.3-0.1.1.png)

### Applayed patches:
- [alwayscenter](https://dwm.suckless.org/patches/alwayscenter)
- [cool autostart](https://dwm.suckless.org/patches/cool_autostart)
- [fullscreen](https://dwm.suckless.org/patches/fullscreen)
- [gridmode](https://dwm.suckless.org/patches/gridmode)
- [movestack](https://dwm.suckless.org/patches/movestack)
- [pertag](https://dwm.suckless.org/patches/pertag)
- [systray](https://dwm.suckless.org/patches/systray)
- [sticky](https://dwm.suckless.org/patches/sticky)
- [noborder](https://dwm.suckless.org/patches/noborder)
- [fibonacci layouts](https://dwm.suckless.org/patches/fibonacci)
- [centeredmaster](https://dwm.suckless.org/patches/centeredmaster)
- [keychain](https://dwm.suckless.org/patches/keychain)

### Keys
| Keys                           | Function                                                              |
|--------------------------------|-----------------------------------------------------------------------|
| modkey + shift + d             | Open dmenu (launcher)                                                 |
| modkey + shift + ctrl + d      | Open rofi launcher (small size)                                       |
| modkey + enter                 | Launche the main terminal (alacritty by default)                      |
| modkey + t -> a                | Launche the alacritty terminal                                        |
<!-- | modkey + t -> shift + a        | Launche the alacritty terminal with tmux                              | -->
| modkey + t -> k                | Launche the kitty terminal                                            |
<!-- | modkey + t -> shift + k        | Launche the kitty terminal with tmux                                  | -->
| modkey + shift + f -> g        | Launche the GUI file manger (pcmanfm by default)                      |
| modkey + shift + f -> f        | Launche rofi file file browser (small size)                           |
| modkey + shift + f -> t        | Launche the terminal file manger (ranger) in the main terminal        |
| modkey + w -> g                | Launche google chrome browser                                         |
| modkey + w -> t                | Launche tor browser                                                   |
| modkey + c -> d                | Launche discord                                                       |
| modkey + c -> o                | Launche obsidian                                                      |
| modkey + a -> j                | Launche jetbrains-toolbox                                             |
| modkey + a -> n                | Launche NeoVim in the main terminal                                   |
| modkey + a -> v                | Launche Vim in the main terminal                                      |
| modkey + a -> e                | Launche emacs                                                         |
| modkey + p -> b                | Launche the background manger (nitrogen by default)                   |
| modkey + p -> n                | Lanuche the network manager (nm-connection-editor)                    |
| modkey + e                     | Launche rofi emoji selector                                           |
| modkey + f                     | Toggle full screen mode                                               |
| modkey + b                     | Toggle the status bar (hide/show)                                     |
| modkey + j                     | Change the focus to privus window in the stack                        |
| modkey + k                     | Change the focus to the next window in the stack                      |
| modkey + i                     | Change the stack layout to virtecal                                   |
| modkey + d                     | Change the stack layout to horizontal                                 |
| modkey + h                     | Decrease the focus window size                                        |
| modkey + l                     | Increase the focus window size                                        |
| modkey + Tab                   | Toggle between the curent tag and the privus tag                      |
| modkey + shift + j             | Move the focus window down in the stack                               |
| modkey + shift + k             | Move the focus window up in the stack                                 |
| modkey + q -> q                | Quit from the focus window (kill it)                                  |
| modkey + s -> t                | Use the tile layout                                                   |
| modkey + s -> f                | Use the float layout                                                  |
| modkey + s -> m                | Use the monocle layout                                                |
| modkey + s -> g                | Use the grid layout                                                   |
| modkey + s -> r                | Use the spial layout (part from fibonacci layouts)                    |
| modkey + s -> d                | Use the dwindle layout (part from fibonacci layouts)                  |
| modkey + s -> c                | Use the centerd master layout                                         |
| modkey + s -> x                | Use the centerd floating master layout                                | 
| modkey + s -> s                | Toggle between current layout and tile layout                         |
| modkey + shift + s             | Toggle sticky mode                                                    |
| modkey + alt + f               | Toggle floating window                                                |
| modkey + m -> c                | Launche the cmus player                                               |
| modkey + m -> v                | Launche vlc video player                                              |
<!-- | modkey + m -> shift + v        | Lanuche nvlc in the main terminal                                     | -->
| modkey + 0                     | View all tags                                                         |
| modkey + shift + 0             | Mirror the current tag in all tags                                    |
| modkey + comma (,)             | -                                                                     |
| modkey + period (.)            | -                                                                     |
| modkey + shift + comma (,)     | -                                                                     |
| modkey + shift + period (.)    | -                                                                     |
| modkey + (1..9)                | Navigate between tags                                                 |
| modkey + shift + (1..9)        | Move the focus window to specific tag                                 |
| modkey + control + (1..9)      | -                                                                     |
| modkey + shift + ctrl + (1..9) | Mirror the current tag in specific tag                                |
| superkey + space               | Change the keyboard layout (ar, en)                                   |
| PrtSc                          | Take a screenshot using default screenshot tool (spectacle)           |
| modkey + shift + x             | Lock the screen (using betterlockscreen)                              |
| modkey + shift + alt + q       | Kill dwm                                                              |

> modkey = win key or super key

### Dependencies (apps)
- `google-chrome-stable` the main web browser
- `alacritty` the main terminal
- `spectacle` the main screenshot tool 
- `pcmanfm` the GUI file manger
- `rofi`
- `dmenu`
- `libxinerama-dev`\*\*
- `tmux`\*
- `tor-browser`
- `discord`
- `libxft-bgra` for color emojies support
- `jetbrains-toolbox`
- `nvim`\*
- `vim`\*
- `xbacklight` for control in the screen brightness
- `pamixer` for control in the audio level
- `playerctl` for control in the media
- `pactl` for control in the mic
- `betterlockscreen` for lock screen
- `setxkbmap` for switch between keyboard layouts, like (ar, en)
- `slstatus` the status bar
- `network-manager-applet` 
- `picom` compositor , for transparency
- `nitrogen` for set the wallpaper
- `copyq` clipboard manager
- `obsidian`

> \*\*: build dependencie.

### Install
- Manual:
  1. Run this command to install all avilable dependencies in standerd arch repostory
    ```bash
    sudo pacman -S google-chrome libxft-bgra rofi dmenu tmux tor-browser discord neovim jetbrains-toolbox vim pamixer playerctl betterlockscreen pcmanfm spectacle alacritty picom nitrogen libxinerama network-manager-applet copyq obsidian
    ```
    2. Install yay if you not installed it.
    3. Run this command to install all avilable dependencies in the AUR repostory `yay -S xkblayout`
    4. Clone this repostory `git clone https://github.com/anas-elgarhy/dwm-anas.git`
    5. Go to the source directory `cd dwm-anas/src`
    6. Build and install `sudo make install clean`
    7. Enjoy 😉


### Available in 

[![GitHub](https://img.shields.io/badge/GitHub-Main%20repo-brightgreen?style=for-the-badge&logo=GitHub)](https://github.com/anas-elgarhy/dwm-anas)
[![GitLab](https://img.shields.io/badge/GitLab-Mirror%20repo-brightgreen?style=for-the-badge&logo=GitLab)](https://gitlab.com/anas-elgarhy/dwm-anas)
[![BitBucket](https://img.shields.io/badge/BitBucket-Mirror%20repo-brightgreen?style=for-the-badge&logo=BitBucket)](https://bitbucket.org/anas_elgarhy/dwm-anas)
[![Codeberg](https://img.shields.io/badge/Codeberg-Mirror%20repo-brightgreen?style=for-the-badge&logo=Codeberg)](https://codeberg.org/anas-elgarhy/dwm-anas)

### Refrences:
- [XF86keysym](https://cgit.freedesktop.org/xorg/proto/x11proto/tree/XF86keysym.h)
Create the readme file 🥰 2022-07-10 13:07:52 +00:00			`# Anas Elgarhy's dwm`
Improve the readme file 🤍 2022-07-11 03:59:03 +00:00			`## My fork from dwm 🍴, with a lot of beautiful patches 🥰`
Create the readme file 🥰 2022-07-10 13:07:52 +00:00
Add more screenshots 🥰 2022-07-11 05:05:23 +00:00			`![dwm screenshot](./screenshots/dwm-6.3-0.1.0.png)`
			`![dwm and 2 alacritty](./screenshots/dwm_bpytop_and_ufetch_tile_layout-6.3-0.1.0.png)`
			`![dwm and alacritty](./screenshots/dwm_alacritty-6.3-0.1.0.png)`
Add new screenshot 🧡 2022-07-11 08:58:44 +00:00			`![dwm and alacritty and cmus and cava](./screenshots/dwm_alacritty_cmus_cava-6.3-0.1.1.png)`
Create the readme file 🥰 2022-07-10 13:07:52 +00:00
			`### Applayed patches:`
Add patches links 🔗 2022-07-10 16:43:56 +00:00			`- [alwayscenter](https://dwm.suckless.org/patches/alwayscenter)`
			`- [cool autostart](https://dwm.suckless.org/patches/cool_autostart)`
			`- [fullscreen](https://dwm.suckless.org/patches/fullscreen)`
Add gridmode patch link 🔗 2022-07-10 17:23:18 +00:00			`- [gridmode](https://dwm.suckless.org/patches/gridmode)`
Add patches links 🔗 2022-07-10 16:43:56 +00:00			`- [movestack](https://dwm.suckless.org/patches/movestack)`
			`- [pertag](https://dwm.suckless.org/patches/pertag)`
			`- [systray](https://dwm.suckless.org/patches/systray)`
Add the sticky patch 😋 2022-07-10 16:59:56 +00:00			`- [sticky](https://dwm.suckless.org/patches/sticky)`
Applay noborder patch 🥰 2022-07-10 17:12:28 +00:00			`- [noborder](https://dwm.suckless.org/patches/noborder)`
Applay the fibonacci layouts and improve the code🥰 2022-07-10 18:24:03 +00:00			`- [fibonacci layouts](https://dwm.suckless.org/patches/fibonacci)`
Applay the centeredmaster layout 🥰 2022-07-10 20:02:35 +00:00			`- [centeredmaster](https://dwm.suckless.org/patches/centeredmaster)`
Applay applay keychain patch 🥰 2022-07-28 10:04:30 +00:00			`- [keychain](https://dwm.suckless.org/patches/keychain)`
Create the readme file 🥰 2022-07-10 13:07:52 +00:00
			`### Keys`
Add the sticky patch 😋 2022-07-10 16:59:56 +00:00			`\| Keys \| Function \|`
			`\|--------------------------------\|-----------------------------------------------------------------------\|`
			`\| modkey + shift + d \| Open dmenu (launcher) \|`
Fix 😊 2022-07-11 08:08:29 +00:00			`\| modkey + shift + ctrl + d \| Open rofi launcher (small size) \|`
Add the sticky patch 😋 2022-07-10 16:59:56 +00:00			`\| modkey + enter \| Launche the main terminal (alacritty by default) \|`
Add more keys 🥰🥰🥰 2022-07-11 06:02:44 +00:00			`\| modkey + t -> a \| Launche the alacritty terminal \|`
Applay applay keychain patch 🥰 2022-07-28 10:04:30 +00:00			`<!-- \| modkey + t -> shift + a \| Launche the alacritty terminal with tmux \| -->`
Add kitty shorcut and remove konsole 😶‍🌫️ 2022-07-12 05:11:56 +00:00			`\| modkey + t -> k \| Launche the kitty terminal \|`
Applay applay keychain patch 🥰 2022-07-28 10:04:30 +00:00			`<!-- \| modkey + t -> shift + k \| Launche the kitty terminal with tmux \| -->`
Remove plasma garbage 😆 2022-07-12 04:36:45 +00:00			`\| modkey + shift + f -> g \| Launche the GUI file manger (pcmanfm by default) \|`
Add more keys 🥰🥰🥰 2022-07-11 06:02:44 +00:00			`\| modkey + shift + f -> f \| Launche rofi file file browser (small size) \|`
Change mode + shift + f -> r to ... -> t for open the ranger 😀 2022-07-24 15:55:33 +00:00			`\| modkey + shift + f -> t \| Launche the terminal file manger (ranger) in the main terminal \|`
Add the sticky patch 😋 2022-07-10 16:59:56 +00:00			`\| modkey + w -> g \| Launche google chrome browser \|`
			`\| modkey + w -> t \| Launche tor browser \|`
			`\| modkey + c -> d \| Launche discord \|`
Add obsidian shortcur and add stickyeys script to auto run stuff 2022-07-16 09:53:10 +00:00			`\| modkey + c -> o \| Launche obsidian \|`
Add the sticky patch 😋 2022-07-10 16:59:56 +00:00			`\| modkey + a -> j \| Launche jetbrains-toolbox \|`
			`\| modkey + a -> n \| Launche NeoVim in the main terminal \|`
			`\| modkey + a -> v \| Launche Vim in the main terminal \|`
Add more kays 🥰 2022-07-11 04:52:38 +00:00			`\| modkey + a -> e \| Launche emacs \|`
Remove plasma garbage 😆 2022-07-12 04:36:45 +00:00			`\| modkey + p -> b \| Launche the background manger (nitrogen by default) \|`
			`\| modkey + p -> n \| Lanuche the network manager (nm-connection-editor) \|`
Add the sticky patch 😋 2022-07-10 16:59:56 +00:00			`\| modkey + e \| Launche rofi emoji selector \|`
			`\| modkey + f \| Toggle full screen mode \|`
			`\| modkey + b \| Toggle the status bar (hide/show) \|`
			`\| modkey + j \| Change the focus to privus window in the stack \|`
			`\| modkey + k \| Change the focus to the next window in the stack \|`
			`\| modkey + i \| Change the stack layout to virtecal \|`
			`\| modkey + d \| Change the stack layout to horizontal \|`
			`\| modkey + h \| Decrease the focus window size \|`
			`\| modkey + l \| Increase the focus window size \|`
			`\| modkey + Tab \| Toggle between the curent tag and the privus tag \|`
			`\| modkey + shift + j \| Move the focus window down in the stack \|`
			`\| modkey + shift + k \| Move the focus window up in the stack \|`
			`\| modkey + q -> q \| Quit from the focus window (kill it) \|`
			`\| modkey + s -> t \| Use the tile layout \|`
			`\| modkey + s -> f \| Use the float layout \|`
			`\| modkey + s -> m \| Use the monocle layout \|`
			`\| modkey + s -> g \| Use the grid layout \|`
Applay the fibonacci layouts and improve the code🥰 2022-07-10 18:24:03 +00:00			`\| modkey + s -> r \| Use the spial layout (part from fibonacci layouts) \|`
Applay applay keychain patch 🥰 2022-07-28 10:04:30 +00:00			`\| modkey + s -> d \| Use the dwindle layout (part from fibonacci layouts) \|`
Applay the centeredmaster layout 🥰 2022-07-10 20:02:35 +00:00			`\| modkey + s -> c \| Use the centerd master layout \|`
Applay applay keychain patch 🥰 2022-07-28 10:04:30 +00:00			`\| modkey + s -> x \| Use the centerd floating master layout \|`
			`\| modkey + s -> s \| Toggle between current layout and tile layout \|`
Add the sticky patch 😋 2022-07-10 16:59:56 +00:00			`\| modkey + shift + s \| Toggle sticky mode \|`
			`\| modkey + alt + f \| Toggle floating window \|`
Remove plasma garbage 😆 2022-07-12 04:36:45 +00:00			`\| modkey + m -> c \| Launche the cmus player \|`
Add vlc shortcut 😁 2022-07-11 02:42:03 +00:00			`\| modkey + m -> v \| Launche vlc video player \|`
Applay applay keychain patch 🥰 2022-07-28 10:04:30 +00:00			`<!-- \| modkey + m -> shift + v \| Lanuche nvlc in the main terminal \| -->`
Add the sticky patch 😋 2022-07-10 16:59:56 +00:00			`\| modkey + 0 \| View all tags \|`
			`\| modkey + shift + 0 \| Mirror the current tag in all tags \|`
			`\| modkey + comma (,) \| - \|`
			`\| modkey + period (.) \| - \|`
			`\| modkey + shift + comma (,) \| - \|`
			`\| modkey + shift + period (.) \| - \|`
			`\| modkey + (1..9) \| Navigate between tags \|`
Improve the readme file 🤍 2022-07-11 03:59:03 +00:00			`\| modkey + shift + (1..9) \| Move the focus window to specific tag \|`
			`\| modkey + control + (1..9) \| - \|`
			`\| modkey + shift + ctrl + (1..9) \| Mirror the current tag in specific tag \|`
Improve 💙 2022-07-11 04:19:43 +00:00			`\| superkey + space \| Change the keyboard layout (ar, en) \|`
Add the sticky patch 😋 2022-07-10 16:59:56 +00:00			`\| PrtSc \| Take a screenshot using default screenshot tool (spectacle) \|`
			`\| modkey + shift + x \| Lock the screen (using betterlockscreen) \|`
			`\| modkey + shift + alt + q \| Kill dwm \|`
Create the readme file 🥰 2022-07-10 13:07:52 +00:00
			`> modkey = win key or super key`

			`### Dependencies (apps)`
Improve the readme file 😇 2022-07-10 15:59:57 +00:00			- `google-chrome-stable` the main web browser
			- `alacritty` the main terminal
			- `spectacle` the main screenshot tool
Remove plasma garbage 😆 2022-07-12 04:36:45 +00:00			- `pcmanfm` the GUI file manger
Improve the readme file 😇 2022-07-10 15:59:57 +00:00			- `rofi`
			- `dmenu`
			- `libxinerama-dev`\\
			- `tmux`\*
			- `tor-browser`
			- `discord`
			- `libxft-bgra` for color emojies support
			- `jetbrains-toolbox`
			- `nvim`\*
			- `vim`\*
			- `xbacklight` for control in the screen brightness
			- `pamixer` for control in the audio level
			- `playerctl` for control in the media
			- `pactl` for control in the mic
			- `betterlockscreen` for lock screen
			- `setxkbmap` for switch between keyboard layouts, like (ar, en)
			- `slstatus` the status bar
Remove plasma garbage 😆 2022-07-12 04:36:45 +00:00			- `network-manager-applet`
Improve the readme file 😇 2022-07-10 15:59:57 +00:00			- `picom` compositor , for transparency
			- `nitrogen` for set the wallpaper
Remove plasma garbage 😆 2022-07-12 04:36:45 +00:00			- `copyq` clipboard manager
Add obsidian shortcur and add stickyeys script to auto run stuff 2022-07-16 09:53:10 +00:00			- `obsidian`
Create the readme file 🥰 2022-07-10 13:07:52 +00:00
Improve the readme file 😇 2022-07-10 15:59:57 +00:00			`> \\: build dependencie.`

			`### Install`
Improve 💙 2022-07-11 04:19:43 +00:00			`- Manual:`
Improve the readme file 😇 2022-07-10 15:59:57 +00:00			`1. Run this command to install all avilable dependencies in standerd arch repostory`
			```bash
Improve the install steps 😉 2022-07-16 17:05:02 +00:00			`sudo pacman -S google-chrome libxft-bgra rofi dmenu tmux tor-browser discord neovim jetbrains-toolbox vim pamixer playerctl betterlockscreen pcmanfm spectacle alacritty picom nitrogen libxinerama network-manager-applet copyq obsidian`
Improve the readme file 😇 2022-07-10 15:59:57 +00:00			```
			`2. Install yay if you not installed it.`
Improve 😁 2022-07-11 04:23:07 +00:00			3. Run this command to install all avilable dependencies in the AUR repostory `yay -S xkblayout`
Fix install steps 🥰 2022-07-10 17:34:35 +00:00			4. Clone this repostory `git clone https://github.com/anas-elgarhy/dwm-anas.git`
Improve the install steps 😉 2022-07-16 17:05:02 +00:00			5. Go to the source directory `cd dwm-anas/src`
			6. Build and install `sudo make install clean`
			`7. Enjoy 😉`
Add mirors links 🔗🪩 2022-07-16 17:28:20 +00:00

			`### Available in`

			`[![GitHub](https://img.shields.io/badge/GitHub-Main%20repo-brightgreen?style=for-the-badge&logo=GitHub)](https://github.com/anas-elgarhy/dwm-anas)`
			`[![GitLab](https://img.shields.io/badge/GitLab-Mirror%20repo-brightgreen?style=for-the-badge&logo=GitLab)](https://gitlab.com/anas-elgarhy/dwm-anas)`
			`[![BitBucket](https://img.shields.io/badge/BitBucket-Mirror%20repo-brightgreen?style=for-the-badge&logo=BitBucket)](https://bitbucket.org/anas_elgarhy/dwm-anas)`
			`[![Codeberg](https://img.shields.io/badge/Codeberg-Mirror%20repo-brightgreen?style=for-the-badge&logo=Codeberg)](https://codeberg.org/anas-elgarhy/dwm-anas)`

Create refrences section 🥰 2022-07-24 15:45:13 +00:00			`### Refrences:`
			`- [XF86keysym](https://cgit.freedesktop.org/xorg/proto/x11proto/tree/XF86keysym.h)`