umu(1)                      General Commands Manual                     umu(1)

<?><?><?> (NAME)
       umu-run - <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?>

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       umu-run [FILE]

       umu-run [FILE [ARG...]]

       umu-run [winetricks [ARG...]]

       umu-run --config [FILE]

       umu-run --help

<?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> (POSITIONAL ARGUMENTS)
       winetricks
           <?><?><?><?><?> <?><?><?><?><?><?><?><?> (verbs) winetricks[1]
           (<?><?><?><?><?><?><?> GE-Proton <?><?> UMU-Proton <?><?><?>).

           <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> winetricks(1)
           <?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>
           <?><?><?> <?><?> <?><?><?><?><?><?>.

<?><?><?><?><?><?><?><?> (OPTIONS)
       -h, --help
           <?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?>.

       --config <config>
           <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> TOML
           (<?><?><?><?><?><?><?> Python 3.11+ <?><?><?>).

           <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?>
           <?><?><?><?><?><?><?> umu(5) <?><?> <?><?><?><?><?><?>.

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
       (umu) <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?> <?><?> <?><?><?><?><?> Proton[2] <?><?><?><?> Valve <?>
       <?><?><?><?><?><?> protonfixes[3] <?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?> Steam <?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?> <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?> (<?><?><?><?><?> Lutris<?>
       Heroic Games Launcher<?> Bottles <?><?> Rare) <?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?> Proton <?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> WINE
       <?><?><?><?><?> <?><?><?><?>.

       <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>:
       o   <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?> Steam
           <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?> Steam <?><?><?><?><?><?>
       o   <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> protonfixes
           <?><?><?><?><?><?> <?><?><?><?> <?> <?><?><?><?><?><?>
           <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?>
       o   <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?>
           <?><?><?><?> Proton <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?>
           <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> Steam <?><?><?>
       o   <?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?>
           <?><?><?><?> <?><?><?><?> <?> <?><?><?><?><?><?><?> <?><?>
           <?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?> (protonfixes)
           <?><?><?><?><?> <?><?><?><?>

       <?><?><?><?><?><?><?><?><?> umu <?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?>.

<?><?><?><?><?><?><?> (EXAMPLES)
       <?><?><?><?> <?>. <?><?><?><?><?> <?><?> <?><?><?><?>

           $ WINEPREFIX=~/.wine PROTONPATH=~/GE-Proton9-4 umu-run foo.exe

       <?><?><?><?> <?>. <?><?><?><?><?> <?><?> <?><?><?><?> <?>
       <?><?><?><?><?> <?><?> protonfix <?><?><?><?>

           # Applies the Star Citizen fix to the current WINE prefix
           $ WINEPREFIX=~/.wine GAMEID=umu-starcitizen PROTONPATH=~/GE-Proton9-4 umu-run foo.exe

       <?><?><?><?> <?>. <?><?><?><?><?> <?><?> <?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>

           # config.toml
           [umu]
           prefix = "~/.wine"
           proton = "~/GE-Proton30"
           game_id = "0"
           exe = "~/foo.exe"
           launch_args = ["-opengl", "-SkipBuildPatchPrereq"]
           store = "gog"
           $ umu-run --config config.toml

       <?><?><?><?> <?>. <?><?><?><?><?> <?><?> <?><?><?><?><?><?> WINE
       <?><?><?><?> umu

           $ WINEPREFIX=~/foo PROTONPATH=~/GE-Proton9-4 umu-run ""

       <?><?><?><?> <?>. <?><?><?><?><?> <?><?> <?><?><?><?> <?>
       <?><?><?><?><?> <?><?><?><?><?><?> Proton

           # Uses the latest UMU-Proton and automatically removes old UMU-Proton builds
           $ WINEPREFIX=~/.wine umu-run foo.exe

       <?><?><?><?> <?>. <?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> Proton <?> <?><?><?><?><?>
       <?><?><?><?><?><?> WINE

           # Creates the prefix as $HOME/Games/umu/umu-default and uses the latest UMU-Proton
           $ umu-run foo.exe

       <?><?><?><?> <?>. <?><?><?><?><?> <?><?> <?><?><?><?> <?>
       <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
       Proton

           $ WINEPREFIX=~/.wine GAMEID=0 PROTONPATH=~/GE-Proton9-4 PROTON_VERB=waitforexitandrun umu-run foo.exe

       <?><?><?><?> <?>. <?><?><?><?><?> <?><?> <?><?><?><?> <?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?>

           $ UMU_LOG=debug WINEPREFIX=~/.wine PROTONPATH=~/GE-Proton9-4 umu-run foo.exe

       <?><?><?><?> <?>. <?><?><?><?><?> <?><?> <?><?><?><?> <?>
       <?><?><?><?><?> Proton <?><?> <?><?><?> <?><?><?><?><?> <?><?>

           # Checks for GE-Proton9-1 at $HOME/.local/share/Steam/compatibilitytools.d
           $ WINEPREFIX=~/.wine PROTONPATH=GE-Proton9-1 umu-run foo.exe

       <?><?><?><?> <?><?>. <?><?><?><?><?> <?><?> <?><?><?><?> <?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> GE-Proton

           $ WINEPREFIX=~/.wine PROTONPATH=GE-Proton umu-run foo.exe

       <?><?><?><?> <?><?>. <?><?><?><?><?> <?><?><?><?><?><?><?> winetricks

           $ PROTONPATH=GE-Proton umu-run winetricks quartz wmp11 qasf

       <?><?><?><?> <?><?>. <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> protonfixes

           $ GAMEID=umu-genshin PROTONPATH=GE-Proton PROTONFIXES_DISABLE=1 umu-run foo.exe

