ArchStarterPack

A curated collection of configuration files, setup guides, and optimization scripts for Arch Linux-based systems. This repository provides battle-tested configurations for CachyOS, hardware peripherals, and development environments.

Overview

ArchStarterPack is a collection of production-ready configuration files and comprehensive guides designed to streamline the setup process for Arch-based Linux distributions. Whether you're configuring a new system, optimizing performance, or setting up development tools, this repository provides tested solutions.

Key Features:

🚀 Performance optimization for CachyOS/Arch systems
🖱️ Advanced mouse configuration for Logitech devices
🔧 Minimal, clean development environment setup
🖨️ Brother printer and scanner setup guides
📚 Shell commands mastery with 80+ practice exercises
📖 Detailed documentation with safety checks
🛡️ Tested configurations for ASUS VivoBook hardware

Prerequisites

Operating System: Arch Linux or Arch-based distribution (CachyOS, Manjaro, EndeavourOS, etc.)
Hardware: Configurations optimized for ASUS X507UF, but adaptable to other systems
Package Manager: pacman (standard Arch package manager)
Shell: Fish shell (for Node.js configuration) or Bash
Permissions: Root/sudo access for system configuration

Configuration Modules

1. CachyOS Configuration

Location: cachy_os_config/ Difficulty: Intermediate to Advanced Time Required: 30-60 minutes

Comprehensive guides for configuring and optimizing CachyOS on ASUS X507UF (Intel i5-8250U + Intel UHD 620 + NVIDIA MX130) hardware. These configurations provide maximum performance when plugged in and power efficiency on battery.

What's Included

Performance & Power Optimization - Complete guide for AC/battery power management
- TLP configuration for automatic AC/battery switching
- CPU governor optimization (performance/powersave)
- Intel Turbo Boost management
- NVIDIA power management
- Thermal management with thermald
- Battery care settings (charge thresholds)
External Monitor-Only Setup - Configure laptop to use external display exclusively
- NVIDIA Optimus configuration
- Disable internal eDP display
- Early KMS (Kernel Mode Setting)
- GRUB kernel parameters
- HDMI-first boot configuration
Hardware Diagnostics Toolkit - Comprehensive system diagnostics scripts
- diagnostics.sh - Full system diagnostics with command visibility
- drm-power-diagnostics.sh - Specialized DRM/power/USB diagnostics
- Shows commands before executing (transparent and educational)
- GPU/CPU/PCI/ACPI information gathering
- Thermal sensor readings
- Kernel module status
- Boot error detection
- Safe, read-only diagnostics
Optional Diagnostics Extensions - Advanced diagnostic modules
- Auto-upload to pastebin
- Vulkan/OpenGL info collection
- Network diagnostics suite
- SMART disk health reports
- Wayland/X11 logs
GRUB Configuration - Production GRUB config with optimized kernel parameters

Key Features

✅ Maximum performance on AC power ✅ Power efficiency on battery ✅ Safe thermal management ✅ NVIDIA Optimus support ✅ Intel P-state optimization ✅ Automatic power profile switching ✅ Battery longevity features

Quick Start

cd cachy_os_config/
# Read the main guide first
cat asus_x_507_uf_readme.md

# Follow the numbered steps carefully
# Always run safety checks before applying configurations

2. LogiOps - Logitech Mouse Configuration

Location: logiops/ Difficulty: Intermediate Time Required: 20-30 minutes

Configuration and setup guide for Logitech MX Master 3S mouse using LogiOps on Linux. Provides gesture controls, button remapping, and scroll wheel optimization.

What's Included

LogiOps Setup Guide - Complete installation and configuration instructions
- Building from source
- Dependency installation for various distros
- Safety checks and validation
- Common issues and troubleshooting
- Tips for advanced configurations
MX Master 3S Configuration - Production-ready logid.cfg
- SmartShift configuration (ratchet/free-spin toggle)
- Hi-res scroll wheel settings
- Gesture button mappings
- Workspace switching gestures
- KDE Plasma integration
- Thumb wheel configuration

Features

🖱️ Button Mappings:

Scroll wheel middle-click
Back/Forward buttons
SmartShift toggle button
Gesture button with swipe controls

🎯 Gestures:

Click: Overview (Meta+W)
Swipe Left/Right: Workspace switching
Swipe Up: Task switcher (Meta+Tab)
Swipe Down: Show desktop (Meta+D)

