Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/WillPower3309/awesome-dotfiles

Dotfiles for awesome people using the awesomewm linux environment
https://github.com/WillPower3309/awesome-dotfiles

List: awesome-dotfiles

arch awesome awesomewm config dotfiles emacs linux lua neovim nvim picom rice rofi theme vim

Last synced: 9 days ago
JSON representation

Dotfiles for awesome people using the awesomewm linux environment

Host: GitHub
URL: https://github.com/WillPower3309/awesome-dotfiles
Owner: WillPower3309
Created: 2019-11-25T16:21:33.000Z (almost 5 years ago)
Default Branch: master
Last Pushed: 2024-08-09T23:23:50.000Z (3 months ago)
Last Synced: 2024-10-28T10:51:48.888Z (14 days ago)
Topics: arch, awesome, awesomewm, config, dotfiles, emacs, linux, lua, neovim, nvim, picom, rice, rofi, theme, vim
Language: Lua
Homepage:
Size: 149 MB
Stars: 1,178
Watchers: 23
Forks: 68
Open Issues: 17
Metadata Files:
- Readme: README.md

Awesome Lists containing this project

jimsghstars - WillPower3309/awesome-dotfiles - Dotfiles for awesome people using the awesomewm linux environment (Lua)

README

Awesome Dotfiles

Pastel Theme

![](/screenshots/pastel.png)

Mirage Theme

![](/screenshots/mirage.png)

