Hope

Highly Optimised Productivity Environment ~ Scripts and dot files of my ever evolving arch setup.

Screenshot 01	Screenshot 02

Features :

• uses linux-zen kernel.
• multilib support.
• driver suport for network, bluetooth, audio, chipset & gpu.
• multilingual font support with glyphs & emoticons.
• uses my pre-patched suckless apps ~ dwm, dmenu, slstatus & st.
• fish & starship powered terminal.
• sane dot files for xinitrc, picom, touchpad etc.
• custom keymaps to minimize finger strain.
• fn key support (on laptops) with notification on volume & brightness change.
• catppuccin themed terminal ~ st, fish, starship, neovim/neovide.

What is it ?

Hope is your gateway to a personalized arch Linux environment in minutes. It's more than just an installation script, it's an automation tool that brings your ideal arch setup to life, pre-configured with your preferred dotfiles and settings.

• Pre-Configured : No need to spend hours tweaking configs. Hope installs your pre-defined dotfiles & settings, giving you your familiar and productive environment from the start.
• Customizable : It's designed to be easily adapted to your specific needs. You can tailor the script to match your unique preferences.

Pre-requisite

• Confirm your cpu & gpu both are from team red.
• Read the fucking script before using it.
• Realize that the script will wipe your first nvme ssd.

Pre-installation

• Download the arch iso from this page and verify the signature of your download.
• Prepare the USB flash installation medium. (Do not use these methods.)
• Disable secure boot & boot the live environment in UEFI mode.
• Connect to the internet by plugging in an ethernet cable or using iwctl.

To check if you are connected to the internet. Run the command ping archlinux.org.

Installation

Use the below command from a live arch installation environment to install & setup arch.

pacman -Sy git;
git clone https://github.com/commitsovercoffee/hope.git;
bash ./hope/install.sh;

• Once the installation is complete, your system will automatically restart.
• After the reboot, enter the username "hope" and the password you created during setup to log in.

What Next ?

Explore Keymaps

Basic :

Alt is the mod key & there are 1-9 workspaces.

• Alt + d : brings up dmenu to search apps.
• Alt + Shift + q : Quits current app.

Switch workspace :

• Alt + 1 : switch to workspace 1.
• Alt + 2 : switch to workspace 2.

Open apps :

The apps spawn based on these rules which promotes efficient app switching by defining dedicated workspaces/tag for each application. This consistent layout helps build muscle memory, making you lightning-fast in navigating your tasks. Another reason why tiling window managers rock !

Terminal :

• Alt + Shift + Enter : Spawns terminal.
• Shift + PageUp : Scroll Up.
• Shift + PageDown : Scroll Down.
• Ctrl + Shift + PageDown : Decrease font of current terminal instance.
• Ctrl + Shift + PageUp : Increase font of current terminal instance.
• Ctrl + Shift + Enter (from terminal) : Spawns new terminal at pwd.

File Manager :

Follow below steps to do one-time setup of file-manager :

• Press Alt + Shift + K to open the file manager.
• Click "Edit" (on menu bar) then "Preferences" and choose "Advanced."
• Set Terminal Emulator to "st".
• Set Archiver integration to file-roller.
• Click "Close" to apply the changes.

• Alt + Shift + k : Spawns file-manager.
• F4 (from file-manager) : Spawns new terminal at current directory.

Other Apps :

• Alt + Shift + n : Spawns neovide.
• Alt + Shift + v : Spawns volume app.
• Alt + Shift + b : Spawns bluetooth app.
• Alt + Shift + p : Spawns screenshot app.

Select/resize apps :

• Alt + j/k : Cycle through apps in current workspace.
• Alt + h/l : Increase/decrease width of current app.

Change layout :

• Alt + Space toggles the layout between horizgrid & threecolumn
• Alt + Shift + Space toggles floating mode. You can hold Alt & drag/resize floating windows.

Change DNS Settings

For faster domain name resolution :

• Replace nameserver 192.168.1.1 with nameserver 8.8.8.8 in /etc/resolv.conf file.
  
• Prevent network manager from changing the file back using below command.

sudo chattr +i /etc/resolv.conf

Optimal camera quality

For optimal webcam quality, set config using `cameractrlsgtk4` to your liking. This is only a one-time setup which is saved.

Catpuccin Theme for cmus

Use this command from within cmus to add catppuccin theme

:colorscheme catpuccin.theme

Setup KVM for virtual machines

If you work with VMs, use below commands for a quick KVM setup.

fish shell does not support $, use bash for below commands

sudo pacman -S virt-manager qemu vde2 ebtables dnsmasq bridge-utils openbsd-netcat
sudo systemctl enable libvirtd.service
sudo systemctl start libvirtd.service
sudo sed -i 's/#unix_sock_group = "libvirt"/unix_sock_group = "libvirt"/' /etc/libvirt/libvirtd.conf
sudo sed -i 's/#unix_sock_ro_perms = "0777"/unix_sock_ro_perms = "0777"/' /etc/libvirt/libvirtd.conf
sudo usermod -a -G libvirt $(whoami)
newgrp libvirt
sudo systemctl restart libvirtd.service

Status

This project is my daily driver. I contribute to this project if and when I come across something useful or to add bugfixes.