⚙️ Advanced Settings:

DPI: 2000
SmartShift threshold: 30
Scroll multiplier: 2.0x
Custom wheel resolution

Quick Start

cd logiops/

# Install dependencies (Arch Linux)
sudo pacman -S base-devel cmake libevdev libconfig systemd-libs glib2

# Clone and build LogiOps
git clone https://github.com/PixlOne/logiops.git
cd logiops
mkdir build && cd build
cmake -DCMAKE_BUILD_TYPE=Release ..
make
sudo make install

# Copy configuration
sudo cp ../logid.cfg /etc/logid.cfg

# Validate and start
sudo logid -t  # test configuration
sudo systemctl enable --now logid

3. Node.js Development Setup

Location: node_started/ Difficulty: Beginner to Intermediate Time Required: 10-15 minutes

Minimal, clean configuration for NVM (Node Version Manager) in Fish shell. No bloated plugins, no unnecessary dependencies—just what you need to get Node.js working reliably.

What's Included

Node.js Setup (main README) - Explains the Fish/NVM issue and what config.fish + nvm.fish + nvm-load.fish are doing
NVM Fish Setup Guide - Detailed copy/paste setup instructions
- Installation requirements
- Fish shell integration
- VSCode compatibility
- Troubleshooting guide
- Rollback instructions
Minimal config.fish - Bare minimum Fish configuration
- NVM environment setup
- No fisher or bass required
- Clean, maintainable approach
NVM Fish Functions - nvm wrapper (runs nvm via bash)
NVM Fish Loader - nvm-load env sync (loads default Node into Fish PATH)

Philosophy

This configuration follows a minimal, package-manager-friendly approach:

No third-party Fish plugin managers
No bass (bash wrapper) dependency
Direct integration with pacman-installed NVM
Clean separation of concerns
Easy to understand and maintain

Quick Start

cd node_started/

# Install NVM via pacman
sudo pacman -S nvm

# Create Fish config directories
mkdir -p ~/.config/fish/functions

# Copy configurations
cp config.fish ~/.config/fish/config.fish
cp nvm.fish ~/.config/fish/functions/nvm.fish
cp nvm-load.fish ~/.config/fish/functions/nvm-load.fish

# Reload shell
exec fish

# Set default Node version (one-time)
bash -ic 'source /usr/share/nvm/init-nvm.sh && nvm install --lts && nvm alias default lts/*'

# Test
node -v
nvm --version

Note (Fish shell / nvm use): nvm use <version> runs in a bash subprocess and won’t automatically update the current Fish session’s PATH. Use nvm-load after switching (or open a new shell). See node_started/nvm-fish-readme.md.

4. Brother Printer Setup

Location: brother_dcp-t820dw/ Difficulty: Beginner to Intermediate Time Required: 15-25 minutes

Complete setup guide for Brother DCP-T820DW printer and scanner on Arch Linux. Includes network (WiFi), USB configuration, and scanning setup.

What's Included

Brother Printer Setup Guide - Complete installation and configuration
- CUPS and Avahi setup
- AUR driver installation
- USB and WiFi network printing
- Scanner setup with SANE
- Troubleshooting common issues
- Driver integrity verification

Features

🖨️ Printing:

WiFi network printing via IPP
USB direct printing
CUPS web interface configuration
IPP Everywhere support

🔍 Scanning:

SANE integration
Network scanner support
Simple Scan GUI
brscan5 driver configuration

📸 Photo Management:

digiKam recommended for photo organization
Advanced image editing and cataloging
RAW format support
Face detection and tagging

Quick Start

cd brother_dcp-t820dw/

# Install CUPS and dependencies
sudo pacman -S cups cups-pdf avahi nss-mdns system-config-printer

# Enable services
sudo systemctl enable --now cups
sudo systemctl enable --now avahi-daemon

# Install Brother driver (AUR)
paru -S brother-dcpt820dw

# For scanning
sudo pacman -S sane-airscan simple-scan
paru -S brscan5 brscan-skey

# Register scanner
brsaneconfig5 -a name="BrotherDCP" model=DCPT820DW ip=<PRINTER-IP>

# Test printer
lpstat -p
lp /usr/share/cups/data/testprint

# For photo management and organization
sudo pacman -S digikam

5. Shell Commands Mastery Guide

Location: shell-commands/ Difficulty: Beginner to Expert Time Required: 4-6 weeks (self-paced)

