claude-home/gaming/examples/ready-or-not
Cal Corum edc78c2dd6 CLAUDE: Add comprehensive gaming-aware Tdarr management system
- Created complete gaming detection and priority system
- Added gaming schedule configuration and enforcement
- Implemented Steam library monitoring with auto-detection
- Built comprehensive game process detection for multiple platforms
- Added gaming-aware Tdarr worker management with priority controls
- Created emergency gaming mode for immediate worker shutdown
- Integrated Discord notifications for gaming state changes
- Replaced old bash monitoring with enhanced Python monitoring system
- Added persistent state management and memory tracking
- Implemented configurable gaming time windows and schedules
- Updated .gitignore to exclude logs directories

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-08-14 15:17:52 -05:00
..
1144200-nvidia-1440p.conf CLAUDE: Add comprehensive gaming-aware Tdarr management system 2025-08-14 15:17:52 -05:00
1144200-working.conf CLAUDE: Add comprehensive gaming-aware Tdarr management system 2025-08-14 15:17:52 -05:00
fix-crash.sh CLAUDE: Add comprehensive gaming-aware Tdarr management system 2025-08-14 15:17:52 -05:00
force-stl-detection.sh CLAUDE: Add comprehensive gaming-aware Tdarr management system 2025-08-14 15:17:52 -05:00
nvidia-environment.conf CLAUDE: Add comprehensive gaming-aware Tdarr management system 2025-08-14 15:17:52 -05:00
README.md CLAUDE: Add comprehensive gaming-aware Tdarr management system 2025-08-14 15:17:52 -05:00
setup-ready-or-not.sh CLAUDE: Add comprehensive gaming-aware Tdarr management system 2025-08-14 15:17:52 -05:00
working-baseline-config.md CLAUDE: Add comprehensive gaming-aware Tdarr management system 2025-08-14 15:17:52 -05:00

Ready or Not - NVIDIA Gaming Setup

Overview

This configuration is optimized for:

  • NVIDIA GPU (adapted from AMD config)
  • 4K Monitor with 1440p Gaming (performance optimization)
  • Steam Tinker Launch with GameScope scaling
  • DLSS Support for enhanced performance

Key Changes from AMD Config

GPU-Specific Changes

Setting AMD (Original) NVIDIA (Adapted) Reason
VK_ICD_FILENAMES RADV driver paths NVIDIA driver path GPU driver selection
PROTON_HIDE_NVIDIA_GPU Not applicable "0" (disabled) Allow DLSS detection
PROTON_ENABLE_NVAPI Not applicable "1" (enabled) Enable NVIDIA APIs
USEDLSS Not applicable "1" (enabled) DLSS support
STLRAD_PFTST AMD-specific flags "none" Remove AMD optimizations

Display Configuration

Setting Original Adapted Reason
Resolution 3440x1440 @ 240Hz 2560x1440 @ 165Hz Better performance on 4K monitor
GameScope Args Ultrawide focus Standard 16:9 + scaling 4K monitor compatibility
Audio Latency 120ms 60ms NVIDIA typically has lower latency

Performance Optimizations

  • DXVK Async: Enabled for NVIDIA shader optimization
  • HDR Support: Enabled for compatible setups
  • Memory Management: Optimized for NVIDIA VRAM handling
  • GameScope: Configured for 1440p→4K scaling

Files Included

1144200-nvidia-1440p.conf

Main Steam Tinker Launch configuration file. Copy to ~/.config/steamtinkerlaunch/gamecfgs/1144200.conf.

Key Features:

  • Game arguments: -noeac -USEALLAVAILABLECORES -dx12
  • GameScope: 1440p gaming with 4K scaling
  • DLSS and NVAPI enabled
  • Optimized audio latency (60ms)

nvidia-environment.conf

Environment variables for NVIDIA optimization. Reference for manual setup.

setup-ready-or-not.sh

