{"id":35050586,"url":"https://github.com/ind4skylivey/0ptiscaler4linux","last_synced_at":"2025-12-27T09:14:40.679Z","repository":{"id":320801952,"uuid":"1083387157","full_name":"ind4skylivey/0ptiscaler4linux","owner":"ind4skylivey","description":"The intelligent OptiScaler installer Linux gamers needed. Automates FSR4, XeSS \u0026 DLSS configuration with GPU-optimized profiles for RDNA3/4, Arc \u0026 RTX cards.","archived":false,"fork":false,"pushed_at":"2025-12-13T18:29:23.000Z","size":1421,"stargazers_count":9,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-12-14T13:10:34.350Z","etag":null,"topics":["amd-fsr","dlss","frame-generation","fsr4","gaming-performance","gpu-optimization","linux-gaming","linux-tools","mesa","optiscaler","proton","rdna3","rdna4","shell-scripting","steam-deck","upscaling","vulkan","xess"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ind4skylivey.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"docs/CONTRIBUTING.md","funding":null,"license":"LICENSE","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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-10-25T22:53:15.000Z","updated_at":"2025-12-14T00:22:40.000Z","dependencies_parsed_at":null,"dependency_job_id":"c29dcedc-c6b1-48b2-88d3-04ca25583fc5","html_url":"https://github.com/ind4skylivey/0ptiscaler4linux","commit_stats":null,"previous_names":["ind4skylivey/0ptiscaler4linux"],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/ind4skylivey/0ptiscaler4linux","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ind4skylivey%2F0ptiscaler4linux","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ind4skylivey%2F0ptiscaler4linux/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ind4skylivey%2F0ptiscaler4linux/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ind4skylivey%2F0ptiscaler4linux/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ind4skylivey","download_url":"https://codeload.github.com/ind4skylivey/0ptiscaler4linux/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ind4skylivey%2F0ptiscaler4linux/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28076745,"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-12-27T02:00:05.897Z","response_time":58,"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":["amd-fsr","dlss","frame-generation","fsr4","gaming-performance","gpu-optimization","linux-gaming","linux-tools","mesa","optiscaler","proton","rdna3","rdna4","shell-scripting","steam-deck","upscaling","vulkan","xess"],"created_at":"2025-12-27T09:14:39.920Z","updated_at":"2025-12-27T09:14:40.673Z","avatar_url":"https://github.com/ind4skylivey.png","language":"Shell","readme":"\u003cdiv align=\"center\"\u003e\n\u003cimg width=\"1024\" height=\"1024\" alt=\"banner\" src=\"https://github.com/user-attachments/assets/b039142c-6f2f-4c71-bb63-a2c115b59941\" /\u003e\n\n# OptiScaler for Linux: Boost FPS in Games with FSR4, XeSS \u0026 DLSS on Steam, Proton \u0026 Steam Deck\n\n### 💎 *Automated GPU Optimization for Linux Gaming* 💎\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/⚡_FPS_BOOST-50--80%25-ff6b6b?style=for-the-badge\u0026labelColor=1a1a1a\" alt=\"FPS Boost\"/\u003e\n  \u003cimg src=\"https://img.shields.io/badge/⚙️_LATENCY_DOWN-30--45%25-4ecdc4?style=for-the-badge\u0026labelColor=1a1a1a\" alt=\"Latency\"/\u003e\n  \u003cimg src=\"https://img.shields.io/badge/🎯_QUALITY-9/10-95e1d3?style=for-the-badge\u0026labelColor=1a1a1a\" alt=\"Quality\"/\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Steam_Deck-Optimized-00ccff?style=for-the-badge\u0026logo=steamdeck\u0026logoColor=white\" alt=\"Steam Deck\"/\u003e\n\u003c/p\u003e\n\n[![CI](https://img.shields.io/github/actions/workflow/status/ind4skylivey/0ptiscaler4linux/ci.yml?branch=main\u0026style=flat-square\u0026logo=github)](https://github.com/ind4skylivey/0ptiscaler4linux/actions)\n[![License](https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square)](LICENSE)\n[![Status](https://img.shields.io/badge/status-alpha-orange.svg?style=flat-square)](https://github.com/ind4skylivey/0ptiscaler4linux/releases)\n[![Platform](https://img.shields.io/badge/platform-Linux-FCC624.svg?style=flat-square\u0026logo=linux\u0026logoColor=black)](https://www.linux.org/)\n[![AUR](https://img.shields.io/badge/AUR-optiscaler--universal-1793d1.svg?style=flat-square\u0026logo=arch-linux)](https://aur.archlinux.org/packages/optiscaler-universal)\n\n---\n\n### 🚀 Automatically configure [OptiScaler](https://github.com/optiscaler/OptiScaler) for **FSR4** • **XeSS** • **DLSS**\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eIntelligent\u003c/strong\u003e • \u003cstrong\u003eAutomated\u003c/strong\u003e • \u003cstrong\u003eSafe\u003c/strong\u003e • \u003cstrong\u003eOpen Source\u003c/strong\u003e\n\u003c/p\u003e\n\n\u003c/div\u003e\n\n---\n\n\u003e **TL;DR:** OptiScaler for Linux automatically configures FSR4, XeSS, and DLSS upscaling for massive FPS gains in Linux games. One-command installation. Works with Steam, Proton, and Steam Deck. Supports AMD, Intel, and NVIDIA GPUs. 50-80% FPS boost in Cyberpunk 2077, Starfield, and more.\n\n---\n\n## 🎮 Boost FPS in Linux Games by 50-80% with Automated OptiScaler Setup\n\n**Are you experiencing low FPS, stuttering, or poor performance in your Linux games?**\n\nOptiScaler for Linux automatically configures [OptiScaler](https://github.com/optiscaler/OptiScaler) on your system to unlock massive performance gains using **FSR 3.1/4**, **XeSS**, and **DLSS** upscaling technologies.\n\nWhether you're gaming on **Steam with Proton**, running native Linux games, or playing on **Steam Deck**, this tool:\n- ✅ **Detects your GPU** (AMD, Intel, or NVIDIA) and its capabilities\n- ✅ **Scans your Steam library** and finds compatible games automatically\n- ✅ **Generates optimal configurations** for FSR4, XeSS, or DLSS based on your hardware\n- ✅ **Installs everything automatically** with full backup and rollback support\n\n**One command. Massive FPS boost. Perfect for Steam Deck users.**\n\n---\n\n## 👥 Who Should Use OptiScaler for Linux?\n\nThis automated installer is designed for:\n\n- 🐧 **Linux gamers** who want better FPS without upgrading hardware\n- 🎮 **Steam users** playing Windows games via Proton on Linux\n- 🎯 **Steam Deck owners** looking to maximize portable gaming performance  \n- 🔧 **GPU owners**: Works with AMD (RDNA1/2/3/4), Intel Arc, and NVIDIA RTX/GTX cards\n- 🚀 **Performance seekers** wanting FSR4, XeSS, or DLSS upscaling on Linux\n\n**No manual configuration required. No technical expertise needed.** Just run the installer and enjoy better FPS.\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n## 🎯 The Ultimate Linux Gaming Performance Booster\n\n| 🐧 **Linux Native** | 🎮 **Windows Games** | 🔥 **Steam Ready** | 💎 **Multi-GPU** |\n|:-------------------:|:--------------------:|:------------------:|:----------------:|\n| Full Linux support | via Proton/Wine | Deck compatible | AMD/Intel/NVIDIA |\n\n\u003c/div\u003e\n\n---\n\n## 🎬 How OptiScaler Boosts FPS in Linux Games with Steam \u0026 Proton\n\n\u003cdiv align=\"center\"\u003e\n\n### Three Simple Steps to Maximum Performance in Linux Gaming\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd align=\"center\" width=\"33%\"\u003e\n\n### 🔍 Step 1: Detect\n**Automatic GPU Recognition**\n\n\u003cp\u003e\n\u003cimg src=\"https://img.shields.io/badge/AMD-ED1C24?style=for-the-badge\u0026logo=amd\u0026logoColor=white\" alt=\"AMD\"/\u003e\u003cbr/\u003e\n\u003cimg src=\"https://img.shields.io/badge/Intel-0071C5?style=for-the-badge\u0026logo=intel\u0026logoColor=white\" alt=\"Intel\"/\u003e\u003cbr/\u003e\n\u003cimg src=\"https://img.shields.io/badge/NVIDIA-76B900?style=for-the-badge\u0026logo=nvidia\u0026logoColor=white\" alt=\"NVIDIA\"/\u003e\n\u003c/p\u003e\n\nAll vendors supported\u003cbr/\u003e\nDriver validation\u003cbr/\u003e\nCapability analysis\n\n\u003c/td\u003e\n\u003ctd align=\"center\" width=\"33%\"\u003e\n\n### ⚙️ Step 2: Configure\n**Smart Optimization**\n\n**OptiScaler** ✓\u003cbr/\u003e\nFSR3.1 / FSR4\u003cbr/\u003e\nXeSS / DLSS\u003cbr/\u003e\n\n**fakenvapi** *(AMD/Intel)*\u003cbr/\u003e\nAnti-Lag 2\u003cbr/\u003e\nReflex emulation\n\n\u003c/td\u003e\n\u003ctd align=\"center\" width=\"33%\"\u003e\n\n### 🚀 Step 3: Game\n**Instant Results**\n\n**+50-80%** FPS\u003cbr/\u003e\n**-30-45%** Latency\u003cbr/\u003e\n**9/10** Quality\u003cbr/\u003e\n\nAuto backups ✓\u003cbr/\u003e\nOne command ✓\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n---\n\n### 💡 What You Get Per GPU Vendor for Linux Gaming\n\n| GPU Vendor | OptiScaler | fakenvapi | Benefit |\n|:----------:|:----------:|:---------:|:--------|\n| ![AMD](https://img.shields.io/badge/AMD-ED1C24?style=flat-square\u0026logo=amd\u0026logoColor=white) | ✅ FSR3.1/4 | ✅ Anti-Lag 2 | Full optimization |\n| ![Intel](https://img.shields.io/badge/Intel-0071C5?style=flat-square\u0026logo=intel\u0026logoColor=white) | ✅ XeSS | ✅ Reflex-like | Complete support |\n| ![NVIDIA](https://img.shields.io/badge/NVIDIA-76B900?style=flat-square\u0026logo=nvidia\u0026logoColor=white) | ✅ DLSS boost | ➖ Native Reflex | Already optimized |\n\n\u003c/div\u003e\n\n---\n\n## ✨ Features: Intelligent GPU Detection \u0026 Automated Configuration for Linux Gaming\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd width=\"50%\"\u003e\n\n### 🎯 Intelligent Detection\n- 🔍 **Automatic GPU identification**\n  - AMD (RDNA1/2/3/4, GCN)\n  - Intel (Arc, Integrated)\n  - NVIDIA (RTX 20/30/40)\n- 🎮 **Steam library scanning**\n- 📊 **Driver version checking**\n- ⚙️ **Capability analysis**\n\n\u003c/td\u003e\n\u003ctd width=\"50%\"\u003e\n\n### 🚀 Smart Configuration\n- 📝 **Profile-based optimization**\n  - 6 GPU profiles\n  - 10+ game profiles\n- 🔧 **Automated file generation**\n  - OptiScaler.ini\n  - fakenvapi.ini (AMD/Intel)\n- 💾 **Automatic backups**\n- 🔄 **Easy rollback**\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n---\n\n## 🚀 Quick Start: Boost Your FPS on Linux in 30 Seconds\n\n### Option 1: One-Line Install (Fastest)\n\n```bash\ngit clone https://github.com/ind4skylivey/0ptiscaler4linux.git\ncd 0ptiscaler4linux\nbash scripts/install.sh\n```\n\n### Option 2: AUR Package (Arch/Manjaro Users)\n\n```bash\n# Using yay\nyay -S optiscaler-universal\n\n# Using paru\nparu -S optiscaler-universal\n\n# Manual install\ngit clone https://aur.archlinux.org/optiscaler-universal.git\ncd optiscaler-universal\nmakepkg -si\n```\n\nAfter installation, run:\n```bash\noptiscaler-install  # System-wide command\n```\n\n**Steam Deck users:** Follow our [Steam Deck Setup Guide](docs/steam-deck-setup-optiscaler-linux-gaming.md) for optimized installation.\n\n---\n\n## 🔍 Advanced Game Detection\n\nOptiScaler now includes an intelligent multi-disk Steam scanner:\n\n- ✅ Universal library discovery across all mounted disks (/mnt, /media, Steam Deck)\n- ✅ AppID-first matching (100% reliable when manifests exist)\n- ✅ 4-method fallback: manifest → folder fuzzy → executable probe → compatdata lookup\n- ✅ Proton prefix awareness and writable-path checks\n- ✅ Smart caching (5-minute TTL) with `--force-rescan` to bypass\n\nCLI flags you can use:\n\n```bash\n# Scan only (no install), cached\nbash scripts/install.sh --scan-only --verbose\n\n# Force fresh scan\nbash scripts/install.sh --scan-only --force-rescan\n\n# List supported games\nbash scripts/install.sh --list-games\n\n# Max detail for debugging\nLOG_LEVEL=DEBUG bash scripts/install.sh --scan-only --debug\n```\n\nSee the detailed flow in `docs/multi-disk-detection.md`.\n\n---\n\n## 💥 Linux Gaming Performance: Real FPS Gains\n\n\u003cdiv align=\"center\"\u003e\n\n| 🎮 Game | 🖥️ GPU | 📈 Before | 📈 After | 🚀 Gain |\n|---------|---------|-----------|----------|---------|\n| Cyberpunk 2077 | RX 7900 XTX | 85 FPS | 142 FPS | **+67%** |\n| Starfield | RX 6800 XT | 52 FPS | 89 FPS | **+71%** |\n| Hogwarts Legacy | Arc A770 | 45 FPS | 72 FPS | **+60%** |\n| Red Dead 2 | RX 7600 | 58 FPS | 95 FPS | **+64%** |\n\n*All tests performed on Linux with Steam + Proton*\n\n\u003c/div\u003e\n\nWant to optimize Cyberpunk 2077 on Linux? Check out our [Cyberpunk 2077 Linux FSR4 Guide](docs/cyberpunk-2077-linux-fsr4-optiscaler-guide.md).\n\n---\n\n## 🎮 Supported Games: Linux Gaming Performance Tested with Proton \u0026 Steam\n\n\u003cdiv align=\"center\"\u003e\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd align=\"center\" width=\"25%\"\u003e\n\u003cimg src=\"https://img.shields.io/badge/Cyberpunk_2077-✅-brightgreen?style=for-the-badge\u0026logo=data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMjQiIGhlaWdodD0iMjQiIHZpZXdCb3g9IjAgMCAyNCAyNCIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHBhdGggZD0iTTEyIDJMMiAyMkgyMkwxMiAyWiIgZmlsbD0iI0ZGRiIvPgo8L3N2Zz4=\" alt=\"Cyberpunk\"/\u003e\n\u003cbr\u003e\n\u003csub\u003e\u003cb\u003eFull RT Support\u003c/b\u003e\u003c/sub\u003e\n\u003c/td\u003e\n\u003ctd align=\"center\" width=\"25%\"\u003e\n\u003cimg src=\"https://img.shields.io/badge/Starfield-✅-brightgreen?style=for-the-badge\u0026logo=data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMjQiIGhlaWdodD0iMjQiIHZpZXdCb3g9IjAgMCAyNCAyNCIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHBhdGggZD0iTTEyIDJMMiAyMkgyMkwxMiAyWiIgZmlsbD0iI0ZGRiIvPgo8L3N2Zz4=\" alt=\"Starfield\"/\u003e\n\u003cbr\u003e\n\u003csub\u003e\u003cb\u003eCreation Engine 2\u003c/b\u003e\u003c/sub\u003e\n\u003c/td\u003e\n\u003ctd align=\"center\" width=\"25%\"\u003e\n\u003cimg src=\"https://img.shields.io/badge/Spider--Man-✅-brightgreen?style=for-the-badge\u0026logo=data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMjQiIGhlaWdodD0iMjQiIHZpZXdCb3g9IjAgMCAyNCAyNCIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHBhdGggZD0iTTEyIDJMMiAyMkgyMkwxMiAyWiIgZmlsbD0iI0ZGRiIvPgo8L3N2Zz4=\" alt=\"Spider-Man\"/\u003e\n\u003cbr\u003e\n\u003csub\u003e\u003cb\u003eExcellent RT\u003c/b\u003e\u003c/sub\u003e\n\u003c/td\u003e\n\u003ctd align=\"center\" width=\"25%\"\u003e\n\u003cimg src=\"https://img.shields.io/badge/Hogwarts_Legacy-✅-brightgreen?style=for-the-badge\u0026logo=data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMjQiIGhlaWdodD0iMjQiIHZpZXdCb3g9IjAgMCAyNCAyNCIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHBhdGggZD0iTTEyIDJMMiAyMkgyMkwxMiAyWiIgZmlsbD0iI0ZGRiIvPgo8L3N2Zz4=\" alt=\"Hogwarts\"/\u003e\n\u003cbr\u003e\n\u003csub\u003e\u003cb\u003eFull RT Support\u003c/b\u003e\u003c/sub\u003e\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd align=\"center\" width=\"25%\"\u003e\n\u003cimg src=\"https://img.shields.io/badge/Red_Dead_2-✅-brightgreen?style=for-the-badge\" alt=\"RDR2\"/\u003e\n\u003cbr\u003e\n\u003csub\u003e\u003cb\u003eVulkan Optimized\u003c/b\u003e\u003c/sub\u003e\n\u003c/td\u003e\n\u003ctd align=\"center\" width=\"25%\"\u003e\n\u003cimg src=\"https://img.shields.io/badge/God_of_War-✅-brightgreen?style=for-the-badge\" alt=\"GoW\"/\u003e\n\u003cbr\u003e\n\u003csub\u003e\u003cb\u003eDX12 Optimized\u003c/b\u003e\u003c/sub\u003e\n\u003c/td\u003e\n\u003ctd align=\"center\" width=\"25%\"\u003e\n\u003cimg src=\"https://img.shields.io/badge/Alan_Wake_2-✅-brightgreen?style=for-the-badge\" alt=\"AW2\"/\u003e\n\u003cbr\u003e\n\u003csub\u003e\u003cb\u003ePath Tracing\u003c/b\u003e\u003c/sub\u003e\n\u003c/td\u003e\n\u003ctd align=\"center\" width=\"50%\" colspan=\"2\"\u003e\n\u003cbr\u003e\n\u003cb\u003e+ Many More Compatible Linux Games!\u003c/b\u003e\n\u003cbr\u003e\u003cbr\u003e\n\u003ca href=\"docs/game-compatibility-list-optiscaler-linux.md\"\u003e📋 View Full Game Compatibility List →\u003c/a\u003e\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n\u003c/div\u003e\n\n---\n\n## 🖥️ Supported GPUs for Linux Gaming\n\n\u003cdiv align=\"center\"\u003e\n\n### 🎯 Comprehensive GPU Support for AMD, Intel \u0026 NVIDIA\n\n\u003c/div\u003e\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd width=\"33%\"\u003e\n\n### 🔴 AMD\n\n- ✅ **RDNA4** (RX 9000)\n  - FSR4 native\n  - +60-80% FPS\n- ✅ **RDNA3** (RX 7000)\n  - FSR3.1 optimized\n  - +50-70% FPS\n- ✅ **RDNA2** (RX 6000)\n  - Anti-Lag 2\n  - +55-75% FPS\n- ✅ **RDNA1** (RX 5000)\n  - +40-60% FPS\n\n\u003c/td\u003e\n\u003ctd width=\"33%\"\u003e\n\n### 🔵 Intel\n\n- ✅ **Arc A-series**\n  - XeSS native\n  - +40-60% FPS\n  - DX12/Vulkan\n- ⚠️ **Integrated**\n  - FSR3.1 fallback\n  - +30-50% FPS\n\n\u003cbr\u003e\u003cbr\u003e\n\n\u003c/td\u003e\n\u003ctd width=\"33%\"\u003e\n\n### 🟢 NVIDIA\n\n- ✅ **RTX 40/30/20**\n  - Native DLSS\n  - Native Reflex\n  - OptiScaler optional\n- ⚠️ **GTX 16/10**\n  - FSR3.1 support\n  - +35-55% FPS\n\n\u003cbr\u003e\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n\u003cdiv align=\"center\"\u003e\n\nFor detailed profiles and recommendations, see our **[GPU Profiles Guide for Linux Gaming](docs/gpu-profiles-explained-optiscaler-linux.md)**.\n\n\u003c/div\u003e\n\n---\n\n## 📚 Documentation\n\n**Getting Started:**\n- [How to Boost FPS in Linux Games with OptiScaler](docs/linux-fps-boost-with-optiscaler.md)\n- [Steam Deck Setup Guide: Maximize FPS with OptiScaler](docs/steam-deck-setup-optiscaler-linux-gaming.md)\n- [Proton Setup for Linux Gaming with OptiScaler](docs/proton-setup-for-linux-gaming-with-optiscaler.md)\n\n**Technical Guides:**\n- [GPU Profiles Explained for AMD, Intel \u0026 NVIDIA](docs/gpu-profiles-explained-optiscaler-linux.md)\n- [FSR4, XeSS \u0026 DLSS on Linux: Complete Guide](docs/fsr4-xess-dlss-on-linux-with-optiscaler.md)\n- [Troubleshooting: FPS Drops, Crashes \u0026 Performance Issues](docs/troubleshooting-optiscaler-linux-fps-drops-crashes.md)\n\n**Game-Specific:**\n- [Cyberpunk 2077 on Linux: FSR4 Setup Guide](docs/cyberpunk-2077-linux-fsr4-optiscaler-guide.md)\n- [Starfield Linux Gaming: Proton + OptiScaler Setup](docs/starfield-linux-proton-optiscaler-guide.md)\n- [Game Compatibility List](docs/game-compatibility-list-optiscaler-linux.md)\n\n**Project Info:**\n- [Project Design](PROJECT_DESIGN.md)\n- [Contributing Guide](docs/CONTRIBUTING.md)\n\n---\n\n## 🛠️ Advanced Features\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003e🔍 GPU Detection \u0026 Driver Validation\u003c/b\u003e\u003c/summary\u003e\n\n- Automatic vendor identification (AMD/Intel/NVIDIA)\n- Architecture detection (RDNA, Arc, Ampere, etc.)\n- Driver version checking (Mesa/NVIDIA)\n- Capability analysis (FSR4, XeSS, DLSS support)\n- Profile selection based on hardware\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003e🎮 Steam Library Scanner\u003c/b\u003e\u003c/summary\u003e\n\n- Steam library auto-detection\n- Multiple library support\n- Proton compatibility checking\n- Game-specific profile matching\n- Installation verification\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003e⚙️ Configuration Generator\u003c/b\u003e\u003c/summary\u003e\n\n- Optimal settings per GPU\n- Game-specific tuning\n- FSR/XeSS/DLSS configuration\n- Anti-Lag/Reflex setup\n- Quality vs Performance presets\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003e💾 Safety Features\u003c/b\u003e\u003c/summary\u003e\n\n- Automatic file backups\n- One-command rollback\n- Non-destructive installation\n- Dry-run mode available\n- Comprehensive logging\n\n\u003c/details\u003e\n\n---\n\n## 🔧 Advanced Usage\n\n### Manual Game Addition\n\n```bash\nbash scripts/install.sh --game-dir \"/path/to/game\" --game-profile \"generic\"\n```\n\n### Custom GPU Profile\n\n```bash\nbash scripts/install.sh --gpu-profile \"custom.yaml\"\n```\n\n### Benchmark Mode\n\n```bash\nbash scripts/benchmark.sh --game \"Cyberpunk 2077\" --runs 5\n```\n\n### Diagnostics\n\n```bash\nbash scripts/diagnose.sh --game \"New World\" --verbose\n```\n\n---\n\n## 🤝 Contributing\n\nWe welcome contributions from the Linux gaming community! Whether it's:\n\n- 🐛 Bug reports\n- ✨ Feature requests for Linux gaming optimization\n- 📝 Documentation improvements\n- 🎮 New game profiles for Steam/Proton games\n- 🖥️ GPU profile optimizations for AMD/Intel/NVIDIA\n- 🧪 Testing and feedback on Steam Deck\n\nPlease see [Contributing Guide](docs/CONTRIBUTING.md) for guidelines.\n\n---\n\n## 📊 Project Status\n\n### Current Version: 0.1.0-alpha\n\n**Phase 1: Alpha Release** ✅ Complete!\n\n- [x]  Project structure\n- [x]  Design documentation\n- [x]  GPU detection (AMD/Intel/NVIDIA)\n- [x]  Steam game scanner\n- [x]  10 game profiles\n- [x]  Configuration generator\n- [x]  Automated installer\n- [x]  Core documentation\n\n[View full roadmap →](PROJECT_DESIGN.md#-future-roadmap)\n\n---\n\n## 🌐 Linux Gaming Community\n\n- **GitHub Issues**: [Bug reports and feature requests](https://github.com/ind4skylivey/0ptiscaler4linux/issues)\n- **Discord**: Coming soon\n- **Reddit**: [r/linux_gaming](https://reddit.com/r/linux_gaming) discussions\n- **ProtonDB**: Game compatibility reports\n\n---\n\n## ⭐ Found This Useful?\n\nIf OptiScaler for Linux helped boost your FPS, please:\n\n- **⭐ Star this repository** to help other Linux gamers and Steam Deck users find it\n- **🐛 Report issues** if you encounter problems: [Open an issue](https://github.com/ind4skylivey/0ptiscaler4linux/issues/new)\n- **💬 Share your FPS gains** on r/linux_gaming or ProtonDB\n- **🤝 Contribute** game profiles, GPU optimizations, or Steam Deck tweaks\n\n**Your feedback makes Linux gaming better for everyone.**\n\n---\n\n## 📜 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n### Third-Party Software\n\n- [OptiScaler](https://github.com/optiscaler/OptiScaler) - GPL-3.0 License\n- [fakenvapi](https://github.com/FakeMichau/fakenvapi) - MIT License\n- AMD FidelityFX SDK - MIT License\n\n---\n\n## 🙏 Acknowledgments\n\n- **OptiScaler Team** - For creating the amazing OptiScaler mod\n- **fakenvapi** - For enabling Anti-Lag 2 on AMD GPUs for Linux\n- **Linux Gaming Community** - For continuous support and testing\n- **AMD, Intel, NVIDIA** - For their upscaling technologies (FSR4, XeSS, DLSS)\n- **Valve** - For Proton and Steam Deck, advancing Linux gaming\n\n---\n\n## ⚠️ Disclaimer\n\nThis is an unofficial tool not affiliated with or endorsed by AMD, Intel, NVIDIA, Valve, or any game developers. Use at your own risk. Always backup your game files before modification.\n\nThis tool is designed specifically for Linux gaming with Steam, Proton, and Steam Deck.\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n## 🚀 Ready to Boost Your Linux Gaming FPS?\n\n### Get Started in 30 Seconds\n\n```bash\ngit clone https://github.com/ind4skylivey/0ptiscaler4linux.git\ncd 0ptiscaler4linux\nbash scripts/install.sh\n```\n\n### 🎯 Quick Links\n\n[![Get Started](https://img.shields.io/badge/Get_Started-Installation-blue?style=for-the-badge)](docs/linux-fps-boost-with-optiscaler.md)\n[![Documentation](https://img.shields.io/badge/Read-Documentation-green?style=for-the-badge)](PROJECT_DESIGN.md)\n[![Report Bug](https://img.shields.io/badge/Report-Bug-red?style=for-the-badge)](https://github.com/ind4skylivey/0ptiscaler4linux/issues/new?template=bug_report.md)\n[![Contribute](https://img.shields.io/badge/Contribute-Welcome-yellow?style=for-the-badge)](docs/CONTRIBUTING.md)\n\n### 💬 Join the Linux Gaming Community\n\n[![GitHub Issues](https://img.shields.io/github/issues/ind4skylivey/0ptiscaler4linux?style=social)](https://github.com/ind4skylivey/0ptiscaler4linux/issues)\n[![GitHub Stars](https://img.shields.io/github/stars/ind4skylivey/0ptiscaler4linux?style=social)](https://github.com/ind4skylivey/0ptiscaler4linux/stargazers)\n[![GitHub Forks](https://img.shields.io/github/forks/ind4skylivey/0ptiscaler4linux?style=social)](https://github.com/ind4skylivey/0ptiscaler4linux/network/members)\n\n**r/linux_gaming** • **ProtonDB** • **Gaming on Linux** • **Steam Deck HQ**\n\n---\n\n### 🎮 Unlock Massive FPS Gains on Linux\n\n\u003cp align=\"center\"\u003e\n\u003cstrong\u003eAutomated • Intelligent • Safe • Perfect for Steam Deck\u003c/strong\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\nBuilt with ❤️ by \u003ca href=\"https://github.com/ind4skylivey\"\u003e\u003cstrong\u003eS1BGr0up\u003c/strong\u003e\u003c/a\u003e for the Linux gaming community\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n\u003csub\u003e\nPowered by \u003ca href=\"https://github.com/optiscaler/OptiScaler\"\u003eOptiScaler\u003c/a\u003e • \n\u003ca href=\"https://github.com/FakeMichau/fakenvapi\"\u003efakenvapi\u003c/a\u003e • \nThe Linux Gaming Community\n\u003c/sub\u003e\n\u003c/p\u003e\n\n\u003c/div\u003e\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Find4skylivey%2F0ptiscaler4linux","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Find4skylivey%2F0ptiscaler4linux","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Find4skylivey%2F0ptiscaler4linux/lists"}