Complete guide to Unix/Linux shell commands for Salesforce development and system automation. Master essential commands, powerful combinations, and real-world patterns through 383 interactive exercises with automatic validation and progress tracking.

What's Included

Shell Commands Guide - Complete mastery course
- Shell operators and redirection fundamentals
- 40+ essential command tutorials (grep, sed, awk, jq, curl, etc.)
- Piping patterns and command chaining
- Linux system administration patterns
- Salesforce CLI integration patterns
- Apex log analysis techniques
- Deployment automation scripts
Interactive Practice System ⭐ NEW!
- 383 exercises across 35 command practice files
- Automatic validation - Type commands yourself and get immediate feedback
- Progress tracking - JSON-based progress saved per user
- Practice menu system - Interactive menu organized by category
- 6 validation modes - Exact, numeric, contains, regex, lines, sorted
- 3 attempts per question - Hints after wrong attempts, solutions after failures
- Scoring system - Track mastery and improvement over time

Course Structure

📚 Part 1: Fundamentals

Shell operators (|, >, >>, &&, ||)
Input/output redirection

📝 Part 2: Essential Commands (40+ commands)

Text processing: grep, sed, awk, cut, sort, uniq, tr, wc
File operations: find, cat, diff, tail/head, tee
System & process: ps, top, df/du
Archives: tar, zip, gzip
Network: curl, wget, ping, netstat
Advanced: jq, xargs, column, paste, comm

🔗 Part 3: Command Combinations

Piping patterns for data processing
Command chaining strategies
Linux system patterns
Advanced workflows

💪 Part 4: Practice (80 exercises)

Beginner: 20 exercises
Intermediate: 20 exercises
Advanced: 20 exercises
Expert: 20 exercises

⚡ Part 5: Salesforce-Specific

SF CLI integration patterns
Apex log analysis
Deployment scripts

Quick Start

cd shell-commands/

# Option 1: Interactive Practice (Recommended)
cd practice-environment/practice
./practice-menu.sh
# Or practice a specific command:
./commands/grep-practice.sh

# Option 2: Follow the structured learning path
cat README.md

# Start with basics
cat 01-basics/operators.md

# Practice with grep (most common command)
cat 02-commands/grep.md

# Try beginner exercises (reading)
cat 04-practice/beginner.md

# 4-Week Learning Path:
# Week 1: Basics + interactive practice (grep, cut, sort)
# Week 2: Core commands (sed, awk, jq) + practice validation
# Week 3: Combinations + advanced practice + track progress
# Week 4: Expert practice + Salesforce patterns + master all 35 commands

Learning Path

For Complete Beginners:

Read operators and redirection basics
Master grep, cat, tail/head
Practice interactively: cd practice-environment/practice && ./commands/grep-practice.sh
Complete beginner exercises (1-20) from reading exercises
Progress to intermediate commands

For Intermediate Users:

Focus on sed, awk, jq for data processing
Practice interactively: ./commands/sed-practice.sh, ./commands/awk-practice.sh, ./commands/jq-practice.sh
Learn piping and chaining patterns
Complete intermediate and advanced exercises
Track progress: ./progress.sh show
Explore Salesforce-specific patterns

For Advanced Users:

Master complex piping patterns
Complete expert exercises
Master all 35 practice command files - Aim for 90%+ on each
Build custom automation scripts
View mastery: ./progress.sh mastered
Contribute your own patterns

Key Highlights

✅ 383 Interactive Exercises - Active learning with automatic validation ✅ 35 Practice Command Files - One for each documented command ✅ Progress Tracking - Track mastery per command with JSON storage ✅ 80+ Reading Exercises - Hands-on learning with solutions ✅ Salesforce Integration - Real-world SF CLI patterns ✅ Generic Linux Examples - System administration, web servers, Docker ✅ Progressive Learning - Beginner to expert path ✅ Real-World Patterns - Production-ready recipes ✅ Self-Paced - Learn at your own speed

Who This Is For

Salesforce developers learning Linux/Unix commands
System administrators wanting structured practice
DevOps engineers needing quick reference
Anyone automating workflows with shell scripts
Students preparing for Linux certification

6. Linux Package Management

Location: linux-packages/ Difficulty: Beginner to Intermediate Time Required: 10-30 minutes

Complete guide for installing and managing applications on Arch-based systems. Learn how to choose between AppImage, Flatpak, and .deb formats, integrate applications into your desktop, troubleshoot Flatpak sandboxing issues, and manage package-related problems.

