.TH YTFZF 1 "سپتامبر 2021" "ytfzf 2.0" .SH "نام (NAME)" ytfzf \- جستجو و پخش ویدیوها .SH "خلاصه دستور (SYNOPSIS)" .SY ytfzf .RI [ گزینه‌ها ] .RI [ عبارت\-جستجو ] .SY ytfzf .RI [ گزینه‌ها ] .RI \- .SH "توضیحات (DESCRIPTION)" .PP .B ytfzf یک اسکریپت POSIX است که به شما در پیدا کردن ویدیوها از YouTube، Peertube یا Odysee (بدون API) کمک کرده و آن‌ها را با استفاده از mpv/youtube\-dl باز یا دانلود می‌کند. .SH "عملگرهای جستجو (SEARCH OPERATORS)" .PP عملگرهای جستجو، عبارت‌های جستجوی ویژه‌ای هستند. .PP عملگرهای استاندارد جستجو عبارتند از: .RS .TP .IR :help توضیحی احتمالاً مختصر درباره نحوه استفاده از scraper چاپ می‌کند. .RE .PP اسکریپرهای افزونه (Addon scrapers) ممکن است عملگرهای جستجوی بیشتر یا کمتری داشته باشند. .SH "میانبرها (SHORTCUTS)" .PP این میانبرها در هر منویی که از آن‌ها پشتیبانی کند اعمال خواهند شد. .br تنها منویی که در حال حاضر از آن پشتیبانی می‌کند fzf است. .br میانبرهایی که با alt شروع می‌شوند از منو خارج خواهند شد، اما میانبرهایی که با ctrl شروع می‌شوند خارج نخواهند شد. .br برای تغییر هر یک از مقادیر پیش‌فرض، متغیر مربوطه را در فایل پیکربندی خود تنظیم کنید. .TP .BR "دانلود (download)" alt-d (download_shortcut) .TP .BR "تماشای ویدیو (watch video)" alt-v (video_shortcut) .TP .BR "فقط صدا (audio only)" alt-m (audio_shortcut) .TP .BR "جداسازی (detach)" alt-e (detach_shortcut) .TP .BR "چاپ پیوند (print link)" alt-l (print_link_shortcut) .TP .BR "نمایش فرمت‌ها (show formats)" alt-f (show_formats_shortcut) .TP .BR "نمایش تمام اطلاعات (show all info)" alt-i (info_shortcut) .TP .BR "جستجوی جدید (new search)" alt-s (search_again_shortcut) .TP .BR "واکشی صفحه بعد (scrape next page)" ctrl-p (next_page_action_shortcut).SH "گزینه‌ها (OPTIONS)" .PP اطلاعات .RS .TP .BR \-h ", " \-\-help نمایش متن راهنما. .TP .BR \-\-version نمایش نسخهٔ ytfzf. .RE .PP نحوهٔ پخش ویدیوهای انتخاب‌شده. .RS .TP .BR \-d ", " \-\-download بارگیری ویدیوهای انتخاب‌شده. این مورد را می‌توان در فایل پیکربندی با .BR is_download نیز تنظیم کرد. .TP .BR \-m ", " \-\-audio\-only پخش فقط صدا. این مورد را می‌توان در فایل پیکربندی با .BR is_audio_only نیز تنظیم کرد. .TP .BR \-f ", " \-\-formats نمایش فرمت‌های موجود پیش از ادامه. .TP .BR \-\-format\-selection=\fIscreen\fR نوع صفحهٔ انتخاب فرمت مورد استفاده. .PP .RS انواع: .RS .TP .IR normal .TP .IR simple .RE .RE .RS این مورد را می‌توان در فایل پیکربندی با .BR format_selection_screen نیز تنظیم کرد. .RE .TP .BR \-\-format\-sort=\fIsort\fR گزینهٔ \-\-format\-sort برای استفاده در ytdl. این مورد را می‌توان در فایل پیکربندی با .BR format_selection_sort نیز تنظیم کرد. .TP .BR \-\-video\-pref=pref تنظیم فرمت ویدیوی ytdl روی pref. این مورد را می‌توان در فایل پیکربندی با .BR video_pref نیز تنظیم کرد. .TP .BR \-\-audio\-pref=pref تنظیم فرمت صوتی ytdl روی pref. این مورد را می‌توان در فایل پیکربندی با .BR audio_pref نیز تنظیم کرد. .TP .BR \-\-ytdl\-pref=pref تنظیم فرمت ytdl روی pref. این مورد را می‌توان در فایل پیکربندی با .BR ytdl_pref نیز تنظیم کرد. .TP .BR \-\-detach جدا کردن پخش‌کنندهٔ ویدیو از ترمینال. این مورد را می‌توان در فایل پیکربندی با .BR is_detach نیز تنظیم کرد. .TP .BR \-u ", " \-\-url\-handler=handler تابع/برنامه برای استفاده به عنوان گردانندهٔ نشانی (url handler). این مورد را می‌توان در فایل پیکربندی با افزودن .BR load_url_handler " " نیز تنظیم کرد. .TP .BI \-I " option" به جای پخش ویدیوهای انتخاب‌شده، اطلاعات مربوط به آن‌ها را در فرمت مشخص‌شده دریافت می‌کند. گزینه‌های موجود عبارتند از: .RS .TP .IR L | l | link نشانی وب (URL) ویدیوهای انتخاب‌شده را چاپ می‌کند. .TP .IR VJ | vj | video\-json داده‌های json ویدیوهای انتخاب‌شده را چاپ می‌کند. .TP .IR J | j | json داده‌های json تمام ویدیوهای موجود در نتایج جستجو را چاپ می‌کند. .TP .IR F | f | format فرمت ویدیوی در حال استفاده را چاپ می‌کند. .TP .IR R | r | raw داده‌های ویدیوهای انتخاب‌شده را همان‌طور که در منو نمایش داده می‌شود چاپ می‌کند. .RE .TP .B \-L نام مستعار برای \-I L .TP .BR \-\-info\-action=\Iaction عملی که باید در هنگام ۱ بودن \-\-info\-wait انجام شود. .BR info_wait_action . .TP .BR \-\-info\-wait=\fInumber تعیین این‌که آیا پس از چاپ اطلاعات درخواست‌شده با \-I یا \-L درنگ شود یا خیر. این مورد را می‌توان در فایل پیکربندی با .BR info_wait نیز تنظیم کرد. .RE .TP .BR \-\-url\-handler\-opts=opts گزینه‌هایی که باید به گردانندهٔ نشانی ارسال شوند؛ به طور پیش‌فرض این کار گزینه‌های اضافی را به mpv ارسال می‌کند. این مورد را می‌توان در فایل پیکربندی با .BR url_handler_opts نیز تنظیم کرد. .RE .PP گزینه‌های منو .RS .TP .BR \-l ", " \-\-loop باز کردن مجدد منو هنگامی که پخش ویدیو متوقف می‌شود. این مورد را می‌توان در فایل پیکربندی با .BR is_loop نیز تنظیم کرد. .TP .BR \-s ", " \-\-search\-again انجام جستجوی دیگر پس از بستن fzf. این مورد را می‌توان در فایل پیکربندی با .BR search_again نیز تنظیم کرد. .TP .BR \-t ", " \-\-show\-thumbnails نمایش تصاویر بندانگشتی (thumbnails). با \fB\-D\fR یا \fB\-H\fR کار نمی‌کند. این مورد را می‌توان در فایل پیکربندی با .BR show_thumbnails نیز تنظیم کرد. .TP .BR \-\-async\-thumbnails تعیین بارگیری ناهمگام تصاویر بندانگشتی. .br بارگیری ناهمگام باعث می‌شود منو پیش از اتمام بارگیری همهٔ تصاویر بندانگشتی باز شود. این مورد را می‌توان در فایل پیکربندی با .BR async_thumbnails نیز تنظیم کرد. .TP .BR \-\-skip\-thumb\-download تعیین صرف‌نظر کردن از بارگیری تصاویر بندانگشتی. این گزینه در صورتی استفاده می‌شود که نخواهید تصویر بندانگشتی داشته باشید، یا بخواهید از تصاویر بندانگشتی سفارشی در $YTFZF_CUSTOM_THUMBNAILS_DIR استفاده کنید. .br برای اطلاعات بیشتر بخش CUSTOM THUMBNAILS را در ytfzf(5) ببینید .br این مورد را می‌توان در فایل پیکربندی با .BR skip_thumb_download نیز تنظیم کرد. .TP .BR \-\-notify-playing نمایش اعلان‌ها هنگامی که یک ویدیو در آستانهٔ پخش است، و سایر اعلان‌های مربوط به پخش ویدیوها. این مورد را می‌توان در فایل پیکربندی با .BR notify_playing نیز تنظیم کرد. .TP .BR \-\-preview\-side=side جهت پیش‌نمایش در fzf. .br گزینه‌ها: .RS .TP .IR left .TP .IR right .TP .IR up .TP .IR down .RE این مورد را می‌توان در فایل پیکربندی با .BR fzf_preview_side نیز تغییر داد. .TP .BR \-T ", " \-\-thumb\-viewer=program استفاده از برنامه برای نمایش تصاویر بندانگشتی. .br برنامه‌های توکار: .RS.TP .IR chafa, chafa-16, chafa-tty ‏chafa،‏ chafa با ۱۶ رنگ، chafa با ۴ رنگ. .TP .IR catimg, catimg-256 ‏catimg،‏ catimg با ۲۵۶ رنگ. .TP .IR imv مناسب برای مدیر پنجره‌های کاشی‌ساز (tiling). .TP .IR mpv مشابه imv. .TP .IR swayimg تنها روی کامپوزیتور وی‌لند sway کار می‌کند. .TP .IR swayimg-hyprland تنها روی کامپوزیتور hyprland کار می‌کند. برای رندر و نمایش تصویر از swayimg استفاده می‌کند. .TP .IR نمایش‌دهنده‌های دیگر را می‌توان درون $YTFZF_THUMBNAIL_VIEWERS_DIR قرار داد. .RE این مورد را می‌توان در فایل پیکربندی نیز با افزودن عبارت زیر تغییر داد: .br .BR load_thumbnail_viewer " " . .TP .BR \-D ", " \-\-external\-menu استفاده از یک منوی خارجی به جای fzf. پیش‌فرض \fIdmenu\fR است. این مورد را می‌توان در فایل پیکربندی نیز با عبارت زیر تنظیم کرد: .BR interface="ext" . .TP .BR \-i ", " \-\-interface=interface استفاده از یک اسکریپت واسط سفارشی که در $YTFZF_CUSTOM_INTERFACES_DIR قرار دارد. این مورد را می‌توان در فایل پیکربندی نیز با افزودن عبارت زیر تنظیم کرد: .BR load_interface " " . .TP .BR \-\-sort مرتب‌سازی ویدیوها (پس از استخراج اطلاعات) بر پایه تاریخ بارگذاری. این مورد را می‌توان در فایل پیکربندی نیز با افزودن عبارت زیر تنظیم کرد: .BR is_sort . .TP .BR \-\-sort\-name=name تابعی را که در $YTFZF_CONFIG_FILE مشخص شده فراخوانی می‌کند، یا اسکریپتی را در $YTFZF_SORT_NAMES_DIR (در صورت وجود) بارگذاری (source) می‌کند. برای اطلاعات بیشتر بخش SORT NAMES در ytfzf(5) را ببینید. .TP .BR \-\-fancy\-subs تعیین قرار گرفتن یا نگرفتن جداکننده میان هر اشتراک (subscription). هنگامی که از این گزینه استفاده می‌شود، به طور خودکار \-\-sort غیرفعال می‌گردد، زیرا باعث اختلال در این گزینه می‌شود. .br این مورد را می‌توان در فایل پیکربندی نیز با عبارت زیر تنظیم کرد: .BR fancy_subs . .TP .BR \-\-disable\-back تعیین غیرفعال بودن یا نبودن دکمه بازگشت در زیرمنوها. .br این مورد را می‌توان در فایل پیکربندی نیز با عبارت زیر تنظیم کرد: .BR enable_back_button . .BR \-\-disable\-actions تعیین غیرفعال بودن یا نبودن اقداماتی مانند زیرمنوها و دکمه بازگشت. .br این مورد را می‌توان در فایل پیکربندی نیز با عبارت زیر تنظیم کرد: .BR enable_actions . .TP .BR \-\-disable\-submenus تعیین غیرفعال بودن یا نبودن زیرمنوها. .br زیرمنوها منوهایی هستند که پس از انتخاب یک فهرست‌پخش یا کانال (در حال حاضر تنها توسط youtube/invidious پشتیبانی می‌شود) نمایش داده می‌شوند. .br این مورد را می‌توان در فایل پیکربندی نیز با عبارت زیر تنظیم کرد: .BR enable_submenus . .TP .BR \-\-keep\-vars تعیین ارسال شدن یا نشدن گزینه‌های داده‌شده به ytfzf به زیرمنوها. این مورد را می‌توان در فایل پیکربندی نیز با عبارت زیر تنظیم کرد: .BR keep_vars . .TP .BR \-\-submenu\-opts=opts گزینه‌های مورد استفاده در زیرمنو. .br این مورد را می‌توان در فایل پیکربندی نیز با عبارت زیر تنظیم کرد: .BR submenu_opts . .TP .BR \-\-submenu\-scraping\-opts=opts .B منسوخ‌شده "(به جای آن از \-\-submenu\-opts استفاده کنید)" کاری مشابه با \-\-submenu\-opts انجام می‌دهد. .br این مورد را می‌توان در فایل پیکربندی نیز با عبارت زیر تنظیم کرد: .BR submenu_scraping_opts . .RE .PP انتخاب خودکار .RS .TP .BR \-a ", " \-\-auto\-select پخش خودکار نخستین نتیجه. .TP .BR \-A ", " \-\-select\-all انتخاب همه نتایج. .TP .BR \-r ", " \-\-random\-select پخش خودکار یک نتیجه تصادفی. .TP .BR \-S " \fIsed address\fR" ", " "\-\-select=\fIsed address\fR" پخش خودکار یک ویدیوی مشخص. .PP .RS مثال‌ها: .RS .TP .IR 2 انتخاب دومین ویدیو .TP .IR $ انتخاب آخرین ویدیو .TP .IR /^h/ انتخاب همه ویدیوهایی که با h آغاز می‌شوند .RE .RE .TP .BR \-n " \fInumber\fR" ", " \-\-link\-count=\fInumber تعداد (\fInumber\fR) ویدیوها برای انتخاب با \fB\-a\fR یا \fB\-r\fR. .RE .PP اسکریپرها (Scrapers) .RS .TP .BI \-c " scrapers" ", " "\-\-scrape=scrapers" تعیین اسکریپر مورد استفاده. می‌توان چند اسکریپر را با کاما (,) جدا کرد. اسکریپرهای توکار که در حال حاضر پشتیبانی می‌شوند عبارتند از: .RS .TP .IR youtube | Y اطلاعات API سرویس invidious را با یک عبارت جستجو استخراج می‌کند. .TP .IR youtube-channel اطلاعات یک کانال یوتیوب را با استفاده از youtube استخراج می‌کند. .TP .IR invidious-channel اطلاعات یک کانال یوتیوب را با $invidious_instance استخراج می‌کند. .br هنگامی که این اسکریپر فعال است، عبارت جستجو پیوند به یک کانال خواهد بود. .TP .IR video-recommended | R ویدیوهای پیشنهادی را از پیوند یک ویدیوی invidious دریافت می‌کند. .TP .IR youtube-playlist | invidious-playlist اطلاعات یک فهرست‌پخش یوتیوب را دریافت می‌کند. .br هنگامی که این اسکریپر فعال است، عبارت جستجو پیوند به یک فهرست‌پخش خواهد بود. .TP .IR youtube\-trending | T اطلاعات API سرویس invidious را برای دریافت ویدیوهای پرطرفدار (ترند) یوتیوب استخراج می‌کند. .br هنگامی که این اسکریپر فعال است، عبارت جستجو زبانه ترند مورد نظر برای استخراج است. .TP .IR from\-cache اطلاعات حاصل از استخراج قبلی را که با استفاده از \-\-keep\-cache ذخیره شده بود، از حافظه موقت (کَش) بازیابی می‌کند. .TP .IR M | multi استفاده بازگشتی از ytfzf برای دریافت چند مورد با گزینه‌های مختلف متعدد. .br برای اطلاعات بیشتر \fIytfzf -c M :help\fR را ببینید. .br زبانه\u200cها: .RS .TP .IR gaming .TP .IR music .TP .IR movies .RE.TP .IR youtube\-subscriptions | S | SI .I SI کانال‌ها را به جای youtube از invidious واکشی می‌کند. واکشی از youtube ممکن است منجر به محدودیت نرخ درخواست (rate limiting) شود. .TP .IR scrape\-list | SL از $YTFZF_SCRAPELIST_FILE شما به عنوان ورودی واکشی و جستجو استفاده می‌کند. برای اطلاعات بیشتر به «scrape lists» در ytfzf(5) مراجعه کنید. .TP .IR peertube | P .TP .IR odysee | lbry | O .TP .IR history | H (تنها در صورتی که $enable_hist فعال باشد) .TP .IR url | U نشانی url را در پخش‌کننده ویدیو باز کرده و خارج می‌شود .TP .IR u با url مانند یک مورد رفتار می‌کند و fzf یا منوی خارجی را باز خواهد کرد. .TP .IR comments دیدگاه‌های یک پیوند ویدیویی را از youtube واکشی می‌کند .RE .TP .BR \-H ", " \-\-history نام مستعار برای \-c H. .br فایل تاریخچه را واکشی می‌کند. .TP .BI "\-\-scrape+=scrapers" مشابه \-c، اما واکشی پیش‌فرض را نیز نگه می‌دارد. .TP .BI \-\-scraper-=scrapers واکِش‌گر را از فهرست واکِش‌گرهای مورد استفاده حذف می‌کند .TP .BR \-\-multi\-search تعیین استفاده یا عدم استفاده از جستجوی چندگانه. .br برای استفاده از جستجوی چندگانه، هر جستجو را با کاما جدا کنید؛ این قابلیت هنگام استفاده از چندین واکِش‌گر به خوبی عمل می‌کند. .br این مورد همچنین می‌تواند در فایل پیکربندی با .BR multi_search تنظیم شود. .TP .B \-\-force\-youtube هنگام استفاده از واکِش‌گر \fIyoutube\fR، پیش از پخش یا بارگیری، پیوندهای invidious را به پیوندهای youtube تبدیل می‌کند. .TP .B \-\-force\-invidious هنگام استفاده از واکِش‌گر \fIyoutube\fR، به جای تبدیل به پیوندهای youtube، از هر نمونهٔ invidious انتخاب‌شده استفاده می‌کند. .RE .PP گزینه‌های واکِش‌گر (Scraper) .RS .PP در حال حاضر، \-\-video\-duration، \-\-type، \-\-thumbnail\-quality و \-\-features تنها بر واکشی youtube/Y اعمال می‌شوند .TP .BI "\-\-pages=amount" تعداد صفحاتی که باید در youtube/invidious و واکِش‌گر دیدگاه‌ها (comments) واکشی شوند. این مقدار همچنین می‌تواند در فایل پیکربندی با .BR pages_to_scrape تنظیم شود. .TP .BI "\-\-pages-start=page" صفحه‌ای که واکشی از آن آغاز می‌شود. این مقدار همچنین می‌تواند در فایل پیکربندی با .BR pages_start تنظیم شود. .TP .BI "\-\-max\-threads=amount" تعداد رشته‌هایی (threads) که می‌توان برای واکشی جستجو، فهرست‌های پخش و کانال‌های youtube استفاده کرد. (این مورد برای واکِش‌گر اشتراک‌ها اعمال نمی‌شود). .br این مقدار همچنین می‌تواند در فایل پیکربندی با .BR max_thread_count تنظیم شود. .TP .BI "\-\-single\-threaded" مقدار max_thread_count را برابر با ۱ قرار می‌دهد، که اثر آن مشابه تک‌رشته‌ای کردن همه چیز است. (این مورد برای واکِش‌گر اشتراک‌ها اعمال نمی‌شود). .br این مقدار همچنین می‌تواند در فایل پیکربندی با .BR max_thread_count=1 تنظیم شود. .TP .BI "\-\-odysee\-video\-count=amount" تعداد ویدیوهایی که باید در odysee واکشی شوند. این مقدار همچنین می‌تواند در فایل پیکربندی با .BR odysee_video_search_count تنظیم شود. .TP .BR "\-\-nsfw" تعیین جستجو یا عدم جستجو برای ویدیوهای nsfw. .br تنها با odysee/O کار می‌کند این مورد همچنین می‌تواند در فایل پیکربندی با .BR nsfw تنظیم شود. .TP .BI "\-\-sort\-by=sort" با youtube/Y و odysee/O کار می‌کند. .br برای استفاده از مرتب‌سازی متفاوت در هر واکشی، مرتب‌سازی‌ها را با کاما (,) جدا کنید. .br برخلاف \-\-sort، این عملیات در حین جستجو رخ می‌دهد، نه پس از آن. نتایج باید بر اساس موارد زیر مرتب شوند: .RS .TP .IR relevance .TP .IR rating " (تنها youtube)" .TP .IR upload_date .TP .IR oldest_first " (تنها odysee)" .TP .IR view_count " (تنها youtube)" .RE .TP .BI "\-\-upload\-date=time\-frame" با youtube/Y و odysee/O کار می‌کند .br برای استفاده از مرتب‌سازی زمانی متفاوت در هر واکشی، تاریخ‌ها را با کاما (,) جدا کنید. .br جستجوی ویدیوها در بازهٔ زمانی گذشته: .RS .TP .IR hour .TP .IR today .TP .IR week .TP .IR month .TP .IR year .RE .TP .BI "\-\-video\-duration=duration" تعیین جستجو برای ویدیوهای طولانی یا کوتاه. گزینه‌های ممکن: .RS .TP .IR short .TP .IR long .RE .TP .BI "\-\-type=type" نوع نتایجی که باید دریافت شوند. .RS .TP .IR video .TP .IR playlist .TP .IR channel .TP .IR all .RE .TP .BI \-\-thumbnail\-quality= quality انتخاب کیفیت تصویر بندانگشتی (thumbnail). گزینه‌های در دسترس: .RS .TP .IR maxres .TP .IR maxresdefault .TP .IR sddefault .TP .IR high " (پیش‌فرض)" .TP .IR medium .TP .IR default .TP .IR start نخستین فریم ویدیو (کیفیت پایین) .TP .IR middle فریم میانی ویدیو (کیفیت پایین).TP .IR end فریم پایانی ویدیو (کیفیت پایین) .RE .TP .BI "\-\-features=features" ویژگی‌هایی که ویدیو باید داشته باشد (با کاما از هم جدا شوند). .RS .TP .IR hd .TP .IR subtitles .TP .IR creative_commons .TP .IR 3d .TP .IR live .TP .IR 4k .TP .IR 360 .TP .IR location .TP .IR hdr .RE .TP .BI "\-\-region" منطقه (کد کشور) برای جستجو. .br پشتیبانی‌شده توسط اسکرپ‌های youtube/Y و youtube-trending/T .RE .PP متفرقه .RS .TP .BI "\-\-ii=instance", "\-\-invidious\-instance=instance" استفاده از یک نمونهٔ متفاوت invidious. .TP .BI "\-\-rii", "\-\-refresh\-inv-instance" در صورت ارائهٔ این پرچم، حافظهٔ پنهان نمونه‌ها با نمونه‌های سالم با استفاده از Invidious API تازه‌سازی می‌شود. .TP .BI "\-\-available\-inv\-instances" نمونه‌های invidious قابل استفاده را چاپ کرده و خارج می‌شود. .TP .BI "\-\-channel\-link=link" پیوندهای کانال را از \(aqhttps://youtube.com/c/name\(aq به \(aqhttps://youtube.com/channel/id\(aq تبدیل می‌کند. .TP .BR \-q استفاده از تاریخچهٔ جستجو به جای یک جستجوی جدید. این مورد همچنین می‌تواند با .BR search_source=hist در فایل پیکربندی تنظیم شود. .TP .BR \-\-search\-source منبع مورد استفاده برای پرس‌وجوی جستجو. مقادیر معتبر عبارتند از: .RS .TP .RB args استفاده از آرگومان‌های خط فرمان به عنوان جستجو (پیش‌فرض) .TP .RB prompt درخواست جستجو از طریق یک اعلان (prompt) .TP .RB hist استفاده از تاریخچهٔ جستجو. .TP .RB next استفادهٔ داخلی برای به‌کارگیری جستجوی بعدی در فهرست هنگامی که \fBmulti_search\fR فعال باشد. .TP .RB fn-args استفادهٔ داخلی برای به‌کارگیری آرگومان‌های ارسالی به تابع به عنوان منبع. .TP .RB در صورت وجود تابعی با نام get_search_from_، یک منبع جستجوی سفارشی می‌تواند استفاده شود. این تابع باید متغیر _search را روی یک جستجو تنظیم کند. .RE .TP .BR \-x ", " \-\-history\-clear= پاک کردن تاریخچهٔ جستجو و تماشا (در صورت استفاده از \-x یا \-\-history\-clear) .br برای مشخص کردن تاریخچهٔ جستجو یا تماشا از \-\-history\-clear= استفاده کنید .TP .BR \-\-keep\-cache نگه‌داشتن یا عدم نگه‌داشتن حافظهٔ پنهان پس از پایان کار .I ytfzf . این مورد همچنین می‌تواند با .BR keep_cache در فایل پیکربندی تنظیم شود. .TP .BI \-\-ytdl\-opts= option ارسال گزینه‌های خط فرمان به youtube\-dl هنگام بارگیری. .EX .RB "مثال: " \-\-ytdl\-opts= "\fI\"\-o ~/Videos/%(title)s.%(ext)s\"" .EE .TP .BI \-\-ytdl\-path= path مسیر youtube\-dl یا یک انشعاب از youtube\-dl را برای بارگیری مشخص می‌کند. .br این مورد همچنین می‌تواند با .BR ytdl_path در فایل پیکربندی تنظیم شود. .TP .BI \-e ", " \-\-ext=extension بارگذاری یک افزونه. .br همچنین می‌توانید .I "load_extension extension" را به فایل پیکربندی خود اضافه کنید. .TP .BI \-\-list\-addons تمام افزونه‌ها را فهرست کرده و خارج می‌شود. .TP .BI \-\-thumbnail\-log فایلی را برای ثبت اطلاعات اشکال‌زدایی تصویر بندانگشتی تعیین می‌کند. این مورد همچنین می‌تواند با .BR thumbnail_debug_log در فایل پیکربندی تنظیم شود. .RE.SH "پیکربندی (CONFIGURATION)" رفتار پیش‌فرض \fBytfzf\fR را می‌توان با تغییر دادن فایل پیکربندی دگرگون کرد. برای اطلاعات بیشتر \fBytfzf\fR(5) را ببینید. .SH "افزونه‌ها (ADDONS)" .PP چند نوع افزونه وجود دارد: .br .B interfaces (\-i, \-\-interface) .br .B scrapers (\-c, \-\-scrape) .br .B sort-names (\-\-sort\-name) .br .B thumbnail-viewers (\-T, \-\-thumb\-viewer) .br .B url-handlers (\-u, \-\-url_handler) .br .B extensions (\-e, \-\-ext) .PP برای نصب یک افزونه، آن را در مسیر زیر قرار دهید: .I $YTFZF_SYSTEM_ADDON_DIR//addon-name .PP برای استفاده از یک افزونه، از یکی از گزینه‌های ذکرشده در بالا استفاده کنید، یا این خطوط را .br .B load_interface .br .B scrape= .br .B load_sort_name .br .B load_thumbnail_viewer .br .B load_url_handler .br .B load_extension .br در فایل پیکربندی خود قرار دهید. .SH "کدهای خروج (EXIT CODES)" .TP .B 0 موفقیت .TP .B 1 خطای عمومی .TP .B 2 گزینه (\-\-option) نامعتبر، مقدار نامعتبر برای گزینه، یا خطای پیکربندی. .TP .B 3 وابستگی ناموجود .TP .B 5 جستجوی خالی .SH "محیط (ENVIRONMENT)" .TP .B $YTFZF_CONFIG_DIR دایرکتوری ذخیره فایل‌های پیکربندی. پیش‌فرض عبارت است از .I "$XDG_CONFIG_HOME/ytfzf (یا ~/.config/ytfzf)" .TP .B $YTFZF_CONFIG_FILE فایل پیکربندی مورد استفاده. پیش‌فرض عبارت است از .I $YTFZF_CONFIG_DIR/conf.sh .TP .B $YTFZF_SUBSCRIPTIONS_FILE فایل اشتراک‌های مورد استفاده. پیش‌فرض عبارت است از .I $YTFZF_CONFIG_DIR/subscriptions .TP .B $YTFZF_SCRAPELIST_FILE فایل فهرست واکشی (scrapelist) مورد استفاده. پیش‌فرض عبارت است از .I $YTFZF_CONFIG_DIR/scrapelist .TP .B $YTFZF_THUMBNAIL_VIEWERS_DIR دایرکتوری نگهداری نمایش‌دهنده‌های تصویر بندانگشتی اضافی. پیش‌فرض عبارت است از .I $YTFZF_CONFIG_DIR/thumbnail-viewers .TP .B $YTFZF_CUSTOM_SCRAPERS_DIR دایرکتوری برای ذخیره اسکریپت‌های اسکرپر سفارشی. پیش‌فرض عبارت است از .I $YTFZF_CONFIG_DIR/scrapers .TP .B $YTFZF_CUSTOM_INTERFACES_DIR دایرکتوری برای ذخیره اسکریپت‌های رابط سفارشی. پیش‌فرض عبارت است از .I $YTFZF_CONFIG_DIR/interfaces .TP .B $YTFZF_SORT_NAMES_DIR دایرکتوری برای ذخیره اسکریپت‌های سفارشی sort-name. پیش‌فرض عبارت است از .I $YTFZF_CONFIG_DIR/sort-names .TP .B $YTFZF_URL_HANDLERS_DIR دایرکتوری برای ذخیره گرداننده‌های سفارشی نشانی (url-handlers). پیش‌فرض عبارت است از .I $YTFZF_CONFIG_DIR/url-handlers .TP .B $YTFZF_CUSTOM_THUMBNAILS_DIR دایرکتوری برای ذخیره تصاویر بندانگشتی سفارشی. پیش‌فرض عبارت است از .I $YTFZF_CONFIG_DIR/thumbnails .TP .B $YTFZF_EXTENSIONS_DIR دایرکتوری برای ذخیره افزونه‌ها. پیش‌فرض عبارت است از .I $YTFZF_CONFIG_DIR/extensions .TP .B $YTFZF_SYSTEM_ADDON_DIR دایرکتوری برای ذخیره افزونه‌های نصب‌شده سیستمی. پیش‌فرض بسته به نحوه نصب ytfzf ممکن است متفاوت باشد. .TP .B $YTFZF_CHECK_VARS_EXISTS بررسی اینکه آیا متغیرها پیش از تعیین مقادیر پیش‌فرض در محیط تعریف شده‌اند یا خیر. پیش‌فرض عبارت است از .I 1 .TP .B $YTFZF_TEMP_DIR دایرکتوری موقت. پیش‌فرض عبارت است از .I $TMPDIR/ytfzf-$user-id. .br اگر $TMPDIR تعریف نشده باشد، از /tmp استفاده خواهد شد..SH "فایل‌ها (FILES)" .TP .I ~/.config/ytfzf/conf.sh فایل پیکربندی. اگر submenu-conf.sh وجود نداشته باشد، این فایل به عنوان پیکربندی در زیرمنوها نیز استفاده خواهد شد. .TP .I ~/.config/ytfzf/submenu-conf.sh فایل پیکربندی زیرمنو. .TP .I ~/.config/ytfzf/subscriptions فایل اشتراک‌ها. .SH "حافظه موقت (CACHE)" .PP هر نمونه از ytfzf دایرکتوری اختصاصی خود را در $YTFZF_TEMP_DIR دارد؛ اگر $keep_cache فعال باشد، در عوض از $cache_dir استفاده می‌کند. .br ساختار پوشه هر نمونه به این صورت است: (<> نشان‌دهنده جای‌نگه‌دار و ? به معنای اختیاری است) .br اگر یک افزونه اسکریپر (scraper) به کار رود، ممکن است از فایل‌های مستندنشده استفاده کند. .RS .EX $cache_dir | \-\- watch_hist | \-\- \- | | \-\- created-at | | \-\- searches.list | | \-\- post-scrape | | \-\- -? | | \-\- thumbnails? | | \-\- environment | | \-\- tmp | | | \-\- curl_config | | | \-\- .html | | | \-\- .json | | | \-\- .json.final? | | | \-\- menu_keypress | | | \-\- all-ids.list | | | \-\- downloaded-ids.list | | \-\- ids | | \-\- videos_json .EE .RE .PP توضیح هر دایرکتوری/فایل: .RS .TP .IR created-at حاوی برچسب زمان یونیکس (unix timestamp) در زمان ایجاد پوشه است. .TP .IR searches.list فهرستی از تمام جستجوها. .br اگر \-\-multi\-search فعال باشد، هر جستجو با یک خط جدید جدا می‌شود. .TP .IR watch_hist فایل تاریخچه تماشا. .TP .IR \- پوشه والد یک نمونه. .br اگر جستجویی مشخص نشده باشد، در عوض از نام \(lqSCRAPE\-\-\(rq استفاده می‌کند. .TP .IR post-scrape پوشه‌ای شامل فایل‌های مربوط به واکشی (scraping) یک نتیجه انتخاب‌شده. .TP .IR \- زمانی که یک زیرمنو باز می‌شود ایجاد می‌گردد (برای مثال: وقتی یک کانال/لیست‌پخش انتخاب شود). .TP .IR thumbnails تصاویر بندانگشتی را برای نمونه ذخیره می‌کند (فقط با \-t). .TP .IR environment تمام متغیرهایی که در آن نمونه از ytfzf تنظیم شده‌اند و مقادیر آن‌ها. .TP .IR tmp فایل‌های موقت با اهمیت کمتر را ذخیره می‌کند. .TP .IR curl_config فایل پیکربندی curl برای دانلود بندانگشتی‌ها (فقط با \-t). .TP .IR .html برای اسکریپرهایی که نیاز به واکشی وبگاه‌ها دارند، این خروجی curl است. .TP .IR .json فایل json واکشی‌شده از وبگاه. .TP .IR .json.final فایل json نهایی واکشی‌شده از وبگاه. (زمانی استفاده می‌شود که از چندین ریسه (thread) برای واکشی استفاده شود) .TP .IR menu_keypress کلید فشرده‌شده در fzf. .TP .IR all-ids.json فایلی شامل تمام شناسه‌های واکشی‌شده. عمدتاً جهت مقایسه با downloaded-ids.json. .TP .IR downloaded-ids.json فایلی شامل مشخصات بندانگشتی‌های دانلودشده. .TP .IR ids فایلی که شناسه هر ویدئوی انتخاب‌شده را ذخیره می‌کند. .TP .IR videos_json فایلی که یک json از تمام ویدیوهای نمایش داده‌شده در fzf را ذخیره می‌کند. .br این فایل به دلیل داشتن قالبی مشابه، برای ساخت لیست‌های پخش بسیار مفید است..SH "نویسندگان (AUTHORS)" در ابتدا توسط pystardust نوشته شده است. .IR < https://github.com/pystardust > .SH "گزارش باگ‌ها (BUGS)" باگ‌ها را در GitHub گزارش دهید: .IR < https://github.com/pystardust/ytfzf/issues > .SH "همچنین ببینید (SEE ALSO)" .BR ytfzf (5) .BR youtube\-dl (1), .BR mpv (1) .BR fzf (1) .BR dmenu (1) .SH "کپی‌رایت و تکثیر (COPYRIGHT)" .PP نرم‌افزار \fBytfzf\fR یک نرم‌افزار آزاد است: می‌توانید آن را تحت شرایط \fIGNU General Public License نسخه ۳\fR همان‌طور که توسط بنیاد نرم‌افزار آزاد منتشر شده است، بازتوزیع کرده و/یا تغییر دهید. .PP نرم‌افزار \fBytfzf\fR با این امید توزیع شده است که مفید واقع شود، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابلیت فروش یا مناسب بودن برای یک هدف خاص. برای جزئیات بیشتر به GNU General Public License مراجعه کنید. .PP شما باید به همراه \fBytfzf\fR نسخه‌ای از GNU General Public License را دریافت کرده باشید. اگر دریافت نکرده‌اید، ببینید: .IR < https://www.gnu.org/licenses >.