jwalton3141/dotfiles

This project aims to configure a lightweight, performant and keyboard driven Ubuntu experience.

What's provisioned?

Alacritty provides the terminal emulator. Marketed as "the fastest terminal emulator in existence".
i3wm is configured as the window manager. Keybindings are set to match that of the vim set-up.
Polybar provides the top bar for the desktop. Polybar can be fiddly to correctly install and configure. Here the install and configuration is done for you.
Vim is my text editor of choice, the plugins vim-airline and vim-snazzy are installed to work out of the box.
Zsh is used as the default shell. Zsh goodies are of course provisioned through the oh-my-zsh project.
Fonts that work. Getting fonts and icons set-up to work with vim and polybar is a pain. Here fonts with good support for vim and polybar are installed and configured to play nice.

With a fresh Ubuntu (or similar) install you'll first need to install git:

sudo apt install git

You can then go ahead and clone this repo with

git clone https://github.com/jwalton3141/dotfiles.git

Change into the directory created by your clone command (here dotfiles/), and run ./setup.sh

cd dotfiles && ./setup.sh

And you're done. Exit your current session, select i3 and log back in.

There are a number of things which you may with to tweak before running setup.sh.

Firstly, you likely wish to alter the git config as defined in lines 15--17 of setup.sh to reflect your user.
You almost certainly will wish to amend the list of packages to install. The packages to install are in scripts/pkglist. Be careful when you remove items from this list as the program you remove may be needed for setup.sh to successfully complete.
scripts/piplist can be ammended if you're a python user and have other package requirements. If you're not a python user you can safely remove line 12 (scripts/install_pip.sh) of setup.sh

Tested on Ubuntu 18.04 LTS and 20.04 LTS