What's Included

Package Management Guide - Comprehensive AppImage and package installation guide
Flatpak Sandboxing Issues - Troubleshooting browser settings and data persistence problems
- Choosing between AppImage and .deb formats
- Installing FUSE dependency
- Running and integrating AppImages
- Creating desktop entries for KDE Application Launcher
- Icon extraction and theming
- Update management strategies
- Security best practices
- Flatpak vs AppImage comparison

Features

📦 Package Format Guidance:

When to choose AppImage over .deb
Understanding distro-agnostic formats
Arch-specific considerations

🔧 Integration:

Manual desktop entry creation
Icon extraction from AppImages
KDE Plasma integration
AppImageLauncher automation

🔄 Update Management:

Manual update process
AppImageUpdate tool usage
Version management best practices
Backup strategies

🛡️ Security:

Signature verification
Checksum validation
Trusted source guidelines
Sandboxing considerations

📊 Comparison:

Flatpak vs AppImage detailed comparison
When to use each format
Hybrid approach recommendations

Quick Start

cd linux-packages/

# Install FUSE dependency
sudo pacman -S fuse2

# Make AppImage executable
chmod +x MyApp-x86_64.AppImage

# Move to stable location
mkdir -p ~/.local/bin
mv MyApp-x86_64.AppImage ~/.local/bin/myapp
chmod +x ~/.local/bin/myapp

# Create desktop entry
mkdir -p ~/.local/share/applications
nano ~/.local/share/applications/myapp.desktop

# Refresh KDE cache
kbuildsycoca6

Use Cases

Running applications that only provide .deb or AppImage formats
Portable applications that don't need system installation
Testing applications without modifying system packages
Applications not available in Arch repositories or AUR
Understanding modern Linux application distribution formats

7. System Optimization & Maintenance

Location: system-optimization/ Difficulty: Beginner to Intermediate Time Required: 15-60 minutes

Complete guide for optimizing, cleaning, and maintaining CachyOS/Arch-based systems. Remove redundant packages, optimize memory usage, improve system speed, clean caches, and automate maintenance tasks.

What's Included

System Optimization Guide - Main guide with decision tree and quick reference
Package Cleanup Guide - Remove orphaned and unused packages
Cache Cleanup Guide - Clean pacman, paru, and flatpak caches
Memory Optimization Guide - Optimize memory usage and swap configuration
Speed Optimization Guide - Improve boot time and system performance
Maintenance Scripts Guide - Automate maintenance tasks

Features

🧹 Package Cleanup:

Find and remove orphaned packages
Clean unused dependencies
Remove AUR packages safely
Flatpak runtime cleanup

💾 Cache Management:

Pacman cache cleanup (keeps last 2 versions)
Paru cache cleanup
Flatpak cache and unused runtimes
Systemd journal log rotation
Temporary files cleanup

🧠 Memory Optimization:

Monitor memory usage
Configure swap and swappiness
ZRAM setup for faster virtual memory
Memory leak detection

⚡ Speed Optimization:

Boot time analysis and optimization
Database optimization (pacman, locate)
Filesystem optimization (TRIM, mount options)
I/O scheduler tuning
Network optimization

🤖 Automation:

Automated maintenance scripts
Systemd timer scheduling
Cron job examples
Health check scripts

Quick Start

cd system-optimization/

# Check system health
./scripts/check-optimization.sh

# Clean orphaned packages (interactive)
sudo ./scripts/cleanup-packages.sh

# Clean caches
sudo ./scripts/cleanup-cache.sh

# Full system maintenance
sudo ./scripts/system-maintenance.sh

Use Cases

Free up disk space by removing unused packages and caches
Optimize system performance and boot time
Improve memory usage and configure swap
Automate regular maintenance tasks
Monitor system health and optimization status
Troubleshoot performance issues

8. Pi-hole Network DNS

Location: pi-hole/ Difficulty: Beginner to Intermediate Time Required: 45-70 minutes (router UI dependent)

Run Pi-hole on a Raspberry Pi with authoritative DNS for your LAN. Includes quick start, router DHCP guidance, and advanced add-ons for privacy and reliability.

What's Included

Pi-hole Guide — Central quick start, router DHCP settings, troubleshooting
Advanced docs (under pi-hole/docs/):
- unbound.md — Local recursive DNS with Unbound
- ipv6.md — IPv6-safe deployment
- hardcoded-dns.md — Blocking hardcoded DNS/DoH clients

