Skip to content

README.md

Latest commit

 

History

History
163 lines (118 loc) · 5.21 KB

README.md

File metadata and controls

163 lines (118 loc) · 5.21 KB

Arch Linux Logo Arch Linux — Complete Documentation

A comprehensive, step-by-step guide to everything Arch Linux — from installation to mastery.

Arch Linux Bash Window Managers Status

📁 Project Structure

Arch_Linux/
│
├── README.md                          ← You are here
│
├── docs/
│   ├── commands-cheatsheet.md         ← Essential Arch Linux commands
│   ├── desktop-environments.md        ← DE/WM options and comparisons
│   ├── downloads.md                   ← Where to download Arch Linux (official links)
│   ├── install-mac-asahi.md           ← Install on Apple Silicon via Asahi Linux
│   ├── install-virtual-wsl.md         ← VirtualBox / WSL2 setup guide
│   └── install-windows-pc.md          ← Dual boot with Windows (step-by-step)
│
└── configs/
    ├── i3/
    │   └── config                     ← i3 window manager configuration
    │
    └── hyprland/
        ├── hyprland.conf              ← Hyprland compositor configuration
        ├── kitty.conf                 ← Kitty terminal emulator config
        └── waybar/
            └── config.jsonc           ← Waybar panel layout & modules

📚 Documentation

📄 Guides & Docs

File Description
commands-cheatsheet.md pacman, systemctl, ip, grep, and more
desktop-environments.md GNOME, KDE, i3, Hyprland — comparisons & tips
downloads.md Official mirrors and verified ISO sources
install-windows-pc.md Dual boot Arch Linux alongside Windows
install-virtual-wsl.md Run Arch in VirtualBox or WSL2
install-mac-asahi.md Arch Linux on Apple Silicon (Asahi)

⚙️ Dotfiles / Configs

🪟 i3 Window Manager

File Description
configs/i3/config Keybindings, layouts, autostart, and theming

🌊 Hyprland (Wayland Compositor)

File Description
hyprland.conf Monitor setup, animations, keybindings, rules
kitty.conf Font, colors, padding, and shell settings
waybar/config.jsonc Waybar modules: workspaces, clock, tray, etc.

🚀 Getting Started

1. Download Arch Linux

Head to the downloads guide for official ISO links and verification steps.

2. Choose Your Installation Method

Method Guide
🪟 Dual Boot with Windows install-windows-pc.md
💻 VirtualBox / WSL2 install-virtual-wsl.md
🍎 Apple Silicon (Asahi) install-mac-asahi.md

3. Choose a Desktop Environment

See desktop-environments.md for a breakdown of popular options including i3, Hyprland, GNOME, and KDE Plasma.

4. Apply the Dotfiles

Clone this repo and symlink or copy configs to your home directory:

# Clone the repository
git clone https://github.com/Linux-Operating-System/Arch_Linux.git
cd Arch_Linux

# Copy i3 config
mkdir -p ~/.config/i3
cp configs/i3/config ~/.config/i3/config

# Copy Hyprland configs
mkdir -p ~/.config/hypr ~/.config/kitty ~/.config/waybar
cp configs/hyprland/hyprland.conf ~/.config/hypr/hyprland.conf
cp configs/hyprland/kitty.conf ~/.config/kitty/kitty.conf
cp configs/hyprland/waybar/config.jsonc ~/.config/waybar/config

🛠️ Quick Command Reference

# Update the system
sudo pacman -Syu

# Install a package
sudo pacman -S <package>

# Search for a package
pacman -Ss <keyword>

# Remove a package
sudo pacman -Rns <package>

# Enable a service
sudo systemctl enable --now <service>

# Check system logs
journalctl -xe

📖 Full cheatsheet → commands-cheatsheet.md

🤝 Contributing

  1. Fork this repository
  2. Create a new branch: git checkout -b feature/your-topic
  3. Commit your changes: git commit -m "Add: your description"
  4. Push and open a Pull Request

📜 License

This project is open source and available under the MIT License.

Made with ❤️ for the Arch Linux community  |  btw, I use Arch