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 فراهم آورد.

       در نتیجه، کلاینت‌ها:
       •   دیگر نیازی به نصب بودن Steam یا فایل‌های اجرایی باینری Steam ندارند
       •   می‌توانند در توسعهٔ protonfixes مشارکت کرده و به‌طور خودکار از آن
           بهره‌مند شوند
       •   می‌توانند بازی‌ها را از طریق Proton طوری اجرا کنند که گویی یک بازی
           بومی Steam است
       •   می‌توانند به یک پایگاه داده برخط و یکپارچه از رفع اشکال‌های بازی
           (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)