Highlights

✅ Single DNS path (no secondary DNS) ✅ Router DoH/DoT disablement guidance ✅ DHCP reservation and verification checklist ✅ Optional: Unbound recursion, IPv6, DNS firewalling

Quick Start

# On the Pi
sudo apt update
sudo apt install -y openssh-server
# Install Pi-hole via official installer, then set router DHCP DNS to Pi-hole only

Check pi-hole/README.md for router paths (TP-Link, ASUS, Netgear, OpenWRT) and verification steps.

9. Networking Fundamentals

Location: networking/ Difficulty: Beginner → Intermediate Time Required: 60-120 minutes (self-paced)

Systematic learning path for home networking: IP addressing, subnet masks/prefixes, gateways, DHCP, DNS, and router UI models. Designed to make modules like Pi-hole feel intuitive instead of “patchwork settings.”

What's Included

Networking Start Here — guided reading order
Core docs: networking/docs/ (IP addressing, DHCP, DNS, router model, troubleshooting)
Practice drills: networking/practice/drills.md

Quick Start

cd networking/
cat README.md

10. Android Debloating & Privacy

Location: android/ Difficulty: Beginner → Intermediate Time Required: 30-60 minutes (self-paced)

Practical workflow for reducing Android telemetry and bloat safely. Learn how to trace "mystery domains" (often discovered via Pi-hole) back to the responsible app/package, then debloat in a reversible way.

What's Included

Android Module (Start Here) — reading order, glossary, links to Pi-hole/DNS concepts
Android Debloating Guide — ADB setup, safety model, investigation workflow, known telemetry domains, Pi-hole regex deny examples

11. Virtualization with KVM/QEMU/libvirt

Location: vm/ Difficulty: Beginner → Advanced Time Required: 60-120 minutes (self-paced)

Complete learning path for KVM/QEMU/libvirt virtualization on Arch Linux. Create, configure, and manage virtual machines for learning, testing, and production use.

What's Included

VM Module (Start Here) — entry point with reading path and quick start
Structured docs: vm/docs/ (virtualization basics, installation, networking, performance, video/display, storage, advanced topics, troubleshooting)
Practice drills: vm/practice/ (setup verification, networking, performance, virsh commands)

Key Features

✅ Hardware virtualization support verification ✅ Complete installation and setup guide ✅ VM networking (NAT, bridges, firewall configuration) ✅ Performance tuning (CPU, memory, graphics, guest agent) ✅ Video/display configuration (Virtio vs QXL, 3D acceleration) ✅ Storage management (qcow2, snapshots, backups) ✅ Advanced topics (GPU passthrough, bridged networking, automation) ✅ Comprehensive troubleshooting guide

Quick Start

cd vm/

# Verify hardware support
lscpu | grep -i virtualization

# Install packages
sudo pacman -S qemu-full virt-manager virt-viewer dnsmasq bridge-utils libvirt edk2-ovmf

# Enable libvirt
sudo systemctl enable --now libvirtd

# Add user to libvirt group
sudo usermod -aG libvirt $(whoami)
# Log out and log back in

# Launch virt-manager
virt-manager

Project Structure

graph TD
    Root([ArchStarterPack]) --> Module1[cachy_os_config/<br/>System Optimization]
    Root --> Module2[logiops/<br/>Mouse Configuration]
    Root --> Module3[node_started/<br/>Node.js Setup]
    Root --> Module4[brother_dcp-t820dw/<br/>Printer Setup]
    Root --> Module5[shell-commands/<br/>Shell Commands Guide]
    Root --> Module6[linux-packages/<br/>Package Management]
    Root --> Module7[system-optimization/<br/>System Optimization]
    Root --> Module8[pi-hole/<br/>Network DNS]
    Root --> Module9[networking/<br/>Networking Fundamentals]
    Root --> Module10[android/<br/>Android Debloating]
    Root --> Docs[docs/<br/>Documentation]

    Module5 --> PracticeEnv[practice-environment/<br/>Interactive Practice]
    PracticeEnv --> Practice[practice/<br/>383 exercises]
    PracticeEnv --> Demos[demos/<br/>11 demos]
    PracticeEnv --> Data[data/<br/>50+ files]

    Module1 --> Config1[TLP Config]
    Module1 --> Config2[GRUB Config]
    Module1 --> Diag[Diagnostics]

    style Root fill:#4caf50,color:#fff
    style Module1 fill:#2196f3,color:#fff
    style Module2 fill:#ff9800,color:#fff
    style Module3 fill:#9c27b0,color:#fff
    style Module4 fill:#f44336,color:#fff
    style Module5 fill:#00bcd4,color:#fff
    style Module6 fill:#795548,color:#fff
    style Module7 fill:#e91e63,color:#fff
    style Module8 fill:#607d8b,color:#fff
    style Module9 fill:#3f51b5,color:#fff
    style Module10 fill:#009688,color:#fff
    style Module11 fill:#795548,color:#fff
    style PracticeEnv fill:#607d8b,color:#fff

