https://github.com/btvtkh/dotfiles
personal dotfiles
https://github.com/btvtkh/dotfiles
awesomewm
Last synced: 2 days ago
JSON representation
personal dotfiles
- Host: GitHub
- URL: https://github.com/btvtkh/dotfiles
- Owner: btvtkh
- Created: 2023-11-29T15:25:03.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-04-27T09:30:54.000Z (4 days ago)
- Last Synced: 2025-04-27T10:34:54.047Z (4 days ago)
- Topics: awesomewm
- Language: Lua
- Homepage:
- Size: 320 KB
- Stars: 89
- Watchers: 2
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# AwesomeWM
Installation
#### 1. Install dependencies
```
xorg
xorg-xinit
awesome-git (aur)
luarocks
pulseaudio
pulseaudio-bluetooth
networkmanager
bluez
bluez-utils
picom
maim
alacritty
nemo
leafpad
eom
mpv
```
for example using [pikaur](https://github.com/actionless/pikaur) as an aur helper
```
$ pikaur -S xorg xorg-xinit awesome-git luarocks pulseaudio pulseaudio-bluetooth networkmanager bluez bluez-utils picom maim alacritty nemo leafpad eom mpv
```
#### 2. Install lua modules
| Module | Description |
| ----------------------------------------------------------------- | ----------------------------- |
| [luautf8](https://github.com/starwing/luautf8?tab=readme-ov-file) | Needed for text input widgets |
```
$ sudo luarocks install luautf8
```
#### 3. Start & enable `network manager` & `bluez` services
#### 4. Clone repo
```
$ git clone --depth 1 https://github.com/btvtkh/dotfiles.git
```
#### 5. Copy contens of `dotfiles/home` to your `home` folder (use `rsync` for example)
```
$ rsync -avhu ~/dotfiles/home/ ~/
```
#### 6. Download [JetBrainsMonoSlashed](https://github.com/sharpjs/JetBrainsMonoSlashed/releases) font and put it to `~/.fonts`
Customisation
#### 7. Edit `~/.config/awesome/user.lua` as you need, you can set wm theme, choose default terminal, and set data for weather widget
#### 8. Install icons and themes
1. Install `themix-full-git` from aur
2. Export icons and theme from user presets
#### 9. Install cursors (`inkscape` required) ([source](https://github.com/charakterziffer/cursor-toolbox))
```
$ cd ~/dotfiles/extra/cursor_toolbox
$ ./render-pngs.py ./sharp_cursors.svg
$ ./make_dark.sh
$ cp -r Sharp-Cursors ~/.icons
```
#### 10. Apply firefox css
1. Search `about:config`.
2. `toolkit.legacyUserProfileCustomizations.stylesheets`, `layers.acceleration.force-enabled`, `gfx.webrender.all`, `svg.context-properties.content.enabled` change to `True`.
3. Copy `~/dotfiles/extra/mozilla/chrome` to `~/.mozilla/firefox/XXXXXXX.default-release/`.
Keybinds
| Keybinding | Description |
| --------------------- | ---------------------------------------- |
| `Mod+Shift+r` | Restart awesomewm |
| `Mod+Tab` | Switch to next client by index |
| `Mod+Shift+Tab` | Switch to previus client by index |
| `Mod+Ctrl+Tab` | Restore minimized client |
| `Mod+Shift+s` | Swap with next client by index |
| `Mod+Ctrl+s` | Swap with previous client by index |
| `Mod+Shift+a` | Increase the number of master clients |
| `Mod+Ctrl+a` | Decrease the number of master clients |
| `Mod+Shift+q` | Increase the number of columns |
| `Mod+Ctrl+q` | Decrease the number of columns |
| `Mod+Shift+e` | Increase master width factor |
| `Mod+Ctrl+e` | Decrease master width factor |
| `Mod+Ctrl+Shift+e` | Reset master width factor |
| `Mod+Space` | Switch layout |
| `Mod+1...9` | Only view tag |
| `Mod+Shift+1...9` | Move focused client to tag |
| `Mod+z` | Close client |
| `Mod+x` | (Un)Maximize client |
| `Mod+c` | Minimize client |
| `Mod+v` | Toggle client fullscreen |
| `Mod+b` | Toggle client ontop |
| `Mod+n` | Move client to center |
| `Mod+m` | Toggle client menu |
| `Mod+Ctrl+Return` | Move client to master |
| `Mod+d` | Open app launcher |
| `Mod+q` | Open powermenu |
| `Mod+Return` | Open terminal |
| `Mod+Print` | Take screenshot |
| `Mod+Shift+Print` | Take screenshot area |