.\" generated by cd2nroff 0.1 from wcurl.md
.TH wcurl 1 "2026-09-02" wcurl
.SH "نام (NAME)"
wcurl \- پوسته ساده و سبک برای دانلود فایلها با curl
.SH "خلاصه دستور (SYNOPSIS)"
\fBwcurl <URL>...\fP

\fBwcurl [\--curl\-options <CURL_OPTIONS>]... [\--dry\-run] [\--no\-decode\-filename] [\-o|\-O|\--output <PATH>] [\--] <URL>...\fP

\fBwcurl [\--curl\-options=<CURL_OPTIONS>]... [\--dry\-run] [\--no\-decode\-filename] [\--output=<PATH>] [\--] <URL>...\fP

\fBwcurl \-V|\--version\fP

\fBwcurl \-h|\--help\fP
.SH "توضیحات (DESCRIPTION)"
\fBwcurl\fP یک پوسته ساده برای curl است که به شما امکان می‌دهد بدون نیاز به حفظ کردن پارامترها، فایل‌ها را با استفاده از curl دانلود کنید.

اجرای \fBwcurl\fP همراه با فهرستی از نشانی‌های اینترنتی (URL) که قصد دانلود آن‌ها را دارید، باعث می‌شود \fBwcurl\fP مقادیر پیش‌فرض مناسب و معقولی را انتخاب کند.

اگر به تنظیمات پیچیده‌تری نیاز دارید، می‌توانید هر یک از پارامترهای پشتیبانی‌شده توسط curl را از طریق گزینه \fB\--curl\-options\fP مشخص کنید. توجه داشته باشید که اگر مورد کاربرد شما با این ابزار پوشش داده نمی‌شود، احتمالاً بهتر است مستقیماً از curl استفاده نمایید.

به‌طور پیش‌فرض، \fBwcurl\fP اقدامات زیر را انجام می‌دهد:
.IP "* نویسه‌های فاصله خالی را در URLها با استفاده از Percent-encode کدگذاری می‌کند؛"
.IP "* چندین URL را به‌صورت موازی دانلود می‌کند"
.nf
اگر نسخه curl نصب‌شده 7.66.0 یا بالاتر باشد (\-\-parallel)؛
.fi
.IP "* در مجموع از ۵ اتصال موازی به یک مقصد مشترک (پروتکل + نام میزبان + شماره پورت) استفاده می‌کند"
.nf
اگر نسخه curl نصب‌شده 8.16.0 یا بالاتر باشد (\-\-parallel\-max\-host)؛
.fi
.IP "* تغییر مسیرها (Redirects) را دنبال می‌کند؛"
.IP "* به‌طور خودکار نامی را برای فایل خروجی انتخاب می‌کند؛"
.IP "* از بازنویسی (Overwrite) فایل‌ها جلوگیری می‌کند"
.nf
اگر نسخه curl نصب‌شده 7.83.0 یا بالاتر باشد (\-\-no\-clobber)؛
.fi
.IP "* عملیات بارگیری مجدد در صورت خطا (Retries) را انجام می‌دهد؛"
.IP "* مهر زمانی (Timestamp) فایل دانلودشده را"
.nf
در صورت در دسترس بودن، به مقداری که سرور ارائه داده تنظیم می‌کند؛
.fi
.IP "* پروتکل https را به‌طور پیش‌فرض در نظر می‌گیرد"
.nf
اگر URL فاقد هرگونه طرح‌واره (Scheme) باشد؛
.fi
.IP "* تحلیل‌گر تطبیق الگو (Globbing) را در curl غیرفعال می‌کند"
.nf
تا با نویسه‌های {} و [] در URLها به‌صورت ویژه برخورد نشود؛
.fi
.IP "* نام فایل به‌دست‌آمده را Percent-decode می‌کند؛"
.IP "* از 'index.html' به‌عنوان نام فایل پیش‌فرض استفاده می‌کند"
.nf
اگر نامی در URL وجود نداشته باشد.
.fi
.SH "گزینهها (OPTIONS)"
.IP "--curl-options, --curl-options=\<CURL_OPTIONS\>..."
گزینه‌های اضافی را برای ارسال به curl هنگام فراخوانی مشخص می‌کند. این گزینه می‌تواند بیش از یک‌بار تعیین شود.
.IP "-o, -O, --output, --output=\<PATH\>"
استفاده از مسیر خروجی ارائه‌شده به‌جای استخراج آن از نشانی اینترنتی (URL). اگر چندین URL ارائه شده باشد، فایل‌های حاصل نام مشترکی خواهند داشت که یک عدد به انتهای آن‌ها اضافه می‌شود (curl >= 7.83.0). اگر این گزینه چندین‌بار مشخص شود، فقط آخرین مقدار در نظر گرفته خواهد شد.
.IP --no-decode-filename
نام فایل خروجی را با استفاده از درصدزدایی (Percent\-decode) رمزگشایی نکن، حتی اگر کدگذاری درصدی در نشانی اینترنتی توسط خود \fBwcurl\fP انجام شده باشد؛ مانند زمانی که نشانی اینترنتی حاوی فاصله خالی بوده است.
.IP --dry-run
دستور curl را عملاً اجرا نکن، بلکه دستوری را که قرار بود فراخوانی شود چاپ کن.
.IP "-V, \--version"
چاپ اطلاعات نسخه برنامه.
.IP "-h, \--help"
چاپ پیام راهنما.
.SH "گزینه‌های CURL (CURL_OPTIONS)"
هر گزینه‌ای که توسط curl پشتیبانی می‌شود را می‌توان در اینجا تنظیم کرد. این گزینه‌ها مستقیماً توسط \fBwcurl\fP پردازش نمی‌شوند؛ بلکه به فراخوانی نهایی curl منتقل می‌گردند.
.SH "نشانی اینترنتی (URL)"
نشانی اینترنتی (URL) که باید دانلود شود. هر چیزی که پارامتر نباشد، یک URL در نظر گرفته می‌شود. فاصله‌های خالی کدگذاری درصدی (Percent\-encode) می‌شوند و نشانی به curl فرستاده می‌شود که سپس پردازش و تحلیل آن را انجام می‌دهد. این مورد می‌تواند بیش از یک‌بار مشخص شود.
.SH "مثال‌ها (EXAMPLES)"
دانلود یک فایل منفرد:

