.\" Generated by scdoc 1.11.5
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "umu" "1" "2026\-07\-25"
.PP
.SH "نام (NAME)"
.PP
umu\-run \- راه‌انداز یکپارچه برای بازی‌های ویندوز در لینوکس
.PP
.SH "خلاصه دستور (SYNOPSIS)"
.PP
\fBumu\-run\fR [\fIFILE\fR]
.PP
\fBumu\-run\fR [\fIFILE\fR [\fIARG\fR.\&.\&.\&]]
.PP
\fBumu\-run\fR [\fIwinetricks\fR [\fIARG\fR.\&.\&.\&]]
.PP
\fBumu\-run\fR \fB\-\-config\fR [\fIFILE\fR]
.PP
\fBumu\-run\fR \fB\-\-help\fR
.PP
.SH "آرگومان‌های مکانی (POSITIONAL ARGUMENTS)"
.PP
\fBwinetricks\fR
.RS 4
اجرای دستورهای (verbs) \fBwinetricks\fR[1] (نیازمند GE\-Proton یا UMU\-Proton است).\&
.PP
برای اطلاعات بیشتر \fBwinetricks\fR(1) یا برای مشاهدهٔ مثال، بخش زیر را ببینید.\&
.PP
.RE
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-h, \-\-help\fR
.RS 4
نمایش این پیام راهنما.\&
.PP
.RE
\fB\-\-config\fR <config>
.RS 4
مسیر فایل پیکربندی TOML (نیازمند Python 3.\&11+ است).\&
.PP
برای اطلاعات بیشتر و مثال‌ها \fBumu\fR(5) را ببینید.\&
.PP
.RE
.SH "توضیحات (DESCRIPTION)"
.PP
راه‌انداز یکپارچه برای بازی‌های ویندوز در لینوکس (umu) به این منظور ایجاد شده است تا ابزار \fBProton\fR[2] شرکت Valve و پروژهٔ \fBprotonfixes\fR[3] را خارج از کلاینت Steam در دسترس قرار دهد، و روشی استاندارد برای سایر کلاینت‌ها (مانند Lutris، Heroic Games Launcher، Bottles یا Rare) به‌منظور اجرای بازی‌ها از طریق Proton و پیکربندی پیشوندهای WINE فراهم آورد.\&
.PP
در نتیجه، کلاینت‌ها:
.PD 0
.IP \(bu 4
دیگر نیازی به نصب بودن Steam یا فایل‌های اجرایی باینری Steam ندارند
.IP \(bu 4
می‌توانند در توسعهٔ protonfixes مشارکت کرده و به‌طور خودکار از آن بهره‌مند شوند
.IP \(bu 4
می‌توانند بازی‌ها را از طریق Proton طوری اجرا کنند که گویی یک بازی بومی Steam است
.IP \(bu 4
می‌توانند به یک پایگاه داده برخط و یکپارچه از رفع اشکال‌های بازی (protonfixes) ارجاع دهند
.PD
.PP
می‌توانید umu را مستقیماً از یک شبیه‌ساز ترمینال یا در صورت پشتیبانی، از طریق راه‌انداز دلخواه خود اجرا کنید.\&
.PP
.SH "مثال‌ها (EXAMPLES)"
.PP
\fBمثال ۱.\& اجرای یک بازی\fR
.PP
.nf
.RS 4
$ WINEPREFIX=~/\&.wine PROTONPATH=~/GE\-Proton9\-4 umu\-run foo\&.exe
.fi
.RE
.PP
\fBمثال ۲.\& اجرای یک بازی و اعمال یک protonfix مشخص\fR
.PP
.nf
.RS 4
# Applies the Star Citizen fix to the current WINE prefix
$ WINEPREFIX=~/\&.wine GAMEID=umu\-starcitizen PROTONPATH=~/GE\-Proton9\-4 umu\-run foo\&.exe
.fi
.RE
.PP
\fBمثال ۳.\& اجرای یک بازی از طریق فایل پیکربندی\fR
.PP
.nf
.RS 4
# 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
.fi
.RE
.PP
\fBمثال ۴.\& ایجاد یک پیشوند WINE برای umu\fR
.PP
.nf
.RS 4
$ WINEPREFIX=~/foo PROTONPATH=~/GE\-Proton9\-4 umu\-run ""
.fi
.RE
.PP
\fBمثال ۵.\& اجرای یک بازی و تنظیم خودکار Proton\fR
.PP
.nf
.RS 4
# Uses the latest UMU\-Proton and automatically removes old UMU\-Proton builds
$ WINEPREFIX=~/\&.wine umu\-run foo\&.exe
.fi
.RE
.PP
\fBمثال ۶.\& اجرای یک بازی، تنظیم خودکار Proton و ایجاد پیشوند WINE\fR
.PP
.nf
.RS 4
# Creates the prefix as $HOME/Games/umu/umu\-default and uses the latest UMU\-Proton
$ umu\-run foo\&.exe
.fi
.RE
.PP
\fBمثال ۷.\& اجرای یک بازی و تعیین صریح یک دستور معتبر Proton\fR
.PP
.nf
.RS 4
$ WINEPREFIX=~/\&.wine GAMEID=0 PROTONPATH=~/GE\-Proton9\-4 PROTON_VERB=waitforexitandrun umu\-run foo\&.exe
.fi
.RE
.PP
\fBمثال ۸.\& اجرای یک بازی و فعال‌سازی لاگ‌های اشکال‌زدایی\fR
.PP
.nf
.RS 4
$ UMU_LOG=debug WINEPREFIX=~/\&.wine PROTONPATH=~/GE\-Proton9\-4 umu\-run foo\&.exe
.fi
.RE
.PP
\fBمثال ۹.\& اجرای یک بازی و تعیین Proton با نام نگارش آن\fR
.PP
.nf
.RS 4
# Checks for GE\-Proton9\-1 at $HOME/\&.local/share/Steam/compatibilitytools\&.d
$ WINEPREFIX=~/\&.wine PROTONPATH=GE\-Proton9\-1 umu\-run foo\&.exe
.fi
.RE
.PP
\fBمثال ۱۰.\& اجرای یک بازی و استفادهٔ خودکار از جدیدترین GE\-Proton\fR
.PP
.nf
.RS 4
$ WINEPREFIX=~/\&.wine PROTONPATH=GE\-Proton umu\-run foo\&.exe
.fi
.RE
.PP
\fBمثال ۱۱.\& اجرای دستورات winetricks\fR
.PP
.nf
.RS 4
$ PROTONPATH=GE\-Proton umu\-run winetricks quartz wmp11 qasf
.fi
.RE
.PP
\fBمثال ۱۲.\& اجرای یک بازی بدون اعمال protonfixes\fR
.PP
.nf
.RS 4
$ GAMEID=umu\-genshin PROTONPATH=GE\-Proton PROTONFIXES_DISABLE=1 umu\-run foo\&.exe
.fi
.RE
.PP
.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
.PP
\fIGAMEID\fR
.RS 4
اختیاری.\& می‌تواند یک مقدار دلخواه یا یک شناسهٔ معتبر در \fBumu\-database\fR[4] باشد.\&
در صورت تعیین‌نشدن، به‌طور پیش‌فرض برابر با \fIumu\-default\fR است (هیچ وصله‌ای را به‌طور خودکار اعمال نمی‌کند).\&
.PP
.RE
\fIPROTONPATH\fR
.RS 4
اختیاری.\& مسیر دایرکتوری Proton، نام نگارش (مانند GE\-Proton9\-5) یا
نام رمز (مانند GE\-Proton).\&
.PP
در غیر این صورت، به‌طور پیش‌فرض از UMU\-Proton استفاده می‌شود.\&
.PP
نام‌های رمز معتبر عبارتند از: \fIGE\-Proton\fR
.PP
.RE
\fIWINEPREFIX\fR
.RS 4
اختیاری.\& مسیر دایرکتوری پیشوند WINE.\& در غیر این صورت، پیش‌فرض \fI$HOME/Games/umu/$GAMEID\fR خواهد بود.\&
اگر هیچ \fIGAMEID\fR مشخص نشده باشد، پیش‌فرض برابر با \fI$HOME/Games/umu/umu\-default\fR است.\&
.PP
.RE
\fIUMU_LOG\fR
.RS 4
اختیاری.\& لاگ‌های اشکال‌زدایی را برای راه‌انداز فعال می‌کند.\&
.PP
.PP
برای فعال‌سازی همهٔ لاگ‌ها، مقدار را برابر با \fI1\fR قرار دهید.\&
.PP
.RE
\fISTORE\fR
.RS 4
اختیاری.\& می‌تواند یک مقدار دلخواه یا یک شناسهٔ معتبر فروشگاه در umu\-database باشد.\&
.PP
.RE
\fIPROTON_VERB\fR
.RS 4
اختیاری.\& باید یک فعل/دستور (verb) معتبر در Proton باشد.\& در غیر این صورت، به‌طور پیش‌فرض برابر با \fIwaitforexitandrun\fR است.\&
.PP
.RE
\fIUMU_RUNTIME_UPDATE\fR
.RS 4
اختیاری.\& به‌روزرسانی‌های خودکار \fBSteam Linux Runtime\fR[5] را غیرفعال می‌کند.\&
.PP
برای غیرفعال‌سازی به‌روزرسانی‌ها، مقدار را برابر با \fI0\fR قرار دهید.\&
.PP
.RE
\fIUMU_NO_PROTON\fR
.RS 4
اختیاری.\& فایل اجرایی را به‌صورت بومی درون Steam Linux Runtime اجرا می‌کند.\& برای بازی‌های بومی لینوکس در نظر گرفته شده است.\&
.PP
برای اجرای فایل اجرایی به‌صورت بومی درون SLR، مقدار را برابر با \fI1\fR قرار دهید.\&
.PP
.RE
\fIUMU_HTTP_TIMEOUT\fR
.RS 4
اختیاری.\& مهلت زمانی بر حسب ثانیه را برای هر درخواست HTTP تعیین می‌کند.\& در غیر این صورت، پیش‌فرض \fI5\fR است.\&
.PP
برای غیرفعال کردن مهلت زمانی درخواست‌های HTTP، مقدار را \fI0\fR قرار دهید.\& برای لغو مقدار پیش‌فرض، یک عدد صحیح مثبت تعیین کنید.\&
.PP
.RE
\fIUMU_HTTP_RETRIES\fR
.RS 4
اختیاری.\& تعداد دفعات تلاش مجدد برای خطاهای احتمالی کاذب شبکه.\& در غیر این صورت، پیش‌فرض \fI3\fR است.\&
.PP
برای غیرفعال‌سازی تلاش مجدد درخواست‌های HTTP، مقدار را برابر با \fI0\fR قرار دهید.\& برای لغو مقدار پیش‌فرض، یک عدد صحیح مثبت تعیین کنید.\&
.PP
.RE
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fIumu\fR(5), \fIwinetricks\fR(1)
.PP
.SH "نکات (NOTES)"
.PP
.PD 0
.IP 1. 4
https://github.\&com/Winetricks/winetricks
.IP 2. 4
https://github.\&com/ValveSoftware/Proton
.IP 3. 4
https://github.\&com/Open\-Wine\-Components/umu\-protonfixes
.IP 4. 4
https://github.\&com/Open\-Wine\-Components/umu\-database
.IP 5. 4
https://gitlab.\&steamos.\&cloud/steamrt/steam\-runtime\-tools/\-/blob/main/docs/container\-runtime.\&md
.PD
.PP
.SH "نویسندگان (AUTHORS)"
.PP
توسط اعضای Open Wine Components نگهداری می‌شود و سایر مشارکت‌کنندگان متن‌باز نیز در آن همکاری داشته‌اند.\& برای کسب اطلاعات بیشتر دربارهٔ توسعهٔ umu، به https://github.\&com/Open\-Wine\-Components/umu\-launcher مراجعه کنید.\&