Detailed Structure:

ArchStarterPack/
├── .github/
│   ├── ISSUE_TEMPLATE.md               # Bug report template
│   └── PULL_REQUEST_TEMPLATE.md        # PR template
├── linux-packages/
│   ├── README.md                       # Package management and AppImage guide
│   └── FLATPAK_SANDBOXING.md           # Flatpak sandboxing troubleshooting
├── system-optimization/
│   ├── README.md                       # System optimization main guide
│   ├── PACKAGE_CLEANUP.md              # Package cleanup guide
│   ├── CACHE_CLEANUP.md                # Cache cleanup guide
│   ├── MEMORY_OPTIMIZATION.md          # Memory optimization guide
│   ├── SPEED_OPTIMIZATION.md           # Speed optimization guide
│   ├── MAINTENANCE_SCRIPTS.md          # Maintenance scripts guide
│   └── scripts/
│       ├── check-optimization.sh       # System health check script
│       ├── cleanup-packages.sh         # Package cleanup script
│       ├── cleanup-cache.sh            # Cache cleanup script
│       └── system-maintenance.sh       # Full maintenance script
├── brother_dcp-t820dw/
│   └── BROTHER_PRINTER_SETUP_README.md # Brother printer & scanner guide
├── cachy_os_config/
│   ├── asus_x_507_uf_readme.md         # Main performance & power guide
│   ├── asus_x_507_uf_nvidia_deprecated.md  # External monitor setup
│   ├── diagnostics.sh                   # System diagnostics tool
│   ├── drm-power-diagnostics.sh         # DRM/power/USB diagnostics tool
│   ├── 01-custom.conf                   # TLP custom configuration example
│   ├── extract.md                      # Diagnostics toolkit documentation
│   ├── DRM_POWER_DIAGNOSTICS.md        # DRM/power diagnostics guide
│   ├── optional_extract.md             # Advanced diagnostics
│   ├── GRUB_PARAMETERS.md              # Detailed kernel parameter explanations
│   └── grub                            # GRUB configuration file
├── docs/
│   ├── FAQ.md                          # Frequently asked questions
│   ├── TROUBLESHOOTING.md              # Common issues and solutions
│   ├── GLOSSARY.md                     # Technical terms glossary
│   └── LEARNING_RESOURCES.md           # Curated educational materials
├── logiops/
│   ├── readme.md                       # LogiOps setup guide
│   └── logid.cfg                       # MX Master 3S configuration
├── node_started/
│   ├── nvm-fish-readme.md              # NVM Fish setup guide
│   ├── config.fish                     # Minimal Fish config
│   └── nvm.fish                        # NVM Fish functions
├── shell-commands/
│   ├── 01-basics/
│   │   ├── operators.md                # Shell operators and symbols
│   │   └── redirection.md              # Input/output redirection
│   ├── 02-commands/
│   │   ├── grep.md, sed.md, awk.md     # Text processing commands
│   │   ├── find.md, cat.md, tail-head.md # File operations
│   │   ├── curl.md, wget.md, jq.md     # Network and data tools
│   │   └── [35+ more command guides]   # Comprehensive command reference
│   ├── 03-combinations/
│   │   ├── piping.md                   # Piping patterns
│   │   ├── chaining.md                 # Command chaining
│   │   ├── linux-system-patterns.md    # System admin patterns
│   │   └── advanced-patterns.md        # Complex workflows
│   ├── 04-practice/
│   │   ├── beginner.md                 # 20 beginner exercises
│   │   ├── intermediate.md             # 20 intermediate exercises
│   │   ├── advanced.md                 # 20 advanced exercises
│   │   └── expert.md                   # 20 expert exercises
│   ├── 05-salesforce/
│   │   ├── sf-cli-patterns.md          # SF CLI integration
│   │   ├── log-analysis.md             # Apex log analysis
│   │   └── deployment-scripts.md       # Deployment automation
│   ├── practice-environment/
│   │   ├── practice/                   # ⭐ Interactive Practice System
│   │   │   ├── commands/              # 35 practice files (383 exercises)
│   │   │   │   ├── grep-practice.sh
│   │   │   │   ├── awk-practice.sh
│   │   │   │   └── [33 more...]
│   │   │   ├── practice-engine.sh     # Validation engine
│   │   │   ├── practice-menu.sh       # Interactive menu
│   │   │   ├── progress.sh            # Progress tracking
│   │   │   └── README.md              # Practice guide
│   │   ├── data/                       # Sample data files (logs, JSON, CSV)
│   │   ├── demos/                      # Passive learning demos
│   │   ├── exercises/                  # Guided tutorials
│   │   └── README.md                   # Practice environment guide
│   └── README.md                       # Shell commands guide
├── check-prerequisites.sh               # System compatibility checker
├── CHANGELOG.md                         # Version history and changes
├── CONTRIBUTING.md                      # Contribution guidelines
├── LICENSE                              # MIT License
└── README.md                           # This file

