FSR Monitor Advanced 🎮

Comprehensive FSR Detection System for Linux

Detects all FSR (FidelityFX Super Resolution) versions including FSR4 RDNA3 hacks with 95% confidence using environment variables and advanced detection methods.

🚀 Quick Install

# One-command installation with desktop integration
./install.sh

✨ Installs everything: binary, desktop app, icon, documentation, and desktop integration!

Features ✨

🔥 Environment Variable Detection (95% confidence - most reliable)
🎯 FSR4 RDNA3 Hack Support - All variants (FP8, FP16, WMMA, DXIL)
🚀 Mesa Integration - Detects Mesa-based FSR implementations
📊 Real-time Monitoring - Live FSR status overlay
🎮 Game Detection - 50+ game executable patterns
🔧 7 Detection Methods - Comprehensive coverage

FSR Versions Detected 🎨

FSR Type	Color	Description
FSR3	🟢 YellowGreen	Standard FSR3
FSR4 FP8	🔴 DeepPink	8-bit precision hack
FSR4 FP16	🩷 HotPink	16-bit precision hack
FSR4 WMMA	🟣 Orchid	Wave Matrix ops workaround
FSR4 DXIL	🟪 MediumOrchid	DirectX IL translation

Requirements 📋

Linux (Wayland/X11)
GTK4 + gtk4-layer-shell
AMD GPU (RDNA2/RDNA3/RDNA4)
ImageMagick (optional - for custom icon)

For building from source only:

Rust (latest stable)

Ubuntu/Debian Dependencies

sudo apt install libgtk-4-dev libgtk4-layer-shell-dev build-essential imagemagick

Arch Linux Dependencies

sudo pacman -S gtk4 gtk4-layer-shell rust imagemagick

Fedora Dependencies

sudo dnf install gtk4-devel gtk4-layer-shell-devel rust cargo ImageMagick

Note: ImageMagick is optional but recommended for custom icon creation.

Quick Start 🚀

Recommended: Easy Installation with Desktop Integration

# Make installer executable
chmod +x install.sh

# Install with full desktop integration
./install.sh

# Launch from applications menu or run:
fsr_monitor_advanced

Alternative: Portable Use

# Make executable
chmod +x fsr_monitor_advanced

# Create desktop shortcut (optional)
./create_desktop_shortcut.sh

# Run directly
./fsr_monitor_advanced

Build from Source

# Install dependencies first (see Requirements section)

# Build with included script
./build.sh

# Or manually:
cargo build --release
./target/release/fsr_monitor_advanced

FSR4 RDNA3 Setup 🔧

To enable FSR4 on RDNA3 GPUs, set these environment variables:

For Steam Games

# Add to Steam launch options:
DXIL_SPIRV_CONFIG=wmma_rdna3_workaround FSR4_UPGRADE=1 %command%

For Wine/Proton Games

export DXIL_SPIRV_CONFIG=wmma_rdna3_workaround
export FSR4_UPGRADE=1
export RADV_FSR4_FP8=1

For Native Linux Games

RADV_FSR4_FP8=1 ./game_executable

Detection Methods 🔍

Environment Variables (95% confidence)
- DXIL_SPIRV_CONFIG=wmma_rdna3_workaround
- FSR4_UPGRADE=1
- RADV_FSR4_FP8=1
Memory Pattern Detection (85-90% confidence)
- FSR library mapping
- Mesa driver detection
Vulkan API Detection (75-80% confidence)
- VK_KHR_cooperative_matrix
- RADV driver with FSR4 support
Driver State Inspection (90-95% confidence)
- AMD debug interfaces
- GPU capability detection
Shader Cache Analysis (75-80% confidence)
- FSR shader compilation
- Cooperative matrix shaders
Graphics API Detection (70-75% confidence)
- D3D11/D3D12 with FSR
- OpenGL FSR integration
Runtime FSR State (65-80% confidence)
- Active FSR usage patterns
- Performance metrics

Supported Games 🎮

Works with 50+ game patterns including:

Cyberpunk 2077
Baldur's Gate 3
Starfield
Horizon Forbidden West
Red Dead Redemption 2
Alan Wake 2
All Steam games
Wine/Proton games

Installation & Usage 💡

1. Install FSR Monitor Advanced

# Run the installer (recommended)
./install.sh

What the installer does:

✅ Installs binary to system PATH
✅ Creates desktop application entry
✅ Installs custom FSR-themed icon
✅ Adds documentation
✅ Updates desktop database
✅ Enables right-click actions

2. Launch FSR Monitor

From Desktop:

Search "FSR Monitor Advanced" in applications
Find in Games → System → Monitor category
Right-click for quick actions

From Command Line:

fsr_monitor_advanced

3. Enable FSR4 on RDNA3 and Launch Games

# Steam launch options (recommended):
DXIL_SPIRV_CONFIG=wmma_rdna3_workaround FSR4_UPGRADE=1 %command%

# Or command line:
DXIL_SPIRV_CONFIG=wmma_rdna3_workaround FSR4_UPGRADE=1 ./game

4. Monitor Features

🔍 Real-time FSR detection
🎨 Color-coded FSR types
📊 Detection confidence levels
🔧 Multiple detection methods
⚙️ Transparency controls
📱 Desktop integration

Available Scripts 📜

Installation Scripts

install.sh - Full system installation with desktop integration
create_desktop_shortcut.sh - Portable desktop shortcut creator
create_icon.sh - Custom FSR icon generator

Build & Test Scripts

build.sh - Build from source with dependency checking
test_fsr_detection.sh - Comprehensive FSR detection test

Usage Examples

# Full installation (recommended)
./install.sh

# Create portable shortcut
./create_desktop_shortcut.sh

# Test FSR detection
./test_fsr_detection.sh

# Build from source
./build.sh

Troubleshooting 🔧

Installation Issues

Desktop entry not appearing:

# Update desktop database manually
update-desktop-database ~/.local/share/applications/

Icon not showing:

# Recreate icon and update cache
./create_icon.sh
gtk-update-icon-cache -f -t ~/.local/share/icons/hicolor/

No FSR Detected

Check if game is in supported list
Verify environment variables: env | grep FSR
Ensure Mesa 24.x+ is installed: glxinfo | grep Mesa

Permission Errors

Some detection methods require /sys/kernel/debug access
Try: sudo mount -t debugfs none /sys/kernel/debug

Build Errors

Install all dependencies (see Requirements section)
Update Rust: rustup update
Use build script: ./build.sh

Testing 🧪

Quick Test

# Run comprehensive FSR detection test
./test_fsr_detection.sh

Manual Testing

# 1. Install FSR Monitor
./install.sh

# 2. Launch FSR Monitor
fsr_monitor_advanced &

# 3. Test with environment variables
DXIL_SPIRV_CONFIG=wmma_rdna3_workaround FSR4_UPGRADE=1 sleep 60 &

# 4. Check detection
# Monitor should show FSR4 WMMA hack detected

Desktop Integration Test

# After installation, test desktop integration:
# 1. Search "FSR" in application launcher
# 2. Right-click desktop entry for actions
# 3. Check Categories: Games → System → Monitor

Technical Details 🤓

FSR4 RDNA3 Implementation

FP8 Emulation: Software emulation of 8-bit precision
WMMA Workaround: Wave Matrix Multiply Accumulate fallback
Mesa Integration: VK_KHR_cooperative_matrix support
Performance: ~20% slower than native RDNA4

Architecture

Rust: Memory-safe systems programming
GTK4: Modern UI framework
Layer Shell: Wayland overlay support
Procfs: Process inspection
Real-time: 1-second update intervals

Contributing 🤝

Fork the repository
Create feature branch
Add detection methods
Test thoroughly
Submit pull request

License 📄

MIT License - Use freely for any purpose

Support 💬

GitHub Issues: Report bugs/feature requests
Discord: Community support
Email: Technical questions

Made with ❤️ for the Linux gaming community

Enabling FSR4 on RDNA3 GPUs through the power of open source!

Name		Name	Last commit message	Last commit date
src		src
Cargo.toml		Cargo.toml
GETTING_STARTED.md		GETTING_STARTED.md
README.md		README.md
create_desktop_shortcut.sh		create_desktop_shortcut.sh
create_icon.sh		create_icon.sh
fsr-monitor-advanced.desktop		fsr-monitor-advanced.desktop
fsr_monitor_advanced		fsr_monitor_advanced
install.sh		install.sh
test_fsr_detection.sh		test_fsr_detection.sh

Latest commit

History

Folders and files

Repository files navigation