Skip to content

๐Ÿง v2.9.0: Linux Support & Cross-Platform Architecture

Choose a tag to compare

@SlonickLab SlonickLab released this 10 Apr 16:20
· 74 commits to main since this release
230b043

This is a landmark release that brings full Linux support to Smart Replay Mover! Huge thanks to @zxsleebu for the massive Pull Request (#19) that laid the foundation for this work.


โœจ What's New

  • ๐Ÿง Linux Support โ€” Smart Replay Mover now works natively on Linux (KDE Plasma, X11, and Wayland via XWayland).
  • ๐Ÿ” Linux Game Detection โ€” Uses xprop (X11) and gdbus (KWin/Wayland) to identify active windows instead of Win32 APIs.
  • ๐ŸŽฅ Linux OBS Sources โ€” Recognizes Linux-specific capture types like xcomposite_input, pipewire-window-capture-source, and xshm_input.
  • ๐Ÿ”” Linux Notifications โ€” Uses notify-send for visual popups and paplay (PulseAudio) or pw-play (PipeWire) for notification audio.
  • ๐Ÿ”‡ Quiet Sound on Linux โ€” The quiet sound toggle works natively, letting you switch between notification_sound.wav and notification_sound_silent.wav.
  • ๐Ÿ–ฅ๏ธ OS Mode Selector โ€” New dropdown in script properties: Auto-Detect, Windows, or Linux. Auto-Detect determines your OS automatically.
  • ๐Ÿ›ก๏ธ Crash Prevention โ€” Every platform-specific code path is wrapped in pcall(). The script never crashes regardless of mismatched settings (e.g. running Linux commands on Windows fails silently).
  • ๐Ÿ”ง FFI Consolidation โ€” All Windows API definitions merged into a single guarded block for maximum stability.

๐Ÿ”ง Technical Changes

  • ๐Ÿ› ๏ธ Cross-Platform Helpers โ€” Added join_path(), quote_shell_arg(), and run_shell_command() for safe, OS-aware execution.
  • ๐Ÿ“‚ File Operations โ€” get_existing_folder(), delete_file(), and get_file_size() now automatically fallback to standard Lua I/O on Linux.
  • ๐ŸŽฌ FFmpeg on Linux โ€” Runs via shell commands directly (no .bat files). Supports both ffmpeg.exe and ffmpeg with proper shell quoting and error logging.
  • ๐ŸŽฎ Steam Compatibility โ€” is_generic_steam_app_identifier() correctly ignores generic steam_app_12345 folder names on Linux, falling back to window title detection.

๐Ÿ–ฅ๏ธ Adaptive UI

  • ๐Ÿ‘๏ธ Smart Settings Menu โ€” Windows-only settings (Scan All Processes, Notification Scale/Position, Update Checker) auto-hide when Linux mode is active.
  • ๐Ÿ“ Dynamic FFmpeg Path โ€” FFmpeg path description adapts contextually (ffmpeg.exe on Windows โ†’ /usr/bin/ffmpeg on Linux).
  • ๐Ÿ—‚๏ธ Reorganized Tools โ€” OS Mode Selector moved to Tools & Debug group so it doesn't displace update buttons.

๐Ÿ’ก For Linux Users:

  1. Install OBS Studio via your package manager.
  2. Add the script in OBS โ†’ Tools โ†’ Scripts.
  3. The script auto-detects Linux โ€” no configuration needed!
  4. Optional dependencies: notify-send (notifications), paplay or pw-play (sound).
  5. For X11: xprop should be installed (usually included with xorg-xprop).
  6. For KDE Plasma: gdbus is used automatically for window detection on Wayland.