\fBwcurl example.com/filename.txt\fP

دانلود دو فایل به‌صورت موازی:

\fBwcurl example.com/filename1.txt example.com/filename2.txt\fP

دانلود یک فایل با ارسال فلگ‌های \fB\--progress\-bar\fP و \fB\--http2\fP به curl:

\fBwcurl \--curl\-options="\--progress\-bar \--http2" example.com/filename.txt\fP

ادامه دانلود یک فایل متوقف‌شده (Resume). گزینه‌های موردنیاز برای ادامه دانلود
(\fI\--clobber \--continue\-at \-\fP) باید \fBآخرین\fP گزینه‌های مشخص‌شده در \fI\--curl\-options\fP باشند.
توجه داشته باشید که تنها راه برای ادامه دانلود فایل‌های متوقف‌شده این است که به wcurl اجازه بازنویسی فایل مقصد داده شود:

\fBwcurl \--curl\-options="\--clobber \--continue\-at \-" example.com/filename.txt\fP

دانلود چندین فایل بدون محدودیت در تعداد اتصالات هم‌زمان به هر میزبان (محدودیت پیش‌فرض ۵ است):

\fBwcurl \--curl\-options="\--parallel\-max\-host 0" example.com/filename1.txt example.com/filename2.txt\fP
.SH "نویسندگان (AUTHORS)"
.nf
Samuel Henrique \<samueloph@debian.org\>
Sergio Durigan Junior \<sergiodj@debian.org\>
و بسیاری از مشارکت‌کنندگان، فایل AUTHORS را ببینید.
.fi
.SH "گزارش باگ‌ها (REPORTING BUGS)"
اگر با هرگونه مشکلی در \fBwcurl\fP مواجه شدید که در curl با آن روبرو نمی‌شوید، یک گزارش اشکال در گیت‌هاب ارسال کنید:
https://github.com/curl/wcurl
.SH "حق نشر (COPYRIGHT)"
\fBwcurl\fP تحت مجوز curl منتشر شده است.
.SH "همچنین ببینید (SEE ALSO)"
.BR curl (1),
.BR trurl (1)