<?><?><?><?><?><?><?><?> <?><?><?><?><?> (ENVIRONMENT VARIABLES)
       GAMEID
           <?><?><?><?><?><?><?>. <?><?><?><?><?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?>
           <?><?><?><?><?> <?><?> umu-database[4] <?><?><?><?>. <?><?>
           <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> umu-default <?><?><?>
           (<?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>).

       PROTONPATH
           <?><?><?><?><?><?><?>. <?><?><?><?> <?><?><?><?><?><?><?><?><?>
           Proton<?> <?><?><?> <?><?><?><?><?> (<?><?><?><?><?> GE-Proton9-5)
           <?><?> <?><?><?> <?><?><?> (<?><?><?><?><?> GE-Proton).

           <?><?> <?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?> UMU-Proton <?><?><?><?><?><?><?>
           <?><?><?><?><?><?>.

           <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?>: GE-Proton

       WINEPREFIX
           <?><?><?><?><?><?><?>. <?><?><?><?> <?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?> WINE. <?><?> <?><?><?> <?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?> $HOME/Games/umu/$GAMEID <?><?><?><?><?>
           <?><?><?>. <?><?><?> <?><?><?> GAMEID <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
           $HOME/Games/umu/umu-default <?><?><?>.

       UMU_LOG
           <?><?><?><?><?><?><?>. <?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>.

           <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?>
           1 <?><?><?><?> <?><?><?><?>.

       STORE
           <?><?><?><?><?><?><?>. <?><?><?><?><?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> umu-database
           <?><?><?><?>.

       PROTON_VERB
           <?><?><?><?><?><?><?>. <?><?><?><?> <?><?>
           <?><?><?>/<?><?><?><?><?> (verb) <?><?><?><?><?> <?><?> Proton
           <?><?><?><?>. <?><?> <?><?><?> <?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
           waitforexitandrun <?><?><?>.

       UMU_RUNTIME_UPDATE
           <?><?><?><?><?><?><?>.
           <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
           Steam Linux Runtime[5] <?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?><?>.

           <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
           <?><?> <?><?><?><?><?> <?><?> 0 <?><?><?><?> <?><?><?><?>.

       UMU_NO_PROTON
           <?><?><?><?><?><?><?>. <?><?><?><?> <?><?><?><?><?><?> <?><?>
           <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> Steam Linux Runtime
           <?><?><?><?> <?><?><?><?><?><?>. <?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
           <?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?>.

           <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> SLR<?>
           <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?> 1 <?><?><?><?>
           <?><?><?><?>.

       UMU_HTTP_TIMEOUT
           <?><?><?><?><?><?><?>. <?><?><?><?> <?><?><?><?><?> <?><?>
           <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?><?><?> HTTP <?><?><?><?><?> <?><?><?><?><?><?>.
           <?><?> <?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> 5
           <?><?><?>.

           <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> HTTP<?>
           <?><?><?><?><?> <?><?> 0 <?><?><?><?> <?><?><?><?>. <?><?><?><?>
           <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?>
           <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>.

       UMU_HTTP_RETRIES
           <?><?><?><?><?><?><?>. <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?> <?><?><?><?>. <?><?> <?><?><?> <?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?> 3 <?><?><?>.

           <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> HTTP<?>
           <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?> 0 <?><?><?><?>
           <?><?><?><?>. <?><?><?><?> <?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?><?><?>.

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       umu(5), winetricks(1)

<?><?><?><?> (NOTES)
       1.  https://github.com/Winetricks/winetricks
       2.  https://github.com/ValveSoftware/Proton
       3.  https://github.com/Open-Wine-Components/umu-protonfixes
       4.  https://github.com/Open-Wine-Components/umu-database
       5.  https://gitlab.steamos.cloud/steamrt/steam-runtime-tools/-/blob/main/docs/container-runtime.md

<?><?><?><?><?><?><?><?><?> (AUTHORS)
       <?><?><?><?> <?><?><?><?><?> Open Wine Components <?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?> <?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>.
       <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?> umu<?> <?><?>
       https://github.com/Open-Wine-Components/umu-launcher <?><?><?><?><?><?>
       <?><?><?><?>.

                                  2026-07-25                            umu(1)