## Contents ##
1. [Details](#details)
2. [Features](#features)
3. [Dependencies](#dependencies)
4. [Installation](#installation)
5. [Folder Structure](#folderStructure)
6. [Application Theming](#appTheming)
7. [Keybinds](#keybinds)
8. [Notes](#notes)

## Details ##
+ **Shell**: ZSH
+ **WM**: awesome
+ **Theme**: Qogir Dark
+ **Icons**: Tela Dark
+ **Cursor**: xCursor Breeze Light
+ **Terminal**: Alacritty

## Features ##
+ Super lightweight
+ Easy installation / configuration
+ Very few dependencies
+ Exit screen
+ Locking (via `i3lock`)
+ Touch screen friendly (I primarily run this on a microsoft surface pro 6)
+ Automatic dpi / resolution scaling
+ Note that xft.dpi must be properly assigned in the .Xresources file if you are using a high DPI screen
+ Supports multi monitor setups!
+ The top bar appears on every monitor, and the side bar only appears on the main monitor
+ i3-like keybinds
+ Very stable: Built off of the awesome 4.3 release, no bleeding edge git versions required here!

## Dependencies ##
I have made my best effort to reduce the number of dependencies by using the awesome API to its fullest extent, and allowing users to specify their preferred applications via the `rc.lua` file (see [installation section](#installation)). That being said, here are the dependencies:

### Optional Dependencies ###
These will improve the user experience but aren't required:
**Bear in mind that most of these dependencies come preinstalled on non arch systems. I would recommend reading their descriptions below to determine which ones you need to install. Alternatively, set up my config and install the packages based on what isn't appearing in the top panel.**
+ `i3lock`: Will be opened when the lock icon is selected in the exit window
+ `acpi`: Battery managing cli application, used by top bar widget to determine battery status
+ `bluez`, `bluez-utils`: Bluetooth cli application, used by top bar widget to determine if bluetooth is on
+ `blueman`: Bluetooth managing application, spawns when the bluetooth top panel icon is clicked
+ `scrot`: Screenshot tool, which is mapped to the Print Screen key in keys.lua. **If you want to meet this dependency, ensure that the `~/Pictures` folder exists**, otherwise the program will save your screenshots to your home directory
+ `alsa-utils`: Provides kernel driven sound drivers, which the control of has been mapped to volume keys in keys.lua
+ `xbacklight`: Controls display brightness, which the control of has been mapped to brightness keys in keys.lua

### Fonts You Should Install ###
+ `SF Text`: System font used by macOS, iOS, and watchOS. Used in this config as the WM font. Also used as font for firefox
+ [`MesloLGS`](https://github.com/romkatv/powerlevel10k-media/raw/master/MesloLGS%20NF%20Regular.ttf): Terminal font, customized to work flawlessly with the zsh theme used, mentioned in the [application theming](#appTheming) section of the readme.

## Installation ##
1. Ensure all [dependencies](#dependencies) are met
2. Clone this repository and place its contents into your `.config` folder
3. edit the `awesome/rc.lua` file to select your theme, and define your desired default and startup applications, as well as network interfaces
4. navigate to the `awesome/wallpaper` folder and place your desired wallpaper there, ensuring that it is named either `wallpaper.jpg` if using the pastel theme, or `mirage.png` if using the mirage theme. Remember to delete the `blurredWallpaper` file in order to make the blurring script recognize a new wallpaper has been added and needs to be blurred
5. optional: edit the `keys.lua` file to change / add keybinds

## Awesome Folder File Structure ##
In order to avoid a poorly organized `rc.lua` spanning thousands of lines, it has been split into multiple files / folders. I have taken extra care to create a logical directory structure that will hopefully allow those new to awesomewm to have an easy time navigating it.
+ `rc.lua`: The main script that runs when awesome starts. Defines theme and default applications, and selects them
+ `keys.lua`: Contains keybinds
+ `rules.lua`: Contains window rules
+ `pastel.lua`: Initializes the pastel theme (spawns all of the pastel theme components)
+ `mirage.lua`: Initializes the mirage theme (spawns all of the mirage theme components)
+ `themes`: Contains files with theme variables (ie colors, sizing, font, etc)
+ `icons`: stores icons used in WM
+ `components`: Folder that contains all of the components of the WM, such as panels, volume and brightness sliders, notification pop-ups, etc
+ `configuration`: Contains theme-based config files for applications (ie rofi, picom, etc)
+ `widgets`: Stores widgets used in the functionality of the components
+ `wallpaper`: Where wallpaper and its blurred varient is generated / stored

### Other cool applications you should install ###
+ `redshift`: Changes screen warmth based on the time of day
+ `neofetch`: Displays system information in the terminal
+ `cmatrix`: Terminal base matrix text effect

## Application Theming ##
### Firefox ###
**Pastel**
1. Set up [my custom Firefox theme](https://github.com/willpower3309/MinimalistMaterialFox)
2. Use [this](https://github.com/Jaredk3nt/homepage) homepage
3. Use `SF Text` font

**Mirage**
1. Set up the [blurredfox theme](https://github.com/manilarome/blurredfox)
2. Replace the `colors/blurred.css` with the one found in this repo under `awesome/configuration/mirage/blurred.css`

### Spotify ###
1. [Install `Spicetify`](https://github.com/khanhas/spicetify-cli)
2. chown spotify directory: `sudo chown $USER -R /opt/spotify`
3. run `spicetify` once to generate config
4. `spicetify backup apply enable-devtool` to enable devtools
5. Copy my spicetify folder to `~/.config`
6. run `spicetify update restart`

### Neovim ###
1. Ensure the nvim folder from the repo has been copied into the `~/.config` directory
2. Install VimPlug with
```
curl -fLo ~/.local/share/nvim/site/autoload/plug.vim --create-dirs \
https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vim
```
3. Open neovim and run `:PlugInstall`
4. Exit and reopen neovim

### Zsh ###
1. Install oh-my-zsh
```
sh -c "$(curl -fsSL https://raw.github.com/robbyrussell/oh-my-zsh/master/tools/install.sh)"
```
2. Change the zsh theme to powerlevel10k
+ Download [this font](https://github.com/romkatv/powerlevel10k-media/raw/master/MesloLGS%20NF%20Regular.ttf), and move it into your `/usr/share/fonts` directory
+ Install powerlevel10k with the command below:
```
git clone --depth=1 https://github.com/romkatv/powerlevel10k.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/themes/powerlevel10k
```
+ Open `~/.zshrc` with your fave text editor
+ Set `ZSH_THEME="powerlevel10k/powerlevel10k"` and save the file
3. Install Plugins (Note that the ~/.zshrc edits are already done in this repo)
+ Syntax highlighting (copy and paste the below command to install)
```
git clone https://github.com/zsh-users/zsh-syntax-highlighting.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting
```
+ Edit `~/.zshrc`, add `zsh-syntax-highlighting` to the plugins section
+ Autosuggestions (copy and paste the below command to install)
```
git clone https://github.com/zsh-users/zsh-autosuggestions ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions
```
+ Edit `~/.zshrc`, add `zsh-autosuggestions` to the plugins section
4. Fini! Reopen the terminal to view the fruit of your labor

## Keybinds ##
**Note that the modkey is set to be the windows / command key. If you would like to use a different modkey check out the `keys.lua` file.**
If you are new to awesomewm, note that tag refers to workspace, and client refers to window. Shown below are the **main** keybinds that most users will care about.

### Keyboard ###
+ `mod + enter`: Spawn terminal
+ `mod + d`: Spawn rofi (an application menu)
+ `mod + f`: Make client fullscreen
+ `mod + m`: Maximize client
+ `mod + n`: Minimize client
+ `mod + shift + n`: Unminimize client
+ `mod + [1-9]`: Switch to tag [1-9]
+ `mod + shift + [1-9]`: Move client to tag [1-9]
+ `mod + space`: Change the tag layout, alternating between tiled, floating, and maximized
+ `mod + [up / down / left / right / h / j / k / l]`: Change client by direction
+ `mod + Shift + [up / down / left / right / h / j / k / l]`: Move client by direction
+ `mod + Control + [up / down / left / right / h / j / k / l]`: Resize client by direction
+ `mod + Escape`: Show exit screen

### Mouse ###
+ `mod + drag with left click`: Move client
+ `mod + drag with right click`: Resize client

## Notes ##
+ [Awesome API Documentation](https://awesomewm.org/apidoc/index.html)
+ If you encounter any problems please open an issue in this repo and I will gladly investigate it
+ If you would like to change the wallpaper, ensure that the wallpaper is named "wallpaper" and is located in the `~/.config/awesome` folder. Also ensure that you delete the blurred wallpaper file in order for the blurring script to recognize it needs to generate a new blurred wallpaper