{"id":30017196,"url":"https://github.com/xi-rick/archgaming","last_synced_at":"2025-08-05T22:45:43.213Z","repository":{"id":306863276,"uuid":"949704038","full_name":"xi-Rick/archgaming","owner":"xi-Rick","description":"🎮 Transform your Arch Linux system into the ultimate gaming powerhouse with intelligent hardware detection, performance optimization, and complete gaming stack installation. Supports 8+ Arch derivatives including CachyOS, EndeavourOS, and Manjaro.","archived":false,"fork":false,"pushed_at":"2025-07-28T04:07:26.000Z","size":20,"stargazers_count":5,"open_issues_count":1,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-28T05:29:53.607Z","etag":null,"topics":["arch-gaming","archlinux","automation-script","cachyos","endeavouros","gaming","gaming-setup","gaming-tools","linux-gaming","manjaro"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/xi-Rick.png","metadata":{"files":{"readme":"Readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-03-17T02:08:31.000Z","updated_at":"2025-07-28T04:07:30.000Z","dependencies_parsed_at":"2025-07-28T05:42:59.849Z","dependency_job_id":null,"html_url":"https://github.com/xi-Rick/archgaming","commit_stats":null,"previous_names":["xi-rick/archgaming"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/xi-Rick/archgaming","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xi-Rick%2Farchgaming","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xi-Rick%2Farchgaming/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xi-Rick%2Farchgaming/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xi-Rick%2Farchgaming/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/xi-Rick","download_url":"https://codeload.github.com/xi-Rick/archgaming/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xi-Rick%2Farchgaming/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":268987336,"owners_count":24340657,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-05T02:00:12.334Z","response_time":2576,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["arch-gaming","archlinux","automation-script","cachyos","endeavouros","gaming","gaming-setup","gaming-tools","linux-gaming","manjaro"],"created_at":"2025-08-05T22:45:38.772Z","updated_at":"2025-08-05T22:45:43.151Z","avatar_url":"https://github.com/xi-Rick.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🎮 Arch Gaming Setup Script\n\n\u003cdiv align=\"center\"\u003e\n\n![ArchGaming](https://img.shields.io/badge/archgaming-red?style=for-the-badge\u0026logo=archlinux\u0026logoColor=white)\n![Version](https://img.shields.io/badge/version-2.0-green?style=for-the-badge)\n![License](https://img.shields.io/badge/license-MIT-purple?style=for-the-badge)\n![Gaming](https://img.shields.io/badge/gaming-optimized-orange?style=for-the-badge\u0026logo=steam\u0026logoColor=white)\n\n**Transform Your Arch System into the Ultimate Gaming Powerhouse**\n\n_From fresh installation to gaming paradise in minutes – supporting all major Arch derivatives!_\n\n\u003c/div\u003e\n\n---\n\n## 🌟 What Makes ArchGaming Special?\n\nThis isn't just another gaming setup script – it's your **personal gaming optimization engineer** that transforms any Arch-based system into a high-performance gaming machine. Whether you're running vanilla Arch, CachyOS for maximum performance, or any derivative, this script delivers a perfectly tuned gaming environment.\n\n### ✨ Key Features\n\n- 🎯 **Universal Arch Support**: Optimized for 8+ Arch-based distributions\n- 🎨 **Intelligent Hardware Detection**: Auto-detects GPU and installs optimal drivers\n- 🚀 **Performance-First**: Gaming-focused kernel parameters and system optimizations\n- 🎮 **Complete Gaming Stack**: Steam, Lutris, emulators, and performance tools\n- 🔧 **Smart Configuration**: Pre-configures Wine, DXVK, and Proton for best compatibility\n- 🛡️ **Safe \u0026 Reliable**: Comprehensive error handling and rollback capabilities\n\n---\n\n## 🎯 Supported Distributions\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd align=\"center\"\u003e\n  \u003cimg src=\"https://archlinux.org/static/logos/archlinux-logo-dark-90dpi.ebdee92a15b3.png\" width=\"50\"\u003e\u003cbr\u003e\n  \u003cstrong\u003eArch Linux\u003c/strong\u003e\u003cbr\u003e\n  \u003cem\u003ePure Arch experience\u003c/em\u003e\n\u003c/td\u003e\n\u003ctd align=\"center\"\u003e\n  \u003cimg src=\"https://upload.wikimedia.org/wikipedia/commons/thumb/4/4b/EndeavourOS_Logo.svg/800px-EndeavourOS_Logo.svg.png\" width=\"50\"\u003e\u003cbr\u003e\n  \u003cstrong\u003eEndeavourOS\u003c/strong\u003e\u003cbr\u003e\n  \u003cem\u003eUser-friendly Arch\u003c/em\u003e\n\u003c/td\u003e\n\u003ctd align=\"center\"\u003e\n  \u003cimg src=\"https://upload.wikimedia.org/wikipedia/commons/thumb/3/3e/Manjaro-logo.svg/2048px-Manjaro-logo.svg.png\" width=\"50\"\u003e\u003cbr\u003e\n  \u003cstrong\u003eManjaro\u003c/strong\u003e\u003cbr\u003e\n  \u003cem\u003eStable release cycle\u003c/em\u003e\n\u003c/td\u003e\n\u003ctd align=\"center\"\u003e\n  \u003cimg src=\"https://upload.wikimedia.org/wikipedia/commons/thumb/b/b8/CachyOS_Logo.svg/2048px-CachyOS_Logo.svg.png\" width=\"50\"\u003e\u003cbr\u003e\n  \u003cstrong\u003eCachyOS\u003c/strong\u003e\u003cbr\u003e\n  \u003cem\u003eLightning fast\u003c/em\u003e\n\u003c/td\u003e\n\u003ctd align=\"center\"\u003e\n  \u003cimg src=\"https://artixlinux.org/img/artix-logo.png\" width=\"50\"\u003e\u003cbr\u003e\n  \u003cstrong\u003eArtix Linux\u003c/strong\u003e\u003cbr\u003e\n  \u003cem\u003eSystemD-free\u003c/em\u003e\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n---\n\n## 🚀 Quick Start\n\n### Installation\n\n```bash\n# Clone the repository\ngit clone https://github.com/xi-Rick/archgaming.git\ncd archgaming\n\n# Make it executable\nchmod +x gaming.sh\n\n# Run with elevated privileges\nsudo -E ./gaming.sh\n```\n\n---\n\n## 🎛️ Interactive Gaming Menu\n\nWhen you run the script, you'll see a beautiful, distribution-aware interface:\n\n```\n🎮 ArchGaming Setup v2.0\nDistribution: CachyOS\nGPU: NVIDIA GeForce RTX 4070\nKernel: linux-cachyos\n\n========== Gaming Installation Menu ==========\nSelect components to install (space-separated numbers):\n\n🎯 Core Gaming\n 1) Graphics Drivers (Auto-detected: NVIDIA)\n 2) Gaming Platforms (Steam, Lutris, Heroic)\n 3) Wine \u0026 Compatibility Layers\n\n🎮 Game Launchers \u0026 Stores\n 4) Steam + Proton GE + SteamTinkerLaunch\n 5) Lutris + Wine-GE + DXVK\n 6) Heroic Games Launcher (Epic/GOG)\n 7) Bottles (Wine prefix manager)\n\n🕹️ Emulation Station\n 8) RetroArch + Cores\n 9) Console Emulators (Dolphin, PCSX2, RPCS3)\n10) Handheld Emulators (Citra, Ryujinx)\n\n⚡ Performance \u0026 Monitoring\n11) GameMode + MangoHud\n12) Performance Tuning (CPU Governor, I/O Scheduler)\n13) GPU Control Tools (CoreCtrl/GreenWithEnvy)\n\n🔧 Advanced Gaming Tools\n14) Mod Management (Vortex via SteamTinkerLaunch)\n15) VR Gaming Support (SteamVR, OpenXR)\n16) Game Development Tools\n\n🌟 Quick Setups\n17) Essential Gaming (1,2,3,4,11)\n18) Complete Gaming Setup (All components)\n19) Competitive Gaming (Performance focused)\n20) Retro Gaming Paradise (Emulation focused)\n\nEnter your choices:\n```\n\n### Example Usage Scenarios\n\n**New Gamer Setup:**\n\n```bash\nEnter your choices: 17\n```\n\n_Installs essential drivers, platforms, compatibility layers, and performance tools_\n\n**Retro Gaming Enthusiast:**\n\n```bash\nEnter your choices: 20\n```\n\n_Complete emulation setup with RetroArch and all console emulators_\n\n**Competitive Gamer:**\n\n```bash\nEnter your choices: 19\n```\n\n_Performance-focused installation with latency reduction and monitoring tools_\n\n**Complete Gaming Rig:**\n\n```bash\nEnter your choices: 18\n```\n\n_Everything you need for any type of gaming on Linux_\n\n---\n\n## 🎮 What Gets Installed\n\n### 🎯 Graphics Drivers\n\n**Auto-Detection \u0026 Installation:**\n\n```bash\n# NVIDIA (Automatically detects card generation)\nnvidia nvidia-utils nvidia-settings\nnvidia-dkms  # For custom kernels\n\n# AMD\nmesa vulkan-radeon libva-mesa-driver\namdvlk  # Vulkan driver\n\n# Intel\nmesa vulkan-intel intel-media-driver\n```\n\n### 🎮 Gaming Platforms\n\n**Steam Ecosystem:**\n\n```bash\n# Steam with Proton support\nsteam steam-native-runtime\n# Proton GE Custom for better compatibility\nprotonup-qt  # GUI manager for Proton versions\n# SteamTinkerLaunch for advanced tweaking\nsteamtinkerlaunch\n```\n\n**Multi-Platform Gaming:**\n\n```bash\n# Lutris - Universal game manager\nlutris wine-staging wine-ge-custom\n# Heroic Games Launcher\nheroic-games-launcher-bin\n# Bottles - Wine prefix manager\nbottles\n```\n\n### 🕹️ Emulation Powerhouse\n\n**RetroArch Complete:**\n\n```bash\n# Core emulator with all systems\nretroarch retroarch-assets-xmb retroarch-assets-ozone\nlibretro-* # All available cores\n# Frontend alternatives\nemulationstation attract pegasus-frontend\n```\n\n**Console Emulators:**\n\n```bash\n# Modern consoles\ndolphin-emu      # GameCube/Wii\npcsx2            # PlayStation 2\nrpcs3-git        # PlayStation 3\nduckstation      # PlayStation 1\n\n# Nintendo handhelds\ncitra            # 3DS\nryujinx          # Switch alternative\n```\n\n### ⚡ Performance Arsenal\n\n**Gaming Optimization:**\n\n```bash\n# CPU optimization during gaming\ngamemode lib32-gamemode\n# Performance monitoring overlay\nmangohud lib32-mangohud goverlay\n# Vulkan improvements\ndxvk-bin vkd3d\n```\n\n**System Tuning:**\n\n```bash\n# CPU governor management\ncpupower auto-cpufreq\n# I/O scheduler optimization\nioscheduler-udev-rules\n# Memory optimization\npreload zram-generator\n```\n\n---\n\n## 🎨 Distribution-Specific Optimizations\n\n### CachyOS Features\n\n```bash\n# Performance-optimized packages\ncachyos-gaming-meta\ncachyos-kernel-manager\n# Optimized Wine builds\nwine-cachyos\n# Performance monitoring\ncachyos-hello\n```\n\n### Garuda Linux Features\n\n```bash\n# Gaming meta package\ngaruda-gaming\n# Garuda-specific tools\ngaruda-gamer garuda-assistant\n# Pre-configured gaming environment\ngaruda-gaming-applications\n```\n\n### Manjaro Features\n\n```bash\n# Manjaro gaming collection\nmanjaro-gaming-meta\n# Hardware detection\nmhwd mhwd-db\n# Manjaro settings manager\nmanjaro-settings-manager\n```\n\n---\n\n## ⚙️ Advanced Configuration\n\n### Automatic Wine Setup\n\nThe script creates optimized Wine prefixes:\n\n```bash\n# Gaming-optimized Wine prefix\nWINEPREFIX=$HOME/.wine-gaming\nwinetricks -q vcrun2019 dotnet48 corefonts\n# DirectX and Visual C++ runtimes\nwinetricks -q d3dx9 d3dx10 d3dx11 vcrun2015\n```\n\n### Kernel Parameter Optimization\n\n```bash\n# /etc/default/grub additions\nGRUB_CMDLINE_LINUX_DEFAULT=\"... mitigations=off processor.max_cstate=1 intel_idle.max_cstate=0\"\n# For AMD CPUs\nGRUB_CMDLINE_LINUX_DEFAULT=\"... amd_pstate=passive\"\n```\n\n### GPU-Specific Optimizations\n\n**NVIDIA:**\n\n```bash\n# Optimal driver settings\nnvidia-settings --assign CurrentMetaMode=\"nvidia-auto-select +0+0 { ForceFullCompositionPipeline = On }\"\n# Power management\nnvidia-settings --assign GPUPowerMizerMode=1\n```\n\n**AMD:**\n\n```bash\n# AMDGPU optimization\necho 'high' \u003e /sys/class/drm/card0/device/power_dpm_force_performance_level\n# Vulkan enhancements\nexport RADV_PERFTEST=aco,llvm\n```\n\n---\n\n## 🔧 Post-Installation Configuration\n\n### Steam Setup\n\n```bash\n# Enable Proton for all titles\nSteam \u003e Settings \u003e Steam Play \u003e Enable for all titles\n# Install Proton GE\nProtonUp-Qt: Download latest GE version\n# Configure SteamTinkerLaunch\nSteam \u003e Game Properties \u003e Launch Options:\nSTLCMD=\"%command%\" %command%\n```\n\n### Lutris Configuration\n\n```bash\n# Install Wine-GE\nLutris \u003e Preferences \u003e Runners \u003e Wine \u003e Download Wine-GE\n# DXVK setup\nLutris \u003e Preferences \u003e System Options \u003e Enable DXVK\n# MangoHud integration\nEnvironment variables: MANGOHUD=1\n```\n\n### Performance Monitoring Setup\n\n```bash\n# MangoHud configuration (~/.config/MangoHud/MangoHud.conf)\nfps\nframetime=1\ncpu_temp\ngpu_temp\nram\nvram\nposition=top-left\n```\n\n---\n\n## 📊 Gaming Performance Benchmarks\n\nAfter installation, the script provides performance validation:\n\n```\n🎮 Gaming Setup Complete!\n\nPerformance Status:\n  Graphics Driver: ✅ NVIDIA 545.29.06\n  Vulkan Support: ✅ Enabled\n  DXVK: ✅ Latest version installed\n  GameMode: ✅ Active\n  MangoHud: ✅ Configured\n\nGaming Platforms:\n  Steam: ✅ Ready with Proton GE\n  Lutris: ✅ Wine-GE configured\n  Heroic: ✅ Epic Games \u0026 GOG ready\n  RetroArch: ✅ All cores installed\n\nEmulation Status:\n  Dolphin (GameCube/Wii): ✅ Optimized\n  PCSX2 (PS2): ✅ Latest stable\n  RPCS3 (PS3): ✅ Development build\n\n🚀 Your Arch gaming rig is ready to dominate!\n\n🎯 Next Steps:\n  • Reboot to apply kernel parameters\n  • Launch Steam and enable Proton for all games\n  • Join ProtonDB to check game compatibility\n  • Configure MangoHud overlay settings\n\n📈 Expected Performance Improvements:\n  • 15-30% better frame rates with GameMode\n  • Reduced input latency with optimized kernel\n  • Better compatibility with Proton GE\n  • Professional monitoring with MangoHud\n```\n\n---\n\n## 🎯 Gaming Optimization Profiles\n\n### Competitive Gaming Profile\n\n```bash\n# Ultra-low latency configuration\necho 'performance' | sudo tee /sys/devices/system/cpu/cpu*/cpufreq/scaling_governor\n# Disable CPU mitigations\nGRUB_CMDLINE_LINUX_DEFAULT=\"... mitigations=off\"\n# High-precision mouse\necho 1000 \u003e /sys/module/usbhid/parameters/mousepoll\n```\n\n### High-End Gaming Profile\n\n```bash\n# Maximum performance\ncpupower frequency-set -g performance\n# GPU overclocking (NVIDIA)\nnvidia-settings --assign GPUGraphicsClockOffset[3]=100\n# Memory optimization\necho always \u003e /sys/kernel/mm/transparent_hugepage/enabled\n```\n\n### Battery-Conscious Gaming Profile\n\n```bash\n# Balanced performance for laptops\ncpupower frequency-set -g powersave\n# GPU power limit\nnvidia-smi -pl 150  # 150W limit for NVIDIA\n# Reduced refresh rate\nxrandr --output eDP-1 --rate 60\n```\n\n---\n\n## 🛡️ Troubleshooting \u0026 Support\n\n### Common Issues \u0026 Solutions\n\n**Steam games not launching:**\n\n```bash\n# Verify Proton installation\nls ~/.steam/compatibilitytools.d/\n# Reset Steam\nrm -rf ~/.steam/steam/appcache/\n```\n\n**Poor gaming performance:**\n\n```bash\n# Check GameMode status\ngamemoded -s\n# Verify GPU drivers\nglxinfo | grep \"OpenGL renderer\"\n# Check thermal throttling\nwatch sensors\n```\n\n**Wine games crashing:**\n\n```bash\n# Reinstall Wine dependencies\nwinetricks --force vcrun2019 dotnet48\n# Check Wine logs\ntail -f ~/.wine/drive_c/windows/temp/wine.log\n```\n\n---\n\n## 🤝 Contributing\n\nHelp make ArchGaming even better! Here's how:\n\n### Development Setup\n\n```bash\ngit clone https://github.com/xi-Rick/archgaming.git\ncd archgaming\n\n# Test in virtual machine\nqemu-system-x86_64 -enable-kvm -m 4G archlinux.qcow2\n# Or use containers\ndocker run -it archlinux:latest /bin/bash\n```\n\n### Testing Checklist\n\n- [ ] Test on vanilla Arch Linux\n- [ ] Test on major derivatives (CachyOS, EndeavourOS, Manjaro)\n- [ ] Verify NVIDIA driver installation\n- [ ] Verify AMD driver installation\n- [ ] Test Steam Proton functionality\n- [ ] Verify emulator installation\n- [ ] Check performance tools\n\n---\n\n## 📚 Resources \u0026 Community\n\n### Official Documentation\n\n- [Arch Wiki Gaming](https://wiki.archlinux.org/title/Gaming)\n- [ProtonDB](https://www.protondb.com/) - Game compatibility database\n- [Lutris](https://lutris.net/) - Game management platform\n\n### Gaming Communities\n\n- [r/linux_gaming](https://reddit.com/r/linux_gaming) - Reddit community\n- [Gaming on Linux](https://www.gamingonlinux.com/) - News and reviews\n- [Boiling Steam](https://boilingsteam.com/) - Linux gaming coverage\n\n### Distribution-Specific Resources\n\n- **CachyOS**: [Gaming Wiki](https://wiki.cachyos.org/gaming/)\n- **Garuda**: [Gaming Guide](https://wiki.garudalinux.org/gaming)\n- **Manjaro**: [Gaming Tutorial](https://wiki.manjaro.org/gaming)\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**🎮 Ready to Game on Arch? ⭐ Star this repo and let's play! ⭐**\n\n_Transform your Arch system into a gaming powerhouse today!_\n\nMade with 🎮 by gamers, for the Linux gaming community\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxi-rick%2Farchgaming","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxi-rick%2Farchgaming","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxi-rick%2Farchgaming/lists"}