🗃️ dotfiles

My personal software installation & configuration

☣️ Disclaimer

This is a repository that I keep public in order to ease out the installation of my different computers.

The repository is not intended to be used as-is by many people, although special attention and care has been put in order to make it sensibly easy to be used by anyone wanting to try out this installation.

Although the goal for any non-contributor is to get inspiration, not to use it as you daily driver. Nothing can stop you from doing it so feel free to do so and open issues, but I can't guarantee to be available to fix issues.

🔥 Features

Gnome with Pipewire to get the maximum of our audio/video
nvim with a ton of plugins for web development & Linux stuff
helix setup & configured with support for lazygit and lazydocker
Tons of browsers (actually just 4 but this is something) like chromium, google-chrome, opera & firefox
docker enabled for the unprivileged user so commands don't need prefixing with sudo anymore
tmux for terminal multiplexing with automatic installation & update of plugins before starting tmux
yazi to manipulate your file system using the y fish function
Enhanced ls command with colors & icons just like in VSCode
Enhanced cat command with syntactic colorization of files just like in VSCode
Custom privateinternetaccess function that lets you choose a configuration from OpenVPN using fzf for starting a new openvpn tunnel quickly
Get the latest weather news right in your terminal with wttr
Support for both intel & amd architecture (pull requests welcome to add VirtualBox & VMware Guest Additions)
ufw enabled and ready to protect your personal life
Lots of programming language's interpreter & compiler installed (Python, Ruby, PHP, Julia, ...)
Tons of Fish's abbreviations for docker & docker-compose
posting for HTTP requests in the terminal
ticker for watching various tickers from stocks & cryptos using Yahoo Finance tickers

📖 Requirements

⚙️ Setup

Hardware Installation

Coming soon...

👮 Create the user as administrator

# Install the necessary dependencies
pacman -S sudo fish git

# Allow members of the group "sudo" to issue sudo commands
sed -i 's/# %sudo/%sudo/g' /etc/sudoers

# Add the "sudo" group
groupadd sudo

# Add the unprivileged user
useradd --create-home --shell /bin/fish --groups sudo --uid 1000 user

# Setup the password for the unprivileged user
passwd user

🧔 Installation as user

# Clone the repository in the home folder
git clone https://github.com/aminnairi/dotfiles ~/Documents/git/github.com/aminnairi/dotfiles

# Change the current working directory to the source-code for the installation script
cd ~/Documents/git/github.com/aminnairi/dotfiles

# Apply the configuration
bash post-install.sh

ℹ️ Informations

✒️ Neovim

Neovim's plugins gets installed only when run. Try running nvim at least once per user root and the chosen unprivileged user.

✈️ Tmux

Tmux's plugins get installed once it is run without argument. A Fish function gets triggered whenever tmux is run. If it has no argument, then plugins gets checked and installed. If it has arguments, plugins do not get installed nor checked. Please run at least once tmux in order to install the necessary plugins before using it.

🔐 SSH

It's a good idea to backup your existing ~/.ssh/config file before erasing the informations contained in a previous computer.

Once the new computer is installed, don't forget to create a new SSH key using ssh-keygen -t ed25519 and to propagate this key to the relevant services (servers, GitHub, GitLab, ...). Although the post-install.sh script should already have prompted you to create a new key if it did not detect one.

🦆 Yazi

Yazi is a terminal file explorer that is written in Rust and has default keybinding using Vim motions, can render images in the terminal and is able to run a bunch of programs by default whenever hitting enter on one of them.

A fish function runs yazi by hitting y in the terminal for added velocity and is able to remmeber the folder you were in when you quit the explorer.