README.md

dotfiles

Intro

This README will serve as a reference for all the tools used in making this rice as well as credits for inspiration and the location where specific tips and tricks were found. It will also contain links to most resources used with this config (wallpapers, themes, etc.)

Quick Start

1. Install the required packages. They can be found below. That list is kept current as much as possible, but it is very much a "best effort", sometimes I forget things.
2. Run the install script from this repo, which will just create symlinks from the dotfiles in this repo to the correct locations on your system. This is done with dotbot.
3. Download my wallpaper here.
4. Download some icons that you like, I use papirus.
5. Download a nice gtk theme, mine is Nordic.
6. Use lxappearance to select the right gtk theme.

Install Script

To install my configurations, you just have to clone this repo and run ./install. I recommend checking the install.conf.yaml file before blindly installing because it will expect specific directories to exist which you might not have. Also it's good practice not to run random commands you find.

Install List

Backup & Sync

• awscli
• borg
• syncthing [ arch package ]

Desktop

• awesomewm [ arch wiki ]
• betterlockscreen [ aur package ]
• rofi [ arch wiki ]
• picom [ arch package ]
• firefox [ arch wiki ]
• gtk [ arch wiki ]
  • Nordic (theme)
• lxappearance [ arch package ]
• papirus
• ranger [ arch wiki ]
• Fonts
  • FontAwesome [ arch package ]
  • Iosevka
  • JoyPixels (emoji) [ AUR ]

Documents

• xreader [ arch package ]
• xournal++

Editor & Code

• git [ arch wiki ]
• neovim
• vscode [ arch wiki ]

Media

• vlc
• spicetify-cli
• spotify [ aur package ]

Misc

• acpilight [ arch package ]
• bitwarden-cli [ AUR ]
• bitwarden-rofi [ AUR ]
• yay
• xclip [ arch package ]
• xrandr [ arch wiki ]
• arandr [ arch package ]

Plugins

• tmux
  • tpm
  • tmux-resurrect
  • tmux-sensible
  • tmux-onedark-theme
• neovim
  • vim-plug
  • vim-polyglot
  • nerdtree
  • vim-fugitive
  • ctrlp
  • onedark
• vscode
  • Atom One Dark Theme
• zsh
  • zsh-autosuggestions [ arch package ]
  • zsh-syntax-highlighting [ arch package ]
  • starship
• python
  • virtualenvwrapper

Shell & Term

• kitty
• zsh
• tmux [ arch wiki ]

Social

• Discord
• telegram
• slack

Themes

• Firefox One Dark Theme.
• Rofi Slate (included in this repo).
• Slack Nord.
• Spotify Nord.
• Telegram Telegram Nord Theme.

Details

Backlight

By default, only root has access to change the screen brightness. To allow other users to do it without sudo (which will be necessary to use keyboard shortcuts), follow instructions on the wiki.

Bash Scripts

I've created some scripts to make some operations more convenient for me, which can be found in the bin/ folder.

• jsink [ A script to add/remove/list JACK-enabled PulseAudio sinks. This enables moving audio from specific applications through JACK easily, which allows fine-grained processing. For example, sending audio from a music player through a DAW before combining it with a microphone input for live streaming. ]
• wacom [ A small script to map my Wacom tablet to a given display and map buttons to keyboard shortcuts. If you choose to use this, make sure you edit it so it works with your tablet. As long as you just have one tablet at a time, mapping to a display will always work. However, button IDs are inconsistent between tablets, so you can use xev -event button and press buttons to see what the button IDs are for your tablet's physical buttons. Once you know which IDs your button has, you can replace mine in the script. ]

Notes

backups

I've documented all my approach to backups in a blog post which you can read here!