Automated setup script that:

  • Checks dependencies (STL, GameScope, NVIDIA drivers)
  • Backs up existing configurations
  • Installs optimized config files
  • Creates DXVK configuration
  • Sets up launch helper script

Quick Setup

1. Run the Setup Script

cd /mnt/NV2/Development/claude-home/gaming/examples/ready-or-not/
./setup-ready-or-not.sh

2. Verify Steam Tinker Launch

  • Open Steam
  • Go to Ready or Not → Properties → Launch Options
  • Leave empty or add %command% if needed
  • STL should automatically detect the game configuration

3. Test Launch

# Option 1: Use the helper script
~/.local/bin/launch-ready-or-not

# Option 2: Launch through Steam normally
# STL will automatically apply the configuration

Expected Performance

With This Configuration

  • Resolution: 1440p gaming scaled to 4K display
  • Performance: 60-120+ FPS depending on settings
  • Features: DLSS enabled, HDR support, optimized audio
  • Compatibility: EasyAntiCheat disabled (offline/modded play)

Performance vs Quality Settings

Game Setting Expected FPS Notes
Ultra + DLSS Quality 60-80 FPS Best visual quality
High + DLSS Balanced 80-100 FPS Good balance
Medium + DLSS Performance 100-120+ FPS Competitive gaming

Troubleshooting

Game Won't Launch

  1. Check Steam Tinker Launch is installed and working
  2. Verify NVIDIA drivers: nvidia-smi
  3. Test without STL first (disable in Steam properties)
  4. Check logs: ~/.config/steamtinkerlaunch/logs/

Poor Performance

  1. Verify DLSS is enabled in-game settings
  2. Check GameScope is working: look for scaling indicator
  3. Monitor GPU usage: watch nvidia-smi
  4. Try disabling GameScope temporarily (USEGAMESCOPE="0")

Display Issues

  1. Verify monitor resolution: xrandr
  2. Test different GameScope refresh rates
  3. Try windowed mode first, then fullscreen
  4. Check HDR settings if applicable

Audio Problems

  1. Increase latency: Change STL_PULSE_LATENCY_MSEC to "120"
  2. Check PipeWire configuration
  3. Test with different audio devices
  4. Disable audio enhancements in game

Advanced Configuration

Custom Monitor Refresh Rates

Edit the GameScope arguments in 1144200.conf:

# For 144Hz monitors
GAMESCOPE_ARGS="-W 2560 -H 1440 -w 2560 -h 1440 -r 144 -f --immediate-flips --rt --mangoapp --force-grab-cursor --adaptive-sync --"

# For 120Hz monitors  
GAMESCOPE_ARGS="-W 2560 -H 1440 -w 2560 -h 1440 -r 120 -f --immediate-flips --rt --mangoapp --force-grab-cursor --adaptive-sync --"

DLSS Quality Settings

In-game DLSS options will be available with this configuration:

  • DLSS Quality: Best visual quality, ~20% performance boost
  • DLSS Balanced: Good balance, ~30% performance boost
  • DLSS Performance: Maximum FPS, ~50% performance boost
  • DLSS Ultra Performance: Competitive gaming, ~100% performance boost

Ray Tracing (Experimental)

To enable ray tracing support:

# In the config file
USERAYTRACING="1"
STL_VKD3D_CONFIG="dxr11"

Note: Ray tracing requires RTX series GPUs and may significantly impact performance.

File Backup Locations

The setup script automatically creates backups:

  • Config backup: ~/.config/steamtinkerlaunch/gamecfgs/1144200.conf.backup.[timestamp]
  • Logs: ~/.config/steamtinkerlaunch/logs/
  • DXVK cache: /tmp/dxvk-cache/

Integration with Home Lab

This gaming setup integrates with your existing infrastructure:

  • Monitoring: MangoHUD provides performance metrics
  • Logging: STL logs are available for troubleshooting
  • Scripts: Helper scripts follow your existing patterns
  • Documentation: Follows your established documentation structure