Skip to content

An automated bash script to set up and configure Arch Linux with the i3 window manager.

Notifications You must be signed in to change notification settings

dark-f1are/arch-i3-setup

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Arch Linux i3 Window Manager Setup Script

Overview

A streamlined setup script for Arch Linux that installs and configures i3 window manager along with essential tools for a productive development environment.

Features

  • i3 window manager configuration
  • Terminal setup (Alacritty)
  • File management (Thunar)
  • System monitoring tools
  • Modern CLI tools (exa, bat)
  • Bluetooth support
  • Display manager (ly)

Package Groups

The script installs these main package groups:

Core & System

  • htop, exa, bat, alacritty
  • i3-wm, i3blocks, i3status-rust
  • brightnessctl, fastfetch
  • Bluetooth utilities
  • Network management

File Management

  • Thunar with plugins
  • Archive support (zip, unzip, unrar)
  • Device mounting support (gvfs)

UI & Theming

  • Rofi (application launcher)
  • Dunst (notifications)
  • Flameshot (screenshots)
  • Custom fonts and icons
  • Theme packages

Prerequisites

  • Fresh Arch Linux installation (Xorg Installaion)
  • Internet connection
  • Non-root user with sudo privileges
  • Git (to clone this repository)

Installation

  1. Clone this repository:

    git clone https://github.com/yourusername/arch-i3-setup.git
    cd arch-i3-setup
  2. Run the setup script:

    ./setup.sh
  3. During installation, you'll be prompted to:

    • Configure Git (optional)
    • Select a web browser
    • Enter sudo password when required

What the Script Does

  1. Performs system checks
  2. Sets up Git configuration (optional)
  3. Installs yay AUR helper
  4. Lets you choose and install a web browser
  5. Installs all required packages
  6. Sets up system services (bluetooth, display manager)
  7. Creates basic directory structure
  8. Copies configuration files
  9. Configures input devices

Post-Installation

After installation completes:

  1. Reboot your system
  2. Log in through ly display manager
  3. i3 will start automatically
  4. Use $mod+Return for terminal
  5. Use $mod+d for application launcher

Troubleshooting

  • Check the log file created at ~/setup_[timestamp].log
  • Ensure all required files are present before running
  • Verify internet connection
  • Make sure script is run from correct directory

Contributing

Feel free to submit issues and pull requests for:

  • Bug fixes
  • New features
  • Documentation improvements
  • Configuration enhancements

About

An automated bash script to set up and configure Arch Linux with the i3 window manager.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages