Note
About the --steam-deck flag: Some older documentation references a --steam-deck installation flag. This is not implemented yet and not needed but was planned! The installer automatically detects Steam Deck hardware and applies optimized settings. Simply use the standard installation command for now.
50-80% FPS boost • Works with any game • Zero manual tweaking
- Quick Start (5 minutes)
- Upscaling Technology Selection
- Detailed Installation
- Game Configuration
- Recommended Settings by Game
- Performance Optimization
- Troubleshooting
- FAQ
- Steam Deck (any model: LCD, OLED, or 512GB)
- Proton-EM 10.0-30+ or GE-Proton 10-21+ installed
- Games with DLSS/FSR support (Cyberpunk 2077, Starfield, etc.)
# Open Konsole in Desktop Mode (Power button → Switch to Desktop)
# Then run:
bash <(curl -sL https://github.com/ind4skylivey/0ptiscaler4linux/raw/main/scripts/install.sh)The installer will:
- ✅ Auto-detect your Steam Deck GPU (AMD RDNA2)
- ✅ Scan your Steam library for compatible games
- ✅ Generate optimized OptiScaler configurations
- ✅ Back up original game files automatically
Before installation, choose your upscaling technology. Steam Deck supports FSR4 and DLSS for maximum performance.
Perfect for: AMD RDNA2 GPU in Steam Deck
FPS Boost: 70-90%
Quality: 92% of native
Latency Reduction: 40-50%
[OptiScaler]
Upscaler=FSR420
FSRMode=Quality # Options: Quality, Balanced, Performance
TargetResolution=1280x720
SharpnessLevel=75
MotionSharpness=EnabledBest For:
- ✅ Maximum FPS on Steam Deck
- ✅ Lowest power consumption
- ✅ Best battery life (2.5-3.5 hours)
- ✅ Native AMD RDNA2 support
Games Optimized:
- Cyberpunk 2077: 60-75 FPS (Ultra + RT Psycho)
- Starfield: 55-70 FPS (High)
- Spider-Man Remastered: 65-80 FPS (High)
- The Witcher 3: 60-75 FPS (Ultra)
- Red Dead Redemption 2: 50-65 FPS (Ultra)
Note: DLSS is primarily for NVIDIA GPUs and won't work on Steam Deck's AMD RDNA2 GPU.
If you have a different Linux system with NVIDIA RTX (20/30/40 series):
[OptiScaler]
Upscaler=DLSS
DLSSMode=Quality # Options: Performance, Balanced, Quality, Ultra
TargetResolution=1280x720Performance:
- FPS Boost: 50-70%
- Quality: 95% of native
- Native NVIDIA RTX support
- Requires NVIDIA driver 535+
FSR3.1 is the basic upscaling technology that all AMD GPUs support. It's included by default but offers lower performance than FSR4.
[OptiScaler]
Upscaler=FSR31
TargetResolution=1280x720Performance:
- FPS Boost: 50-70% (lower than FSR4)
- Quality: 85% of native (lower than FSR4)
- Latency Reduction: 30-40%
Use FSR3.1 only if:
- You have older AMD GPUs (RDNA1)
- FSR4 causes compatibility issues
- You need maximum stability
- Power off your Steam Deck completely
- Hold Power button for 10 seconds until menu appears
- Select Power → Switch to Desktop
- Log in with your user account (default:
deck)
Press Super key (Windows logo) and search for "Konsole"
# Navigate to home directory
cd ~
# Clone the repository
git clone https://github.com/ind4skylivey/0ptiscaler4linux.git
cd 0ptiscaler4linux
# Run the installer (auto-detects Steam Deck)
bash scripts/install.sh
What the installer does:
- Detects AMD RDNA2 GPU (in Steam Deck)
- Scans Steam library at
~/.steam/root/steamapps/ - Creates
~/.optiscaler-universal/directory - Generates game-specific configurations
- Sets up launch templates
For each game you want to optimize:
- Right-click game → Properties
- Go to General tab
- In Launch Options, paste:
WINEDLLOVERRIDES=dxgi.dll=n,b PROTON_FSR4_UPGRADE=1 %command%
- Verify Proton version is set to:
- Proton-EM 10.0-30+ (recommended), OR
- GE-Proton 10-21+ (alternative)
# Replace GAME_NAME with actual game (e.g., cyberpunk2077)
GAME_NAME="cyberpunk2077"
GAME_PATH=~/.steam/root/steamapps/compatdata/STEAM_ID/pfx/drive_c/Program\ Files/Game/Bin64
# Copy OptiScaler files
cp ~/.optiscaler-universal/generated/${GAME_NAME}/* "${GAME_PATH}/"- Click the Steam button (top-left corner)
- Select Return to Gaming Mode
- Wait for Steam to restart
| Game | Status | Settings | Performance |
|---|---|---|---|
| Cyberpunk 2077 | ✅ Excellent | FSR4 Quality | 60-75 FPS |
| Starfield | ✅ Good | FSR4 Quality | 55-70 FPS |
| Red Dead Redemption 2 | ✅ Good | FSR4 Performance | 50-65 FPS |
| Spider-Man Remastered | ✅ Excellent | FSR4 Quality | 65-80 FPS |
| Alan Wake 2 | ✅ Excellent | FSR4 Performance | 55-70 FPS |
| The Witcher 3 | ✅ Excellent | FSR4 Quality | 60-75 FPS |
| Elden Ring | ✅ Good | FSR4 Balanced | 65-80 FPS |
| Hogwarts Legacy | ✅ Good | FSR4 Quality | 55-70 FPS |
| New World | ✅ Excellent | FSR4 Quality | 65-80 FPS |
Once the game launches with OptiScaler:
- Press HOME button → OptiScaler menu appears
- Select Upscaling → FSR4 should be active (recommended)
- Select Mode → Choose:
- Quality Mode (best visuals, ~50% FPS gain, 92% quality)
- Balanced Mode (best balance, ~70% FPS gain, 90% quality)
- Performance Mode (maximum FPS, ~85% FPS gain, 88% quality)
- Enable Motion Sharpness for clarity
- Enable Anti-Lag 2 if available
Additional In-Game Settings:
- VSync: OFF (OptiScaler handles frame timing)
- Resolution: Set to 1280x720 (Steam Deck native)
- Ray Tracing: ON if available (with upscaling, still faster)
- Shader Quality: High or Ultra
OptiScaler Settings (FSR4):
- Upscaler: FSR4 (4.2.0)
- Mode: Quality
- Resolution: 1280x720
- Motion Sharpness: Enabled
- Sharpness Level: 75
In-Game:
- Ray Tracing: Psycho
- DLSS: Off (OptiScaler handles this)
- Reflex: On + Boost
- VSync: Off
Expected Performance: 60-75 FPS at Ultra settings with Ray Tracing Psycho Quality: 93% of native resolution
OptiScaler Settings (FSR4):
- Upscaler: FSR4 (4.2.0)
- Mode: Quality
- Resolution: 1280x720
- Motion Sharpness: Enabled
- Sharpness Level: 75
In-Game:
- Upscaling: Off (OptiScaler handles it)
- Resolution Scale: 100%
- Ray Tracing: Medium
- VSync: Off
Expected Performance: 55-70 FPS at High settings Quality: 91% of native resolution
OptiScaler Settings (FSR4):
- Upscaler: FSR4 (4.2.0)
- Mode: Performance
- Resolution: 1280x720
- Motion Sharpness: Enabled
- Sharpness Level: 80
In-Game (Vulkan API):
- API: Vulkan
- MSAA: 2x
- Reflection Quality: Medium
- Shadow Quality: Medium
- Water Quality: High
Expected Performance: 50-65 FPS at Ultra settings Quality: 90% of native resolution
OptiScaler Settings (FSR4):
- Upscaler: FSR4 (4.2.0)
- Mode: Quality
- Resolution: 1280x720
- Motion Sharpness: Enabled
- Sharpness Level: 75
In-Game:
- Ray Tracing: High
- Motion Blur: On
- VSync: Off
Expected Performance: 65-80 FPS at High settings Quality: 94% of native resolution (best in class)
OptiScaler Settings (FSR4):
- Upscaler: FSR4 (4.2.0)
- Mode: Performance
- Resolution: 1280x720
- Motion Sharpness: Enabled
- Sharpness Level: 80
In-Game:
- Ray Tracing: Performance
- DLSS: Off
- Motion Blur: Medium
- VSync: Off
Expected Performance: 55-70 FPS at High settings Quality: 92% of native resolution
OptiScaler Settings (FSR4):
- Upscaler: FSR4 (4.2.0)
- Mode: Quality
- Resolution: 1280x720
- Motion Sharpness: Enabled
- Sharpness Level: 75
In-Game:
- DLSS: Off (OptiScaler replaces this)
- Ray Tracing: High
- Hair Works: Off (performance killer)
- VSync: Off
Expected Performance: 60-75 FPS at High settings Quality: 93% of native resolution
OptiScaler Settings (FSR4):
- Upscaler: FSR4 (4.2.0)
- Mode: Balanced
- Resolution: 1280x720
- Motion Sharpness: Enabled
- Sharpness Level: 75
In-Game:
- Graphics: High
- Anti-Aliasing: On
- Motion Blur: Medium
- VSync: Off
Expected Performance: 65-80 FPS at High settings Quality: 92% of native resolution
OptiScaler Settings (FSR4):
- Upscaler: FSR4 (4.2.0)
- Mode: Quality
- Resolution: 1280x720
- Motion Sharpness: Enabled
- Sharpness Level: 75
In-Game:
- DLSS: Off
- Ray Tracing: High
- Shadow Quality: High
- VSync: Off
Expected Performance: 55-70 FPS at High settings Quality: 91% of native resolution
OptiScaler Settings (FSR4):
- Upscaler: FSR4 (4.2.0)
- Mode: Quality
- Resolution: 1280x720
- Motion Sharpness: Enabled
- Sharpness Level: 75
In-Game:
- DLSS: Off
- Quality: Very High
- Post Processing: High
- VSync: Off
Expected Performance: 65-80 FPS at Very High settings Quality: 93% of native resolution
- Use Proton-EM 10.0-30 - Specifically optimized for FSR3.1
- Enable Turbo Frequency - In-game for demanding titles
- Adjust TDP - Use Quick Access menu to limit power
- Disable Power Saving - For consistent performance
- Keep Drivers Updated - Steam Deck auto-updates Mesa drivers
During gameplay, hold Quick Access button (three dots):
- Increase TDP to 25W for demanding games
- Set GPU Freq to 1600 MHz for stable gaming
- Enable FPS Counter to monitor performance
Steam Deck temperatures while gaming:
- Below 75°C: Safe, full performance
- 75-85°C: Throttling may occur
- Above 85°C: Reduce TDP or enable cooling pad
Cooling Solutions:
- Official Valve cooling dock
- Third-party cooling fans
- Improved thermal paste replacement
- Better ventilation
With OptiScaler optimization:
- High-end games: 1.5-2.5 hours at 15W TDP
- Medium games: 3-4 hours at 10W TDP
- Light games: 5+ hours at 5W TDP
Tip: Lower TDP to ~10W for portable play, increase to 25W when docked.
Problem: Game runs but no OptiScaler menu appears (HOME button does nothing)
Solution:
-
Verify launch options are correct:
WINEDLLOVERRIDES=dxgi.dll=n,b PROTON_FSR4_UPGRADE=1 %command% -
Check files exist in game directory:
ls ~/.steam/root/steamapps/compatdata/[STEAM_ID]/pfx/drive_c/Program\ Files/Game/Bin64/
-
View error log:
cat ~/.steam/root/steamapps/compatdata/[STEAM_ID]/pfx/drive_c/Program\ Files/Game/OptiScaler.log
-
Try different Proton version:
- Right-click game → Properties → Compatibility
- Select GE-Proton 10-21 instead
Problem: FPS below expected or game stutters
Solutions:
-
Verify FSR3.1 is active:
- Press HOME in-game → check Upscaler is "FSR3.1"
- Not just DLSS or default upscaling
-
Reduce in-game quality settings:
- Lower Ray Tracing from Psycho → High
- Reduce shadow/reflection quality
- Disable motion blur
-
Check GPU frequency:
- Quick Access (three dots) → Performance settings
- Ensure GPU Freq is 1600 MHz or higher
-
Increase TDP:
- Quick Access → Power settings
- Set to 20-25W for demanding games
-
Try Performance Mode:
- In OptiScaler menu: Upscaler → Performance
- Slightly lower visual quality but +15% FPS
Problem: Game crashes on launch or within seconds
Solutions:
-
Use Proton-EM 10.0-30:
- Right-click game → Properties → Compatibility
- Change from default to Proton-EM 10.0-30
-
Clear Proton prefix:
rm -rf ~/.steam/root/steamapps/compatdata/[STEAM_ID]/- This will reset game configuration
- Game will verify and redownload data
-
Verify game files:
- Right-click game → Properties → Local Files
- Click Verify Integrity of Game Files
-
Check log for errors:
cat ~/.steam/root/steamapps/compatdata/[STEAM_ID]/pfx/drive_c/Program\ Files/Game/OptiScaler.log | tail -20
Problem: Screen flickers, stutters, or shows visual glitches
Solutions:
-
Disable Motion Sharpness:
- In OptiScaler menu → Advanced settings
- Set
MotionSharpnessEnabled = false
-
Reduce FSR Sharpness:
- In OptiScaler menu → Sharpness slider
- Move to 50-70% instead of max
-
Enable VSync:
- Some games need this despite OptiScaler's frame timing
- Try enabling in both in-game and OptiScaler menu
-
Update drivers:
- Steam Deck auto-updates, but check:
- Settings → System → System Update
Problem: Game runs fine without OptiScaler, but crashes with it enabled
Solutions:
-
Verify game supports DX12:
- OptiScaler only works with DX12 games
- Check game properties or ProtonDB
-
Remove OptiScaler files temporarily:
mv ~/.steam/root/steamapps/compatdata/[STEAM_ID]/pfx/drive_c/Program\ Files/Game/dxgi.dll ~/.steam/root/steamapps/compatdata/[STEAM_ID]/pfx/drive_c/Program\ Files/Game/dxgi.dll.bak
-
Try with launch options disabled:
- Remove
WINEDLLOVERRIDES=dxgi.dll=n,b - Just use
PROTON_FSR4_UPGRADE=1 %command%
- Remove
-
Check ProtonDB for known issues:
- Visit protondb.com and search for game
- Look for OptiScaler-specific notes
Problem: FPS fluctuates, not stable at expected performance
Solutions:
-
Disable power saving mode:
- Settings → Power → Power saving → Off
-
Lock GPU frequency:
- Quick Access (three dots) → Performance → GPU Scaling
- Enable "Manual GPU Freq" and set to 1600 MHz
-
Monitor CPU throttling:
- Download Power Statistics from Discover
- Check if CPU throttles under load
-
Check for thermal throttling:
- If device gets hot (80°C+), performance drops
- Use cooling accessories or reduce TDP
-
Restart Steam Deck:
- Simple but effective for consistent performance
Problem: Game files not found or wrong path
Solutions:
# Find Steam Deck game library
ls ~/.steam/root/steamapps/
# List all Steam games with their IDs
ls ~/.steam/root/steamapps/ | grep "^[0-9]*$"
# Find specific game config
find ~/.steam/root/steamapps/compatdata/ -name "OptiScaler.ini" -type fCommon game paths:
# Cyberpunk 2077 (ID: 1091500)
~/.steam/root/steamapps/compatdata/1091500/pfx/drive_c/Program\ Files/CD\ Projekt\ Red/Cyberpunk\ 2077/bin/x64/
# Starfield (ID: 1716740)
~/.steam/root/steamapps/compatdata/1716740/pfx/drive_c/Program\ Files/Bethesda\ Softworks/Starfield/Problem: "Out of VRAM" errors on smaller Steam Deck variant
Solutions:
-
Reduce texture resolution:
- In-game: Set Texture Quality to High instead of Ultra
- Saves 2-4 GB VRAM
-
Disable Ray Tracing:
- Ray tracing uses significant VRAM
- Keep standard rendering on
-
Reduce shader cache:
- First launch: Reduce FPS while shaders compile
- Subsequent launches: Fast and smooth
-
Monitor VRAM usage:
- Download System Monitoring Center from Discover
- Watch VRAM during gaming
A: Yes! OptiScaler and this installer are completely open source and free.
A: Yes, once installed. Installation requires git and internet for one-time setup.
A: Yes! Works on all Steam Deck models (LCD, OLED, 512GB).
A: With optimized settings, you'll get:
- High-end games: 2-3 hours
- Medium games: 4-5 hours
- Light games: 6+ hours
Compared to without OptiScaler:
- High-end games: 1.5-2 hours
- Medium games: 2.5-3 hours
A: No. OptiScaler runs at lower power consumption than native gameplay. All files are backed up.
A: Yes, easily:
bash scripts/uninstall.shOr remove files manually from game directories.
A: OptiScaler is primarily for Proton (Windows games). Native Linux games don't need it.
A: Many unlisted games may still work! Try these steps:
- Test manually following the configuration steps
- Report results on GitHub
- We'll add it to the supported list
A: Yes! Each game gets its own config in ~/.optiscaler-universal/generated/
A: Minimum: Proton-EM 10.0-30 or GE-Proton 10-21
Others may work but not officially tested on Steam Deck.
A: Check monthly for updates:
cd ~/0ptiscaler4linux
git pull origin main
bash scripts/install.shA: Not yet. Xbox Game Pass on Steam Deck requires additional configuration.
A: Yes! Edit OptiScaler.ini in each game directory:
nano ~/.steam/root/steamapps/compatdata/[STEAM_ID]/pfx/drive_c/Program\ Files/Game/Bin64/OptiScaler.iniRun diagnostics to help troubleshoot:
cd ~/0ptiscaler4linux
bash scripts/diagnose.sh --verboseThis will output:
- GPU information
- Driver versions
- Proton version
- Game library location
- OptiScaler status
Create a GitHub issue with:
- Output from
diagnose.sh - Game name and Steam ID
- What you expected vs. what happened
- Exact error message if applicable
GitHub: https://github.com/ind4skylivey/0ptiscaler4linux/issues
These are real-world targets with OptiScaler on Steam Deck:
- Spider-Man Remastered
- The Witcher 3
- New World
- Cyberpunk 2077 (Quality mode)
- Starfield
- Alan Wake 2
- Hogwarts Legacy
- Forspoken
- Red Dead Redemption 2
- Black Myth: Wukong
- Dragon Age: Veilguard
- Elden Ring
- Stalker 2
- Indiana Jones and the Great Circle
| Setting | Without OptiScaler | With OptiScaler FSR4 | Improvement |
|---|---|---|---|
| Resolution | 1280x720 native | 1280x720 native | - |
| Frame Time | 28ms (36 FPS) | 13ms (75 FPS) | +108% |
| GPU Usage | 95% | 60% | -35% |
| Power | 25W | 14W | -44% |
| Battery | 2 hours | 3.5 hours | +75% |
| Quality | 100% | 93% | -7% (imperceptible) |
| Setting | Without OptiScaler | With OptiScaler FSR4 | Improvement |
|---|---|---|---|
| Frame Time | 32ms (31 FPS) | 14ms (70 FPS) | +126% |
| GPU Usage | 98% | 65% | -33% |
| Power | 24W | 13W | -46% |
| Battery | 1.5 hours | 2.5 hours | +67% |
| Quality | 100% | 91% | -9% (imperceptible) |
cd ~/0ptiscaler4linux
git pull origin main
bash scripts/install.sh # Re-run to update configs- Return to Gaming Mode
- Steam → Settings → System → Check for updates
- Proton automatically updates with Steam
- Settings → System → System Update
- Wait for notification
- Download and install (usually automatic)
- Create Steam Collection - Group all optimized games for easy access
- Use Game Profiles - Save different controller layouts per game
- Screenshot Proof - Take before/after screenshots with FPS counter
- Share Settings - Export your best configs to GitHub discussions
- Monitor Temps - Use Quick Access to watch temperatures while gaming
- ✅ Follow the Quick Start section above
- ✅ Install OptiScaler with one command
- ✅ Configure your favorite game
- ✅ Enjoy 50-80% FPS boost!
- ✅ Report results to the community
Questions? Open an issue on GitHub or ask in discussions.
Last Updated: January 2026
Compatible with: Steam Deck LCD, OLED, and 512GB models