OptiScaler Auto Manager

A comprehensive Python-based tool for automatically managing OptiScaler installations on Steam games in Linux. OptiScaler enables FSR4, DLSS, and other upscaling technologies on games that don't natively support them.

Features

🎮 Steam Integration: Automatically detects Steam games and installation paths
🚀 Auto Installation: Downloads and installs the latest OptiScaler nightly builds
⚙️ Smart Configuration: Automatically configures OptiScaler.ini with optimal settings
🖥️ Desktop Integration: GUI launcher with application menu integration
📊 MangoHUD Support: Optional performance monitoring overlay
🔧 Launch Options: Automatically applies Steam launch options with proper VDF formatting
🗂️ FSR4 Management: Manages multiple FSR4 DLL versions
📦 Backup System: Creates backups before making changes
🔄 Uninstaller: Clean removal of OptiScaler installations

Quick Start

Option 1: GUI Launch (Recommended)

Run ./install-desktop-entry.sh to install desktop integration
Launch from Applications menu: Games > OptiScaler Manager
Or double-click launch-gui.sh

Option 2: Terminal Launch

./run.sh

Installation

Prerequisites

Linux Distribution: Arch Linux, Bazzite, or compatible
Steam: Installed and configured
Python 3: With requests module
p7zip: For archive extraction

Automatic Setup

The script automatically installs missing dependencies:

git clone <repository-url>
cd optiscaler-auto-manager
chmod +x run.sh
./run.sh

Manual Dependency Installation

# Arch Linux / Bazzite
sudo pacman -S python-requests p7zip

# Ubuntu / Debian
sudo apt install python3-requests p7zip-full

# Fedora
sudo dnf install python3-requests p7zip

Usage Guide

1. Install OptiScaler on a Game

Launch OptiScaler Manager
Select "2. Install OptiScaler"
Choose your game from the Steam library
Select installation location (usually "Main Game Directory")
The tool will:
- Download latest OptiScaler nightly
- Extract to game directory
- Run setup scripts
- Configure OptiScaler.ini
- Copy FSR4 DLL to compatibility data

2. Configure Steam Launch Options

Select "6. Add Steam launch options"
Choose your game
Select if you need RDNA3 workarounds
Choose to include MangoHUD (performance monitoring)
Pick launch option type:
- Basic: Essential OptiScaler setup
- Advanced: Additional performance optimizations
- Debug: Detailed logging for troubleshooting
- Anti-Lag 2: Experimental latency reduction

3. Manage FSR4 DLL Versions

Select "7. Manage FSR4 DLL"
Choose from bundled FSR4 versions or browse for custom DLL
The selected version will be used for all future installations

4. View and Uninstall

View installations: Option 3 shows all current OptiScaler installations
Uninstall: Option 4 cleanly removes OptiScaler and restores original files

Launch Command Examples

Basic OptiScaler

WINEDLLOVERRIDES="dxgi=n,b" PROTON_FSR4_UPGRADE=1 %command%

With MangoHUD Performance Monitoring

mangohud WINEDLLOVERRIDES="dxgi=n,b" PROTON_FSR4_UPGRADE=1 %command%

RDNA3 GPU Workaround

WINEDLLOVERRIDES="dxgi=n,b" DXIL_SPIRV_CONFIG=wmma_rdna3_workaround PROTON_FSR4_UPGRADE=1 RADV_PERFTEST=nggc %command%

Advanced with Performance Optimizations

WINEDLLOVERRIDES="dxgi=n,b" PROTON_FSR4_UPGRADE=1 DXVK_ASYNC=1 PROTON_ENABLE_NVAPI=1 PROTON_HIDE_NVIDIA_GPU=0 VKD3D_CONFIG=dxr11,dxr WINE_CPU_TOPOLOGY=4:2 %command%

File Structure

optiscaler-auto-manager/
├── optiscaler_manager.py          # Main application
├── run.sh                         # Terminal launcher with dependency check
├── launch-gui.sh                  # GUI launcher for desktop integration
├── install-desktop-entry.sh       # Desktop integration installer
├── optiscaler-manager.desktop     # Desktop entry file
├── create-icon.py                 # Icon generator
├── optiscaler-icon.svg           # Application icon
├── test_steam_fix.py             # Steam VDF testing utility
├── test_hunt.py                  # Hunt: Showdown testing utility
└── README.md                     # This file

Configuration Files

User Configuration

Installations: ~/.config/optiscaler_manager/installations.json
FSR4 DLL: ~/.config/optiscaler_manager/amdxcffx64.dll
Desktop Entry: ~/.local/share/applications/optiscaler-manager.desktop

Steam Integration

Config Path: ~/.steam/steam/userdata/[USER_ID]/config/localconfig.vdf
Backups: Automatic backups created before modifications

Supported Games

OptiScaler works with most DirectX 11/12 games. Tested and verified with:

Hunt: Showdown
Stellar Blade
Cyberpunk 2077
Elden Ring
And many more...

GPU Compatibility

AMD GPUs

RDNA3 (RX 7000 series): Use RDNA3 workaround options
RDNA2 (RX 6000 series): Standard options work
RDNA1 (RX 5000 series): Basic OptiScaler support

NVIDIA GPUs

RTX 40 series: Full DLSS/FSR support
RTX 30/20 series: DLSS + FSR support
GTX series: FSR support only

Intel GPUs

Arc GPUs: Basic FSR support

Troubleshooting

OptiScaler Overlay Not Appearing

Try the "Disable DLSS FG" launch option variant
Ensure WINEDLLOVERRIDES="dxgi=n,b" is present
Check game logs for DLL loading errors

Steam Launch Options Not Applying

Restart Steam completely after applying options
Check Steam game properties to verify options are visible
Restore from backup if VDF corruption occurs

Performance Issues

Enable MangoHUD to monitor performance
Try different OptiScaler presets (Performance vs Quality)
Use DXVK_ASYNC=1 for better frame pacing

FSR4 Not Working

Verify amdxcffx64.dll is in compatdata/[APPID]/pfx/drive_c/windows/system32/
Check OptiScaler.ini has Fsr4Update=true
Ensure game supports FSR4 requirements

Advanced Configuration

Custom OptiScaler.ini Settings

Edit the generated OptiScaler.ini in your game directory:

[OptiScaler]
Fsr4Update=true
Dx12Upscaler=auto
ColorResourceBarrier=auto
MotionVectorResourceBarrier=auto
OverrideNvapiDll=auto

Custom Launch Options

You can manually add these environment variables:

DXVK_ASYNC=1 - Async shader compilation
PROTON_ENABLE_NVAPI=1 - Enable NVIDIA API
VKD3D_CONFIG=dxr11,dxr - DirectX Raytracing support
WINE_CPU_TOPOLOGY=4:2 - CPU topology override

Development

Testing Steam VDF Integration

python3 test_steam_fix.py    # Test VDF parsing
python3 test_hunt.py         # Test with specific game

Contributing

Fork the repository
Create a feature branch
Test with multiple games and GPU types
Submit pull request

License

This project is open source. OptiScaler itself is developed by the OptiScaler team.

Acknowledgments

OptiScaler Team: For the amazing upscaling technology
Valve: For Steam and Proton
AMD: For FSR technology
Community: For testing and feedback

Support

For issues and support:

Check the troubleshooting section above
Enable debug launch options for detailed logs
Create an issue with system information and logs
Join the OptiScaler community forums

Enjoy enhanced gaming with OptiScaler! 🎮✨

Name		Name	Last commit message	Last commit date
Latest commit History 13 Commits
fsr4_dlls		fsr4_dlls
DEPENDENCIES.md		DEPENDENCIES.md
README.md		README.md
cli.py		cli.py
create-icon.py		create-icon.py
create_fsr4_structure.sh		create_fsr4_structure.sh
dependency_manager.py		dependency_manager.py
fsr_manager.py		fsr_manager.py
install-desktop-entry.sh		install-desktop-entry.sh
launch-gui.sh		launch-gui.sh
main.py		main.py
optiscaler-icon.svg		optiscaler-icon.svg
optiscaler_installer.py		optiscaler_installer.py
run.sh		run.sh
setup_fsr4.sh		setup_fsr4.sh
steam_utils.py		steam_utils.py
test_dependencies.py		test_dependencies.py

OldNero/optiscaler-auto-manager

Folders and files

Latest commit

History

Repository files navigation