Quick Start

flowchart LR
    A[Clone Repository] --> B[Check Prerequisites]
    B --> C{System<br/>Compatible?}
    C -->|No| D[Fix Issues]
    D --> B
    C -->|Yes| E[Choose Module]
    E --> F[Read Documentation]
    F --> G[Follow Safety Guidelines]
    G --> H[Apply Configuration]
    H --> I[Test & Verify]

    style A fill:#e1f5ff
    style B fill:#fff3e0
    style C fill:#f3e5f5
    style E fill:#e8f5e9
    style H fill:#c8e6c9
    style I fill:#4caf50,color:#fff

Before you begin, verify your system compatibility:

git clone https://github.com/cjmaaz/ArchStarterPack.git
cd ArchStarterPack
chmod +x check-prerequisites.sh
./check-prerequisites.sh

This will check if your system meets all requirements for the configuration modules.

Clone the repository:

git clone https://github.com/cjmaaz/ArchStarterPack.git
cd ArchStarterPack

Check prerequisites:
```
./check-prerequisites.sh
```
Choose your configuration module:

flowchart TD
    Start([What do you need?]) --> Need1{System<br/>Optimization?}
    Need1 -->|Yes| CachyOS[cachy_os_config/<br/>Performance & Power]

    Start --> Need2{Mouse<br/>Configuration?}
    Need2 -->|Yes| LogiOps[logiops/<br/>Logitech Mouse]

    Start --> Need3{Node.js<br/>Setup?}
    Need3 -->|Yes| NodeJS[node_started/<br/>NVM Fish Setup]

    Start --> Need4{Printer<br/>Setup?}
    Need4 -->|Yes| Printer[brother_dcp-t820dw/<br/>Brother Printer]

    Start --> Need5{Learn Shell<br/>Commands?}
    Need5 -->|Yes| Shell[shell-commands/<br/>383 Exercises]

    Start --> Need6{Package<br/>Management?}
    Need6 -->|Yes| Packages[linux-packages/<br/>Package Management]

    Start --> Need7{System<br/>Optimization?}
    Need7 -->|Yes| Optimization[system-optimization/<br/>Optimization & Maintenance]

    Start --> Need8{Network-wide<br/>DNS/Ad-blocking?}
    Need8 -->|Yes| PiHole[pi-hole/<br/>Network DNS]

    Start --> Need9{Learn<br/>Networking?}
    Need9 -->|Yes| Networking[networking/<br/>Networking Fundamentals]

    Start --> Need10{Virtualization<br/>VMs?}
    Need10 -->|Yes| VM[vm/<br/>KVM/QEMU/libvirt]

    CachyOS --> End([Start Configuration])
    LogiOps --> End
    NodeJS --> End
    Printer --> End
    Shell --> End
    Packages --> End
    Optimization --> End
    PiHole --> End
    Networking --> End
    VM --> End

    style Start fill:#e1f5ff
    style End fill:#c8e6c9
    style CachyOS fill:#2196f3,color:#fff
    style LogiOps fill:#ff9800,color:#fff
    style NodeJS fill:#9c27b0,color:#fff
    style Printer fill:#f44336,color:#fff
    style Shell fill:#00bcd4,color:#fff
    style Packages fill:#795548,color:#fff
    style Optimization fill:#e91e63,color:#fff
    style PiHole fill:#607d8b,color:#fff
    style Networking fill:#3f51b5,color:#fff
    style VM fill:#795548,color:#fff

