c0d-0x's Arch Linux i3 Dotfiles

Welcome to my Arch Linux i3 configuration repository! This repo contains all the dotfiles I use to configure my lightweight and efficient Arch Linux environment with the i3 window manager.

Installation

# Clone the Repository
git clone https://github.com/c0d-0x/archlinux_i3_dotfiles.git
cd archlinux_i3_dotfiles

Install the Dotfiles on a fresh minimal arch-install

cp setup
./setup.sh #This setup should only be ran within the scripts dir
# This scripts run multiple scripts to setup your minamal install by
#installing i3 and  all of it's dependencies. 

Copy Dotfiles on a existing setup

Backup Your Existing Dotfiles

It's a good practice to back up your existing dotfiles before overwriting them:

mkdir ~/dotfiles_backup
mv ~/.config/i3 ~/.config/polybar ~/.config/rofi ~/dotfiles_backup/

cp -r dotfiles/i3 dotfiles/polybar dotfiles/rofi dotfiles/i3lock ~/.config/

Reload i3

After installation, reload i3 using:

$mod+Shift+R

#This will load the new configuration without needing to log out.

Features

• i3 Window Manager: A highly customizable, tiling window manager.
• Polybar: A sleek status bar with system information, workspaces, and more.
• Rofi: A powerful application launcher and window switcher.
• Picom: A lightweight compositor for transparency and window effects.
• Custom Keybindings: Optimized shortcuts for efficient workflows.
• Theming: A minimalist aesthetic with custom colors, fonts, and icons.
• Color: colors are base on wallpaper store in ~/pictures/wallpapers. These colors are generate using pywal.

Dependencies

Make sure to install the following packages on your Arch Linux system:

• i3: sudo pacman -S i3-wm
• thunar: sudo pacman -S thunar thunar-archive-plugin (a file manager)
• Polybar: sudo pacman -S polybar
• Rofi: sudo pacman -S rofi
• Picom: yay -S picom-git
• Feh: sudo pacman -S feh (for setting wallpapers)
• Dunst: sudo pacman -S dunst (for notifications)
• kitty: sudo pacman -S kitty (terminal emulator)
• yay: Install yay with the Commands below. Learn more...

sudo pacman -S --needed git base-devel
git clone https://aur.archlinux.org/yay.git
cd yay
makepkg -si

# Install brightnessct, python-pywal and python-pywalfox for Firefox pywal themes brightness controls
yay -S brightnessctl python-pywal python-pywalfox xdg-user-dirs xdg-utils xorg-xrdb
# IMPORTANT for i3 polywal colours: xorg-xrdb

Screenshots

Here are a few screenshots of my Arch Linux i3 setup:

Desktop with Polybar and Thunar: GTK theme: Abyss-DEEP and icons: BeautySolar

Firefox pywal-fox theme: You'll need to install the pywalfox plugin for firefox. here

Customization

Feel free to modify the following files to suit your preferences:

• i3 configuration: ~/.config/i3/config
• Polybar: ~/.config/polybar/config
• Rofi: ~/.config/rofi/config.rasi
• Picom: ~/.config/picom/picom.conf
• kitty: ~/.config/kitty/kitty.conf

Keybindings

Below is a list of keybindings used in this i3 configuration. The SUPER key is the Windows key.

Key Combination	Action
SUPER+Return	Launch kitty terminal.
SUPER+q	Kill the focused window.
SUPER+d	Launch rofi application launcher.
SUPER+k/h/j/l	Change focus (up/left/down/right).
SUPER+Up/Down/Left/Right	Change focus using arrow keys.
SUPER+Shift+k/h/j/l	Move focused window (up/left/down/right).
SUPER+Shift+Up/Down/Left/Right	Move focused window using arrow keys.
SUPER+b	Split in horizontal orientation.
SUPER+v	Split in vertical orientation.
SUPER+f	Toggle fullscreen mode.
SUPER+e	Toggle split layout.
SUPER+s	Change layout to tabbed.
SUPER+Shift+space	Toggle floating mode.
SUPER+space	Toggle focus between tiling/floating.
SUPER+a	Focus the parent container.
SUPER+1...0	Switch to workspace 1–10.
SUPER+Shift+1...0	Move container to workspace 1–10.
SUPER+Shift+c	Reload i3 configuration.
SUPER+Shift+r	Restart i3.
SUPER+Shift+e	Exit i3 (with confirmation prompt).

Resize Mode Keybindings

Key Combination	Action
SUPER+r	Enter resize mode.
h/j/k/l	Resize (shrink/grow width/height).
Left/Down/Up/Right	Resize using arrow keys.
Return/Escape/SUPER+r	Exit resize mode.

Multimedia and System Keybindings

Key Combination	Action
XF86AudioMute	Mute audio.
XF86AudioLowerVolume	Decrease audio volume by 5%.
XF86AudioRaiseVolume	Increase audio volume by 5%.
XF86AudioMicMute	Toggle microphone mute.
XF86MonBrightnessUp	Increase screen brightness by 5%.
XF86MonBrightnessDown	Decrease screen brightness by 5%.
Print	Take a screenshot of a selected area.

Custom Keybindings

Key Combination	Action
SUPER+t	Launch thunar file manager.
SUPER+x	Move window to the scratchpad.
SUPER+Shift+X	Show scratchpad window.
SUPER+Tab	Switch to the next workspace.
SUPER+Shift+Tab	Switch to the previous workspace.
SUPER+Shift+F	Launch firefox.
SUPER+p	Quit polybar.
SUPER+Ctrl+L	Lock the screen.
SUPER+w	Change wallpaper.
SUPER+Ctrl+P	Launch power menu.
SUPER+c	Open clipboard manager (rofi).

Contributing

If you have any suggestions or improvements, feel free to open an issue or submit a pull request. Contributions are always welcome!

License

This repository is licensed under the MIT License. See the LICENSE file for more details.