Linux (Ubuntu) Development Environment

The purpose of this repo is to create a development enviroment that is as efficient to a developer as possible; independent of the mouse as much as possible.

Table of Contents

1. Neovim setup
   • How-To-Use guide for this specific config
2. Tmux and Tmuxifier setup
3. i3 Window Manager
4. Sources

Setup

1. NeoVim

Install NeoVim

curl -LO https://github.com/neovim/neovim/releases/latest/download/nvim-linux64.tar.gz
sudo rm -rf /opt/nvim
sudo tar -C /opt -xzf nvim-linux64.tar.gz

To make nvim your default text editor, add this to your shell config (could be .zshrc or .bashrc)

export PATH="$PATH:/opt/nvim-linux64/bin"
export EDITOR='nvim'

Install requirements

First install requirements for the LSP plugin to work:

sudo apt install nodejs npm exuberant-ctags silversearcher-ag ripgrep fd-find

Install the config

Neovim config is located in ./.config/nvim, to apply this config, simply:

cp -r ~/path/to/this/repo/.config/nvim ~/.config/nvim

You may or may not have to install dependencies for all the plugins to work. If something doesn't work as intended, please take a look at one of the nvim config videos listed among sources below.

It is recommended to watch at least the first video for NeoVim config, to get you started with the basics of configuring neovim using lua and Packer package manager.

• Packer official docs/repo: https://github.com/wbthomason/packer.nvim

To check if everything works:

nvim ~/.config/nvim/lua/core/plugins.lua

# Inside nvim:
:PackerSync
# This is to ensure all plugins are installed and up to date

NOTE: The first run might take a while because the plugins are auto-installing and you might get some error messages displayed, but that's okay.

Once everything is done installing (you should see a list of packages on the left side pane). When you get that, simply quit neovim, reopen it, and run :PackerSync to make sure all packages are installed and up to date.

NOTE: To get you started with using this specific NeoVim config, this How-To-Use guide for this specific config may come in handy.

2. Tmux

Install tmux

sudo apt update
sudo apt install tmux

Tmux config is located in ./.tmux.conf.

Install tmux plugin manager

git clone https://github.com/tmux-plugins/tpm.git ~/.tmux/plugins/tpm

To apply the config:

# Start tmux
tmux

# Within the tmux session
Ctrl + s + I  # To install all plugins
Ctrl + s + r  # Source tmux (refresh)

Tmuxifier

Tmuxifier repo - https://github.com/jimeh/tmuxifier

1. Install:

git clone https://github.com/jimeh/tmuxifier.git ~/.tmuxifier

For additional how-tos for tmuxifier, either visit the official repo for docs or follow the video tutorial listed among the sources below.

2. Add configs to your shell (.zshrc, .bashrc - depending on the shell you're using):

export EDITOR='nvim'
export PATH="$HOME/.tmuxifier/bin:$PATH"
eval "$(tmuxifier init -)"

3. i3 Window Manager

That's to make your desktop environment not as dependant on mouse clicking as the default would be.

Requirements

package	what for
feh	setting up a wallpaper
redshift	setting up a color temperature
i3lock	locking the screen
brightnessctl	adjusting screen brightness
playerctl	audio player keyboard controlls (pause, resume, skip, go back)

Note: you'll also need to install a CodeNewRoman Nerd Font Mono to make all the icons work properly.

1. install i3

# For Ubuntu
/usr/lib/apt/apt-helper download-file https://debian.sur5r.net/i3/pool/main/s/sur5r-keyring/sur5r-keyring_2023.02.18_all.deb keyring.deb SHA256:a511ac5f10cd811f8a4ca44d665f2fa1add7a9f09bef238cdfad8461f5239cc4
sudo apt install ./keyring.deb
echo "deb http://debian.sur5r.net/i3/ $(grep '^DISTRIB_CODENAME=' /etc/lsb-release | cut -f2 -d=) universe" | sudo tee /etc/apt/sources.list.d/sur5r-i3.list
sudo apt update
sudo apt install i3

2. install requirements

sudo apt update
sudo apt install feh redshift i3lock brightnessctl playerctl

Install font

# If you don't have ~/.fonts/ directory yet
mkdir ~/.fonts/

# Install
curl -L https://github.com/ryanoasis/nerd-fonts/releases/download/v3.1.1/CodeNewRoman.zip -o ~/.fonts/CodeNewRoman.zip && unzip ~/.fonts/CodeNewRoman.zip

reboot

3. After reboot

1. Click on your user profile
2. On the boottom right corner, click on the cog wheel and select i3
3. Log in with your password
4. Go through i3 wizard (make sure to select yes to generating a config)

Note: it might take some time to startup on the first time, because of i3 setting up.

4. Using this repo's config

1. Clone this repo wherever you like
2. Copy this-repo/.config/i3 and this-repo/.config/i3status into ~/.config/

cp path-to-this-repo/.config/i3* ~/.config/

3. Reload your config file: $mod+Shift+c
   • $mod is whatever key you chose in the setup wizard; it could be Alt or Win

Sources

NVIM config

1. Make nvim fancy, nvim plugin manager, nvim lua config structure (basics): https://youtu.be/J9yqSdvAKXY?list=PLsz00TDipIffxsNXSkskknolKShdbcALR
2. Autocomplete and other plugins: https://www.youtube.com/watch?v=h4g0m0Iwmys
3. LSP: https://www.youtube.com/watch?v=lpQMeFph1RE

TMUX config

1. Make tmux great again: https://youtu.be/H70lULWJeig
2. Tmux plugins: https://youtu.be/qyV_hOtMdwg
3. Tmuxifier: https://www.youtube.com/watch?v=ceRYL271cao

Tmuxifier repo

• https://github.com/jimeh/tmuxifier

i3 docs

1. Installation guide: https://i3wm.org/docs/repositories.html
2. User guide for config: https://i3wm.org/docs/userguide.html
3. Config docs for i3bar: https://i3wm.org/docs/userguide.html#_configuring_i3bar
4. Config docs for i3status: https://i3wm.org/docs/i3status.html

Other useful links for customizing your setup

1. Color pallete: https://coolors.co/231f3b-18152e-4f497f-6157a9-eadaa2