Module Selection:

For system optimization: cd cachy_os_config/
For mouse configuration: cd logiops/
For Node.js setup: cd node_started/
For Brother printer setup: cd brother_dcp-t820dw/
For shell commands learning: cd shell-commands/
- For package management: cd linux-packages/
For system optimization: cd system-optimization/
For network-wide DNS blocking: cd pi-hole/
For virtualization/VMs: cd vm/

Read the documentation: Each module contains detailed README files with step-by-step instructions.
Follow safety guidelines:
- Always read the full guide before executing commands
- Run safety checks where indicated
- Back up existing configurations
- Test in a safe environment first

Quick Diagnostics: If you encounter issues, run the diagnostics tools (show commands and output):

cd cachy_os_config/

# Full system diagnostics
./diagnostics.sh                  # Normal mode
./diagnostics.sh --redact         # Redact personal info (IPs, MACs, hostnames, etc.)

# DRM/display, power management, USB issues (creates directory with multiple files)
./drm-power-diagnostics.sh                  # Normal mode
./drm-power-diagnostics.sh --redact         # Redact personal info

Troubleshooting & FAQ

For comprehensive troubleshooting guides, common issues, and frequently asked questions, see:

Troubleshooting Guide - Solutions to common problems
FAQ - Frequently asked questions
Glossary - Technical terms explained
Learning Resources - Curated educational materials

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contributing

Contributions are welcome! If you have improvements, additional configurations, or bug fixes:

Fork the repository
Create a feature branch (git checkout -b feature/improvement)
Commit your changes (git commit -am 'Add new configuration')
Commit your changes with descriptive messages
Push to the branch (git push origin feature/improvement)
Open a Pull Request

Guidelines:

Document all configurations thoroughly
Include safety checks and warnings
Test on actual hardware before submitting
Follow existing documentation style
Explain the "why" behind configuration choices

See CONTRIBUTING.md for detailed contribution guidelines.

Repository: https://github.com/cjmaaz/ArchStarterPack

Note: These configurations are tested on specific hardware (ASUS X507UF) and software (CachyOS). While they should work on similar systems, always review and adapt configurations to your specific hardware and requirements.

Disclaimer: Use these configurations at your own risk. Always back up your system before making significant changes. The maintainers are not responsible for any system issues that may arise from using these configurations.

Name		Name	Last commit message	Last commit date
.github		.github
android		android
brother_dcp-t820dw		brother_dcp-t820dw
cachy_os_config		cachy_os_config
docs		docs
keyboards		keyboards
linux-packages		linux-packages
logiops		logiops
networking		networking
node_started		node_started
pi-hole		pi-hole
shell-commands		shell-commands
system-optimization		system-optimization
vm		vm
.gitignore		.gitignore
CHANGELOG.md		CHANGELOG.md
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
README.md		README.md
check-prerequisites.sh		check-prerequisites.sh

Latest commit

History

Folders and files

Repository files navigation

ArchStarterPack

Table of Contents

Overview

Prerequisites

Configuration Modules

1. CachyOS Configuration

What's Included

Key Features

Quick Start

2. LogiOps - Logitech Mouse Configuration

What's Included

Features

Quick Start

3. Node.js Development Setup

What's Included

Philosophy

Quick Start

4. Brother Printer Setup

What's Included

Features

Quick Start

5. Shell Commands Mastery Guide

What's Included

Course Structure

Quick Start

Learning Path

Key Highlights

Who This Is For

6. Linux Package Management

What's Included

Features

Quick Start

Use Cases

7. System Optimization & Maintenance

What's Included

Features

Quick Start

Use Cases

8. Pi-hole Network DNS

What's Included

Highlights

Quick Start

9. Networking Fundamentals

What's Included

Quick Start

10. Android Debloating & Privacy

What's Included

11. Virtualization with KVM/QEMU/libvirt

What's Included

Key Features

Quick Start

Project Structure

Quick Start

Troubleshooting & FAQ

License

Contributing

About

Topics

Resources

Contributing

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages