.TH VHS 1 "2026-03-10" "vhs" "اجرای یک فایل tape مشخص و تولید خروجی‌های آن"
.SH "نام (NAME)"
vhs \- اجرای یک فایل tape مشخص و تولید خروجی‌های آن\&.
.SH "خلاصه دستور (SYNOPSIS)"
\fBvhs\fP [\fIگزینه‌ها\&.\&.\&.\fP] [\fIآرگومان\&.\&.\&.\fP]
.SH "توضیحات (DESCRIPTION)"
برنامه VHS به شما امکان می‌دهد تا تصاویر متحرک (GIF) ترمینال را در قالب کد بنویسید\&.
.PP
ابزار VHS فایل‌های \&.tape را خوانده و از آن‌ها GIF (ویدیو) تولید (رندر) می‌کند\&.
.PP
یک فایل tape در واقع اسکریپتی متشکل از دستوراتی است که اقدامات لازم جهت اجرا در فرایند رندر را توصیف می‌کنند\&.
.PP
.PP
در ادامه فهرستی از تمام دستورات ممکن در VHS آمده است:
.PP
.PP
.RS
.IP \(bu 3
Output <path>\&.(gif|webm|mp4)
.IP \(bu 3
Require <program>
.IP \(bu 3
Set <setting> <value>
.IP \(bu 3
Sleep <time>
.IP \(bu 3
Type "<string>"
.IP \(bu 3
Ctrl [+Alt][+Shift]+<char>
.IP \(bu 3
Backspace [repeat]
.IP \(bu 3
Delete [repeat]
.IP \(bu 3
Insert [repeat]
.IP \(bu 3
Down [repeat]
.IP \(bu 3
Enter [repeat]
.IP \(bu 3
Left [repeat]
.IP \(bu 3
Right [repeat]
.IP \(bu 3
Tab [repeat]
.IP \(bu 3
Up [repeat]
.IP \(bu 3
PageUp [repeat]
.IP \(bu 3
PageDown [repeat]
.IP \(bu 3
ScrollUp [repeat]
.IP \(bu 3
ScrollDown [repeat]
.IP \(bu 3
Hide
.IP \(bu 3
Show
.IP \(bu 3
Wait[+Screen][@<timeout>] /<regexp>/
.IP \(bu 3
Escape
.IP \(bu 3
Alt+<key>
.IP \(bu 3
Space [repeat]
.IP \(bu 3
Source <path>\&.tape
.IP \(bu 3
Screenshot <path>\&.png
.IP \(bu 3
Copy "<string>"
.IP \(bu 3
Paste
.RE
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB-o, --output\fP
نام فایل(های) ویدیوی خروجی
.TP
\fB-p, --publish\fP
انتشار GIF شما در vhs\&.charm\&.sh و دریافت نشانی اینترنتی (URL) قابل اشتراک‌گذاری
.TP
\fB-q, --quiet\fP
حالت بی‌صدا؛ پیام‌ها را ثبت نمی‌کند\&. در صورت ارائه پرچم publish، نشانی اینترنتی قابل اشتراک‌گذاری ثبت خواهد شد
.SH "دستورها (COMMANDS)"
.TP
\fBhelp\fP [command]
.RS 4
راهنمای مربوط به هر دستور
.RE
.TP
\fBnew\fP <name>
.RS 4
ایجاد یک فایل tape جدید همراه با محتوای نمونه و مستندات
.RE
.TP
\fBpublish\fP <gif>
.RS 4
انتشار GIF شما در vhs\&.charm\&.sh و دریافت نشانی اینترنتی قابل اشتراک‌گذاری
.RE
.TP
\fBrecord\fP
.RS 4
ایجاد یک فایل tape جدید از طریق ضبط کنش‌های شما
.RE
.TP
\fBگزینه‌ها (OPTIONS)\fP
.RS 4
\fB-s, --shell\fP
پوسته (shell) برای ضبط
.RE
.TP
\fBserve\fP
.RS 4
راه‌اندازی کارساز (سرور) SSH برنامه VHS
.RE
.TP
\fBthemes\fP
.RS 4
فهرست کردن تمام پوسته‌های (theme) موجود، در هر سطر یک مورد
.RE
.TP
\fBگزینه‌ها (OPTIONS)\fP
.RS 4
\fB--markdown\fP
خروجی در قالب markdown
.RE
.TP
\fBvalidate\fP <file>\&.\&.\&.
.RS 4
اعتبارسنجی مسیر فایل‌های الگو (glob) و تجزیه تمام فایل‌ها جهت اطمینان از معتبر بودن آن‌ها بدون اجرایشان\&.
.RE
.SH "خروجی (OUTPUT)"
دستور Output به VHS مشخص می‌کند خروجی ضبط را در کجا ذخیره کند\&.
.PP
نام‌های فایل با پسوند \&.gif، \&.webm و \&.mp4 دارای نوع فایل متناظر خواهند بود\&.
.PP
.SH "تنظیمات (SETTINGS)"
دستور Set به VHS امکان می‌دهد تا تنظیمات محیط ترمینال، مانند قلم‌ها، ابعاد و پوسته‌ها را تنظیم کند\&.
.PP
.PP
در ادامه فهرستی از تمام دستورات تنظیمی ممکن در VHS آمده است:
.PP
.PP
.RS
.IP \(bu 3
Set Shell <string>
.IP \(bu 3
Set FontSize <number>
.IP \(bu 3
Set FontFamily <string>
.IP \(bu 3
Set Height <number>
.IP \(bu 3
Set Width <number>
.IP \(bu 3
Set LetterSpacing <float>
.IP \(bu 3
Set LineHeight <float>
.IP \(bu 3
Set TypingSpeed <time>
.IP \(bu 3
Set Theme <json|string>
.IP \(bu 3
Set Padding <number>
.IP \(bu 3
Set Framerate <number>
.IP \(bu 3
Set PlaybackSpeed <float>
.IP \(bu 3
Set WaitTimeout <time>
.IP \(bu 3
Set WaitPattern <regexp>
.RE
.SH "گزارش باگ‌ها (BUGS)"
مشاهده مشکلات در گیت‌هاب: <https://github\&.com/charmbracelet/vhs/issues>
.SH "نویسندگان (AUTHORS)"
Charm <vt100@charm\&.sh>
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
(C) 2021-2022 Charmbracelet, Inc\&.
.PP
تحت مجوز MIT منتشر شده است\&.