https://github.com/ind4skylivey/0ptiscaler4linux
The intelligent OptiScaler installer Linux gamers needed. Automates FSR4, XeSS & DLSS configuration with GPU-optimized profiles for RDNA3/4, Arc & RTX cards.
https://github.com/ind4skylivey/0ptiscaler4linux
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
Last synced: 17 days ago
JSON representation
The intelligent OptiScaler installer Linux gamers needed. Automates FSR4, XeSS & DLSS configuration with GPU-optimized profiles for RDNA3/4, Arc & RTX cards.
- Host: GitHub
- URL: https://github.com/ind4skylivey/0ptiscaler4linux
- Owner: ind4skylivey
- License: mit
- Created: 2025-10-25T22:53:15.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2025-12-13T18:29:23.000Z (about 1 month ago)
- Last Synced: 2025-12-14T13:10:34.350Z (about 1 month ago)
- 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
- Language: Shell
- Homepage:
- Size: 1.36 MB
- Stars: 9
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: docs/CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# OptiScaler for Linux: Boost FPS in Games with FSR4, XeSS & DLSS on Steam, Proton & Steam Deck
### 💎 *Automated GPU Optimization for Linux Gaming* 💎
[](https://github.com/ind4skylivey/0ptiscaler4linux/actions)
[](LICENSE)
[](https://github.com/ind4skylivey/0ptiscaler4linux/releases)
[](https://www.linux.org/)
[](https://aur.archlinux.org/packages/optiscaler-universal)
---
### 🚀 Automatically configure [OptiScaler](https://github.com/optiscaler/OptiScaler) for **FSR4** • **XeSS** • **DLSS**
Intelligent • Automated • Safe • Open Source
---
> **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.
---
## 🎮 Boost FPS in Linux Games by 50-80% with Automated OptiScaler Setup
**Are you experiencing low FPS, stuttering, or poor performance in your Linux games?**
OptiScaler 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.
Whether you're gaming on **Steam with Proton**, running native Linux games, or playing on **Steam Deck**, this tool:
- ✅ **Detects your GPU** (AMD, Intel, or NVIDIA) and its capabilities
- ✅ **Scans your Steam library** and finds compatible games automatically
- ✅ **Generates optimal configurations** for FSR4, XeSS, or DLSS based on your hardware
- ✅ **Installs everything automatically** with full backup and rollback support
**One command. Massive FPS boost. Perfect for Steam Deck users.**
---
## 👥 Who Should Use OptiScaler for Linux?
This automated installer is designed for:
- 🐧 **Linux gamers** who want better FPS without upgrading hardware
- 🎮 **Steam users** playing Windows games via Proton on Linux
- 🎯 **Steam Deck owners** looking to maximize portable gaming performance
- 🔧 **GPU owners**: Works with AMD (RDNA1/2/3/4), Intel Arc, and NVIDIA RTX/GTX cards
- 🚀 **Performance seekers** wanting FSR4, XeSS, or DLSS upscaling on Linux
**No manual configuration required. No technical expertise needed.** Just run the installer and enjoy better FPS.
---
## 🎯 The Ultimate Linux Gaming Performance Booster
| 🐧 **Linux Native** | 🎮 **Windows Games** | 🔥 **Steam Ready** | 💎 **Multi-GPU** |
|:-------------------:|:--------------------:|:------------------:|:----------------:|
| Full Linux support | via Proton/Wine | Deck compatible | AMD/Intel/NVIDIA |
---
## 🎬 How OptiScaler Boosts FPS in Linux Games with Steam & Proton
### Three Simple Steps to Maximum Performance in Linux Gaming
### 🔍 Step 1: Detect
**Automatic GPU Recognition**
All vendors supported
Driver validation
Capability analysis
### ⚙️ Step 2: Configure
**Smart Optimization**
**OptiScaler** ✓
FSR3.1 / FSR4
XeSS / DLSS
**fakenvapi** *(AMD/Intel)*
Anti-Lag 2
Reflex emulation
### 🚀 Step 3: Game
**Instant Results**
**+50-80%** FPS
**-30-45%** Latency
**9/10** Quality
Auto backups ✓
One command ✓
---
### 💡 What You Get Per GPU Vendor for Linux Gaming
| GPU Vendor | OptiScaler | fakenvapi | Benefit |
|:----------:|:----------:|:---------:|:--------|
|  | ✅ FSR3.1/4 | ✅ Anti-Lag 2 | Full optimization |
|  | ✅ XeSS | ✅ Reflex-like | Complete support |
|  | ✅ DLSS boost | ➖ Native Reflex | Already optimized |
---
## ✨ Features: Intelligent GPU Detection & Automated Configuration for Linux Gaming
### 🎯 Intelligent Detection
- 🔍 **Automatic GPU identification**
- AMD (RDNA1/2/3/4, GCN)
- Intel (Arc, Integrated)
- NVIDIA (RTX 20/30/40)
- 🎮 **Steam library scanning**
- 📊 **Driver version checking**
- ⚙️ **Capability analysis**
### 🚀 Smart Configuration
- 📝 **Profile-based optimization**
- 6 GPU profiles
- 10+ game profiles
- 🔧 **Automated file generation**
- OptiScaler.ini
- fakenvapi.ini (AMD/Intel)
- 💾 **Automatic backups**
- 🔄 **Easy rollback**
---
## 🚀 Quick Start: Boost Your FPS on Linux in 30 Seconds
### Option 1: One-Line Install (Fastest)
```bash
git clone https://github.com/ind4skylivey/0ptiscaler4linux.git
cd 0ptiscaler4linux
bash scripts/install.sh
```
### Option 2: AUR Package (Arch/Manjaro Users)
```bash
# Using yay
yay -S optiscaler-universal
# Using paru
paru -S optiscaler-universal
# Manual install
git clone https://aur.archlinux.org/optiscaler-universal.git
cd optiscaler-universal
makepkg -si
```
After installation, run:
```bash
optiscaler-install # System-wide command
```
**Steam Deck users:** Follow our [Steam Deck Setup Guide](docs/steam-deck-setup-optiscaler-linux-gaming.md) for optimized installation.
---
## 🔍 Advanced Game Detection
OptiScaler now includes an intelligent multi-disk Steam scanner:
- ✅ Universal library discovery across all mounted disks (/mnt, /media, Steam Deck)
- ✅ AppID-first matching (100% reliable when manifests exist)
- ✅ 4-method fallback: manifest → folder fuzzy → executable probe → compatdata lookup
- ✅ Proton prefix awareness and writable-path checks
- ✅ Smart caching (5-minute TTL) with `--force-rescan` to bypass
CLI flags you can use:
```bash
# Scan only (no install), cached
bash scripts/install.sh --scan-only --verbose
# Force fresh scan
bash scripts/install.sh --scan-only --force-rescan
# List supported games
bash scripts/install.sh --list-games
# Max detail for debugging
LOG_LEVEL=DEBUG bash scripts/install.sh --scan-only --debug
```
See the detailed flow in `docs/multi-disk-detection.md`.
---
## 💥 Linux Gaming Performance: Real FPS Gains
| 🎮 Game | 🖥️ GPU | 📈 Before | 📈 After | 🚀 Gain |
|---------|---------|-----------|----------|---------|
| Cyberpunk 2077 | RX 7900 XTX | 85 FPS | 142 FPS | **+67%** |
| Starfield | RX 6800 XT | 52 FPS | 89 FPS | **+71%** |
| Hogwarts Legacy | Arc A770 | 45 FPS | 72 FPS | **+60%** |
| Red Dead 2 | RX 7600 | 58 FPS | 95 FPS | **+64%** |
*All tests performed on Linux with Steam + Proton*
Want to optimize Cyberpunk 2077 on Linux? Check out our [Cyberpunk 2077 Linux FSR4 Guide](docs/cyberpunk-2077-linux-fsr4-optiscaler-guide.md).
---
## 🎮 Supported Games: Linux Gaming Performance Tested with Proton & Steam
Full RT Support
Creation Engine 2
Excellent RT
Full RT Support
Vulkan Optimized
DX12 Optimized
Path Tracing
+ Many More Compatible Linux Games!
📋 View Full Game Compatibility List →
---
## 🖥️ Supported GPUs for Linux Gaming
### 🎯 Comprehensive GPU Support for AMD, Intel & NVIDIA
### 🔴 AMD
- ✅ **RDNA4** (RX 9000)
- FSR4 native
- +60-80% FPS
- ✅ **RDNA3** (RX 7000)
- FSR3.1 optimized
- +50-70% FPS
- ✅ **RDNA2** (RX 6000)
- Anti-Lag 2
- +55-75% FPS
- ✅ **RDNA1** (RX 5000)
- +40-60% FPS
### 🔵 Intel
- ✅ **Arc A-series**
- XeSS native
- +40-60% FPS
- DX12/Vulkan
- ⚠️ **Integrated**
- FSR3.1 fallback
- +30-50% FPS
### 🟢 NVIDIA
- ✅ **RTX 40/30/20**
- Native DLSS
- Native Reflex
- OptiScaler optional
- ⚠️ **GTX 16/10**
- FSR3.1 support
- +35-55% FPS
For detailed profiles and recommendations, see our **[GPU Profiles Guide for Linux Gaming](docs/gpu-profiles-explained-optiscaler-linux.md)**.
---
## 📚 Documentation
**Getting Started:**
- [How to Boost FPS in Linux Games with OptiScaler](docs/linux-fps-boost-with-optiscaler.md)
- [Steam Deck Setup Guide: Maximize FPS with OptiScaler](docs/steam-deck-setup-optiscaler-linux-gaming.md)
- [Proton Setup for Linux Gaming with OptiScaler](docs/proton-setup-for-linux-gaming-with-optiscaler.md)
**Technical Guides:**
- [GPU Profiles Explained for AMD, Intel & NVIDIA](docs/gpu-profiles-explained-optiscaler-linux.md)
- [FSR4, XeSS & DLSS on Linux: Complete Guide](docs/fsr4-xess-dlss-on-linux-with-optiscaler.md)
- [Troubleshooting: FPS Drops, Crashes & Performance Issues](docs/troubleshooting-optiscaler-linux-fps-drops-crashes.md)
**Game-Specific:**
- [Cyberpunk 2077 on Linux: FSR4 Setup Guide](docs/cyberpunk-2077-linux-fsr4-optiscaler-guide.md)
- [Starfield Linux Gaming: Proton + OptiScaler Setup](docs/starfield-linux-proton-optiscaler-guide.md)
- [Game Compatibility List](docs/game-compatibility-list-optiscaler-linux.md)
**Project Info:**
- [Project Design](PROJECT_DESIGN.md)
- [Contributing Guide](docs/CONTRIBUTING.md)
---
## 🛠️ Advanced Features
🔍 GPU Detection & Driver Validation
- Automatic vendor identification (AMD/Intel/NVIDIA)
- Architecture detection (RDNA, Arc, Ampere, etc.)
- Driver version checking (Mesa/NVIDIA)
- Capability analysis (FSR4, XeSS, DLSS support)
- Profile selection based on hardware
🎮 Steam Library Scanner
- Steam library auto-detection
- Multiple library support
- Proton compatibility checking
- Game-specific profile matching
- Installation verification
⚙️ Configuration Generator
- Optimal settings per GPU
- Game-specific tuning
- FSR/XeSS/DLSS configuration
- Anti-Lag/Reflex setup
- Quality vs Performance presets
💾 Safety Features
- Automatic file backups
- One-command rollback
- Non-destructive installation
- Dry-run mode available
- Comprehensive logging
---
## 🔧 Advanced Usage
### Manual Game Addition
```bash
bash scripts/install.sh --game-dir "/path/to/game" --game-profile "generic"
```
### Custom GPU Profile
```bash
bash scripts/install.sh --gpu-profile "custom.yaml"
```
### Benchmark Mode
```bash
bash scripts/benchmark.sh --game "Cyberpunk 2077" --runs 5
```
### Diagnostics
```bash
bash scripts/diagnose.sh --game "New World" --verbose
```
---
## 🤝 Contributing
We welcome contributions from the Linux gaming community! Whether it's:
- 🐛 Bug reports
- ✨ Feature requests for Linux gaming optimization
- 📝 Documentation improvements
- 🎮 New game profiles for Steam/Proton games
- 🖥️ GPU profile optimizations for AMD/Intel/NVIDIA
- 🧪 Testing and feedback on Steam Deck
Please see [Contributing Guide](docs/CONTRIBUTING.md) for guidelines.
---
## 📊 Project Status
### Current Version: 0.1.0-alpha
**Phase 1: Alpha Release** ✅ Complete!
- [x] Project structure
- [x] Design documentation
- [x] GPU detection (AMD/Intel/NVIDIA)
- [x] Steam game scanner
- [x] 10 game profiles
- [x] Configuration generator
- [x] Automated installer
- [x] Core documentation
[View full roadmap →](PROJECT_DESIGN.md#-future-roadmap)
---
## 🌐 Linux Gaming Community
- **GitHub Issues**: [Bug reports and feature requests](https://github.com/ind4skylivey/0ptiscaler4linux/issues)
- **Discord**: Coming soon
- **Reddit**: [r/linux_gaming](https://reddit.com/r/linux_gaming) discussions
- **ProtonDB**: Game compatibility reports
---
## ⭐ Found This Useful?
If OptiScaler for Linux helped boost your FPS, please:
- **⭐ Star this repository** to help other Linux gamers and Steam Deck users find it
- **🐛 Report issues** if you encounter problems: [Open an issue](https://github.com/ind4skylivey/0ptiscaler4linux/issues/new)
- **💬 Share your FPS gains** on r/linux_gaming or ProtonDB
- **🤝 Contribute** game profiles, GPU optimizations, or Steam Deck tweaks
**Your feedback makes Linux gaming better for everyone.**
---
## 📜 License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
### Third-Party Software
- [OptiScaler](https://github.com/optiscaler/OptiScaler) - GPL-3.0 License
- [fakenvapi](https://github.com/FakeMichau/fakenvapi) - MIT License
- AMD FidelityFX SDK - MIT License
---
## 🙏 Acknowledgments
- **OptiScaler Team** - For creating the amazing OptiScaler mod
- **fakenvapi** - For enabling Anti-Lag 2 on AMD GPUs for Linux
- **Linux Gaming Community** - For continuous support and testing
- **AMD, Intel, NVIDIA** - For their upscaling technologies (FSR4, XeSS, DLSS)
- **Valve** - For Proton and Steam Deck, advancing Linux gaming
---
## ⚠️ Disclaimer
This 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.
This tool is designed specifically for Linux gaming with Steam, Proton, and Steam Deck.
---
## 🚀 Ready to Boost Your Linux Gaming FPS?
### Get Started in 30 Seconds
```bash
git clone https://github.com/ind4skylivey/0ptiscaler4linux.git
cd 0ptiscaler4linux
bash scripts/install.sh
```
### 🎯 Quick Links
[](docs/linux-fps-boost-with-optiscaler.md)
[](PROJECT_DESIGN.md)
[](https://github.com/ind4skylivey/0ptiscaler4linux/issues/new?template=bug_report.md)
[](docs/CONTRIBUTING.md)
### 💬 Join the Linux Gaming Community
[](https://github.com/ind4skylivey/0ptiscaler4linux/issues)
[](https://github.com/ind4skylivey/0ptiscaler4linux/stargazers)
[](https://github.com/ind4skylivey/0ptiscaler4linux/network/members)
**r/linux_gaming** • **ProtonDB** • **Gaming on Linux** • **Steam Deck HQ**
---
### 🎮 Unlock Massive FPS Gains on Linux
Automated • Intelligent • Safe • Perfect for Steam Deck
Built with ❤️ by S1BGr0up for the Linux gaming community
Powered by OptiScaler •
fakenvapi •
The Linux Gaming Community