Dotfiles

What are dotfiles

Dotfiles get their name from the letter they start with, which is a dot. They are files that are hidden by default and often used for config files. However, I also other config files in this repository that aren't dotfiles.

Why are these dotfiles here?

The advantage of using Gitlab to manage your config files is that you can go back to any change that has been made and, if needed, download the old version and replace it with a new, possibly broken, version on your computer. It can also be used to quickly download (or git clone) all config files you need to get started on a new computer. Lastly, it is a lot easier to share your always updated config files with other people.

How can I use these files?

Prerequisites

1. You need to have i3-gaps installed if you are planning on copying any of the files from the .i3 folder.
2. Vim is pre-installed on most Linux distributions, however I use Vim in the terminal. I am not sure if any of the configs work with gVim or neoVim or any of the other types of vim. (if you want to use my .vim configs)
3. Ranger is the file manager I use. I am not sure whether it comes pre-installed with most Linux distributions, so please check whether Ranger has been installed. (if you want to use my ranger configs)
4. Pywal is highly recommended for changing backgrounds and colours on the fly (especially with my Ranger shortcut)
5. The mdv program
6. I use neomutt for my emails, so you'll need that as well
7. I use rofi as a program launcher ($mod+d)
8. I prefer to use termite, as it seems to have much better UTF8 support
9. If you want to get the most out of neomutt, I highly recommend using mutt-wizard
10. I generally use Zsh as my default Shell

Vim Plugins

To install the different Vim plugins that I use, you will need to install Vundle which can be downloaded by typing git clone https://github.com/VundleVim/Vundle.vim.git ~/.vim/bundle/Vundle.vim into your terminal. Afterwards, please try to run :PluginInstall; this should then automatically install the different plugins for you. Beware, however, that it may take a couple of seconds depending on your internet speed; it will say "Done!" when every plugin has been successfully downloaded.

How to get my set-up

In order to use these config files, you should firstly create a backup of your current config files (I recommend using git and Github for that as well. If that is too complicated, just rename them to something like configname.copy). After having created a backup of all important config files, you simply need to replace all all your files with the ones in this repository. Some config files have my username included, which means that if you try to run said config file you will most likely run into an error. Should you run into an error when running a config file or should something not work as intended, please check the config file and see if it includes my username and remove it.

DISCLAIMER! USE AT OWN RISK! I cannot be made responsible for any harm done to your computer

Fonts

Fonts are not included in this repository. The font I use for my Terminal (URxvt) is Adobe's Source Code Pro. You will need to download that yourself using your package manager.

Keybindings

These config files also include a large number of keybindings that have been tweaked or added to my liking. When using my configuration, please be aware that the keybindings that you are used to might have been changed. Here is a quick overview of most of the commands that have been added

Program	Command	Function
Ranger	CC	Pressing CC (change colour) when over an image file will start pywal using that image
Ranger	gPc, gDd, gDc ... (more here)	Pressing these button combinations will take you to a specified directory (g => goto), for example gPc => goto Pictures
Ranger	mvt (+directory)	Pressing this button combination over any file (mvt => move to) and then specifying a directory will move said file to said directory
Ranger	mvPc, mvDc, mvPw...	Will move selected file(s) to either ~/Pictures (mvPc), ~/Documents (mvDc) or ~/Pictures/wallpapers (mvPw)
Ranger	cpPc, cpDc, cpPw...	Will copy selected file(s) to either ~/Pictures (mvPc), ~/Documents (mvDc) or ~/Pictures/wallpapers (mvPw)
Ranger	oM, oE, oV, oW	oM parses a markdown file using mdv and displays it using w3m – the others open the selected file using Emacs, Vim or w3m respectively
Ranger	cpPc, cpDc, cpPw...	Will copy selected file(s) to either ~/Pictures (mvPc), ~/Documents (mvDc) or ~/Pictures/wallpapers (mvPw)
Ranger	dl	Will delete selected files
Ranger	exe mexe	Start selected executeable file (exe) or make file executeable (mexe)
Ranger	bk	Creates a backup file (filename.ending_bk) for the files selected
i3-gaps	Mod+Shift+P (+M)	Will increase (+P) or decrease (+M) outer gap size
i3-gaps	Mod+CTRL+P (+M)	Will increase (+P) or decrease (+M) inner gap size