YTFZF(1) General Commands Manual YTFZF(1)

ytfzf - جستجو و پخش ویدیوها

ytfzf [گزینه‌ها] [عبارت-جستجو]
ytfzf [گزینه‌ها] -

ytfzf یک اسکریپت POSIX است که به شما در پیدا کردن ویدیوها از YouTube، Peertube یا Odysee (بدون API) کمک کرده و آن‌ها را با استفاده از mpv/youtube-dl باز یا دانلود می‌کند.

عملگرهای جستجو، عبارت‌های جستجوی ویژه‌ای هستند.

عملگرهای استاندارد جستجو عبارتند از:

:help
توضیحی احتمالاً مختصر درباره نحوه استفاده از scraper چاپ می‌کند.

اسکریپرهای افزونه (Addon scrapers) ممکن است عملگرهای جستجوی بیشتر یا کمتری داشته باشند.

این میانبرها در هر منویی که از آن‌ها پشتیبانی کند اعمال خواهند شد.
تنها منویی که در حال حاضر از آن پشتیبانی می‌کند fzf است.
میانبرهایی که با alt شروع می‌شوند از منو خارج خواهند شد، اما میانبرهایی که با ctrl شروع می‌شوند خارج نخواهند شد.
برای تغییر هر یک از مقادیر پیش‌فرض، متغیر مربوطه را در فایل پیکربندی خود تنظیم کنید.

دانلود (download)
alt-d (download_shortcut)
تماشای ویدیو (watch video)
alt-v (video_shortcut)
فقط صدا (audio only)
alt-m (audio_shortcut)
جداسازی (detach)
alt-e (detach_shortcut)
چاپ پیوند (print link)
alt-l (print_link_shortcut)
نمایش فرمت‌ها (show formats)
alt-f (show_formats_shortcut)
نمایش تمام اطلاعات (show all info)
alt-i (info_shortcut)
جستجوی جدید (new search)
alt-s (search_again_shortcut)
واکشی صفحه بعد (scrape next page)
ctrl-p (next_page_action_shortcut).SH "گزینه‌ها (OPTIONS)"

اطلاعات

نمایش متن راهنما.
نمایش نسخهٔ ytfzf.

نحوهٔ پخش ویدیوهای انتخاب‌شده.

بارگیری ویدیوهای انتخاب‌شده. این مورد را می‌توان در فایل پیکربندی با is_download نیز تنظیم کرد.
پخش فقط صدا. این مورد را می‌توان در فایل پیکربندی با is_audio_only نیز تنظیم کرد.
نمایش فرمت‌های موجود پیش از ادامه.
نوع صفحهٔ انتخاب فرمت مورد استفاده.
انواع:
این مورد را می‌توان در فایل پیکربندی با format_selection_screen نیز تنظیم کرد.
گزینهٔ --format-sort برای استفاده در ytdl. این مورد را می‌توان در فایل پیکربندی با format_selection_sort نیز تنظیم کرد.
--video-pref=pref
تنظیم فرمت ویدیوی ytdl روی pref. این مورد را می‌توان در فایل پیکربندی با video_pref نیز تنظیم کرد.
تنظیم فرمت صوتی ytdl روی pref. این مورد را می‌توان در فایل پیکربندی با audio_pref نیز تنظیم کرد.
تنظیم فرمت ytdl روی pref. این مورد را می‌توان در فایل پیکربندی با ytdl_pref نیز تنظیم کرد.
جدا کردن پخش‌کنندهٔ ویدیو از ترمینال. این مورد را می‌توان در فایل پیکربندی با is_detach نیز تنظیم کرد.
تابع/برنامه برای استفاده به عنوان گردانندهٔ نشانی (url handler). این مورد را می‌توان در فایل پیکربندی با افزودن load_url_handler <handler> نیز تنظیم کرد.
به جای پخش ویدیوهای انتخاب‌شده، اطلاعات مربوط به آن‌ها را در فرمت مشخص‌شده دریافت می‌کند. گزینه‌های موجود عبارتند از:
نشانی وب (URL) ویدیوهای انتخاب‌شده را چاپ می‌کند.
داده‌های json ویدیوهای انتخاب‌شده را چاپ می‌کند.
داده‌های json تمام ویدیوهای موجود در نتایج جستجو را چاپ می‌کند.
فرمت ویدیوی در حال استفاده را چاپ می‌کند.
داده‌های ویدیوهای انتخاب‌شده را همان‌طور که در منو نمایش داده می‌شود چاپ می‌کند.
نام مستعار برای -I L
عملی که باید در هنگام ۱ بودن --info-wait انجام شود. info_wait_action.
تعیین این‌که آیا پس از چاپ اطلاعات درخواست‌شده با -I یا -L درنگ شود یا خیر. این مورد را می‌توان در فایل پیکربندی با info_wait نیز تنظیم کرد.
--url-handler-opts=opts
گزینه‌هایی که باید به گردانندهٔ نشانی ارسال شوند؛ به طور پیش‌فرض این کار گزینه‌های اضافی را به mpv ارسال می‌کند. این مورد را می‌توان در فایل پیکربندی با url_handler_opts نیز تنظیم کرد.

گزینه‌های منو

باز کردن مجدد منو هنگامی که پخش ویدیو متوقف می‌شود. این مورد را می‌توان در فایل پیکربندی با is_loop نیز تنظیم کرد.
انجام جستجوی دیگر پس از بستن fzf. این مورد را می‌توان در فایل پیکربندی با search_again نیز تنظیم کرد.
نمایش تصاویر بندانگشتی (thumbnails). با -D یا -H کار نمی‌کند. این مورد را می‌توان در فایل پیکربندی با show_thumbnails نیز تنظیم کرد.
تعیین بارگیری ناهمگام تصاویر بندانگشتی.
بارگیری ناهمگام باعث می‌شود منو پیش از اتمام بارگیری همهٔ تصاویر بندانگشتی باز شود. این مورد را می‌توان در فایل پیکربندی با async_thumbnails نیز تنظیم کرد.
تعیین صرف‌نظر کردن از بارگیری تصاویر بندانگشتی. این گزینه در صورتی استفاده می‌شود که نخواهید تصویر بندانگشتی داشته باشید، یا بخواهید از تصاویر بندانگشتی سفارشی در $YTFZF_CUSTOM_THUMBNAILS_DIR استفاده کنید.
برای اطلاعات بیشتر بخش CUSTOM THUMBNAILS را در ytfzf(5) ببینید
این مورد را می‌توان در فایل پیکربندی با skip_thumb_download نیز تنظیم کرد.
نمایش اعلان‌ها هنگامی که یک ویدیو در آستانهٔ پخش است، و سایر اعلان‌های مربوط به پخش ویدیوها. این مورد را می‌توان در فایل پیکربندی با notify_playing نیز تنظیم کرد.
جهت پیش‌نمایش در fzf.
گزینه‌ها:
این مورد را می‌توان در فایل پیکربندی با fzf_preview_side نیز تغییر داد.
استفاده از برنامه برای نمایش تصاویر بندانگشتی.
برنامه‌های توکار: chafa,chafa-16,chafa-tty ‏chafa،‏ chafa با ۱۶ رنگ، chafa با ۴ رنگ.
‏catimg،‏ catimg با ۲۵۶ رنگ.
مناسب برای مدیر پنجره‌های کاشی‌ساز (tiling).
مشابه imv.
تنها روی کامپوزیتور وی‌لند sway کار می‌کند.
تنها روی کامپوزیتور hyprland کار می‌کند. برای رندر و نمایش تصویر از swayimg استفاده می‌کند.
<custom>
نمایش‌دهنده‌های دیگر را می‌توان درون $YTFZF_THUMBNAIL_VIEWERS_DIR قرار داد.
این مورد را می‌توان در فایل پیکربندی نیز با افزودن عبارت زیر تغییر داد:
load_thumbnail_viewer <viewer>.
استفاده از یک منوی خارجی به جای fzf. پیش‌فرض dmenu است. این مورد را می‌توان در فایل پیکربندی نیز با عبارت زیر تنظیم کرد: interface="ext".
استفاده از یک اسکریپت واسط سفارشی که در $YTFZF_CUSTOM_INTERFACES_DIR قرار دارد. این مورد را می‌توان در فایل پیکربندی نیز با افزودن عبارت زیر تنظیم کرد: load_interface <interface>.
مرتب‌سازی ویدیوها (پس از استخراج اطلاعات) بر پایه تاریخ بارگذاری. این مورد را می‌توان در فایل پیکربندی نیز با افزودن عبارت زیر تنظیم کرد: is_sort.
--sort-name=name
تابعی را که در $YTFZF_CONFIG_FILE مشخص شده فراخوانی می‌کند، یا اسکریپتی را در $YTFZF_SORT_NAMES_DIR (در صورت وجود) بارگذاری (source) می‌کند. برای اطلاعات بیشتر بخش SORT NAMES در ytfzf(5) را ببینید.
تعیین قرار گرفتن یا نگرفتن جداکننده میان هر اشتراک (subscription). هنگامی که از این گزینه استفاده می‌شود، به طور خودکار --sort غیرفعال می‌گردد، زیرا باعث اختلال در این گزینه می‌شود.
این مورد را می‌توان در فایل پیکربندی نیز با عبارت زیر تنظیم کرد: fancy_subs.
تعیین غیرفعال بودن یا نبودن دکمه بازگشت در زیرمنوها.
این مورد را می‌توان در فایل پیکربندی نیز با عبارت زیر تنظیم کرد: enable_back_button. --disable-actions تعیین غیرفعال بودن یا نبودن اقداماتی مانند زیرمنوها و دکمه بازگشت.
این مورد را می‌توان در فایل پیکربندی نیز با عبارت زیر تنظیم کرد: enable_actions.
تعیین غیرفعال بودن یا نبودن زیرمنوها.
زیرمنوها منوهایی هستند که پس از انتخاب یک فهرست‌پخش یا کانال (در حال حاضر تنها توسط youtube/invidious پشتیبانی می‌شود) نمایش داده می‌شوند.
این مورد را می‌توان در فایل پیکربندی نیز با عبارت زیر تنظیم کرد: enable_submenus.
تعیین ارسال شدن یا نشدن گزینه‌های داده‌شده به ytfzf به زیرمنوها. این مورد را می‌توان در فایل پیکربندی نیز با عبارت زیر تنظیم کرد: keep_vars.
گزینه‌های مورد استفاده در زیرمنو.
این مورد را می‌توان در فایل پیکربندی نیز با عبارت زیر تنظیم کرد: submenu_opts.
منسوخ‌شده (به جای آن از --submenu-opts استفاده کنید) کاری مشابه با --submenu-opts انجام می‌دهد.
این مورد را می‌توان در فایل پیکربندی نیز با عبارت زیر تنظیم کرد: submenu_scraping_opts.

انتخاب خودکار

پخش خودکار نخستین نتیجه.
انتخاب همه نتایج.
پخش خودکار یک نتیجه تصادفی.
پخش خودکار یک ویدیوی مشخص.
مثال‌ها:
2
انتخاب دومین ویدیو
$
انتخاب آخرین ویدیو
/^h/
انتخاب همه ویدیوهایی که با h آغاز می‌شوند
تعداد (number) ویدیوها برای انتخاب با -a یا -r.

اسکریپرها (Scrapers)

تعیین اسکریپر مورد استفاده. می‌توان چند اسکریپر را با کاما (,) جدا کرد. اسکریپرهای توکار که در حال حاضر پشتیبانی می‌شوند عبارتند از:
اطلاعات API سرویس invidious را با یک عبارت جستجو استخراج می‌کند.
اطلاعات یک کانال یوتیوب را با استفاده از youtube استخراج می‌کند.
اطلاعات یک کانال یوتیوب را با $invidious_instance استخراج می‌کند.
هنگامی که این اسکریپر فعال است، عبارت جستجو پیوند به یک کانال خواهد بود.
ویدیوهای پیشنهادی را از پیوند یک ویدیوی invidious دریافت می‌کند.
اطلاعات یک فهرست‌پخش یوتیوب را دریافت می‌کند.
هنگامی که این اسکریپر فعال است، عبارت جستجو پیوند به یک فهرست‌پخش خواهد بود.
youtube-trending|T
اطلاعات API سرویس invidious را برای دریافت ویدیوهای پرطرفدار (ترند) یوتیوب استخراج می‌کند.
هنگامی که این اسکریپر فعال است، عبارت جستجو زبانه ترند مورد نظر برای استخراج است.
اطلاعات حاصل از استخراج قبلی را که با استفاده از --keep-cache ذخیره شده بود، از حافظه موقت (کَش) بازیابی می‌کند.
استفاده بازگشتی از ytfzf برای دریافت چند مورد با گزینه‌های مختلف متعدد.
برای اطلاعات بیشتر ytfzf -c M :help را ببینید.
زبانه200cها:
youtube-subscriptions|S|SI SI کانال‌ها را به جای youtube از invidious واکشی می‌کند. واکشی از youtube ممکن است منجر به محدودیت نرخ درخواست (rate limiting) شود.
از $YTFZF_SCRAPELIST_FILE شما به عنوان ورودی واکشی و جستجو استفاده می‌کند. برای اطلاعات بیشتر به «scrape lists» در ytfzf(5) مراجعه کنید.
(تنها در صورتی که $enable_hist فعال باشد)
نشانی url را در پخش‌کننده ویدیو باز کرده و خارج می‌شود
با url مانند یک مورد رفتار می‌کند و fzf یا منوی خارجی را باز خواهد کرد.
دیدگاه‌های یک پیوند ویدیویی را از youtube واکشی می‌کند
نام مستعار برای -c H.
فایل تاریخچه را واکشی می‌کند.
مشابه -c، اما واکشی پیش‌فرض را نیز نگه می‌دارد.
واکِش‌گر را از فهرست واکِش‌گرهای مورد استفاده حذف می‌کند
تعیین استفاده یا عدم استفاده از جستجوی چندگانه.
برای استفاده از جستجوی چندگانه، هر جستجو را با کاما جدا کنید؛ این قابلیت هنگام استفاده از چندین واکِش‌گر به خوبی عمل می‌کند.
این مورد همچنین می‌تواند در فایل پیکربندی با multi_search تنظیم شود.
هنگام استفاده از واکِش‌گر youtube، پیش از پخش یا بارگیری، پیوندهای invidious را به پیوندهای youtube تبدیل می‌کند.
هنگام استفاده از واکِش‌گر youtube، به جای تبدیل به پیوندهای youtube، از هر نمونهٔ invidious انتخاب‌شده استفاده می‌کند.

گزینه‌های واکِش‌گر (Scraper)

در حال حاضر، --video-duration، --type، --thumbnail-quality و --features تنها بر واکشی youtube/Y اعمال می‌شوند

تعداد صفحاتی که باید در youtube/invidious و واکِش‌گر دیدگاه‌ها (comments) واکشی شوند. این مقدار همچنین می‌تواند در فایل پیکربندی با pages_to_scrape تنظیم شود.
صفحه‌ای که واکشی از آن آغاز می‌شود. این مقدار همچنین می‌تواند در فایل پیکربندی با pages_start تنظیم شود.
تعداد رشته‌هایی (threads) که می‌توان برای واکشی جستجو، فهرست‌های پخش و کانال‌های youtube استفاده کرد. (این مورد برای واکِش‌گر اشتراک‌ها اعمال نمی‌شود).
این مقدار همچنین می‌تواند در فایل پیکربندی با max_thread_count تنظیم شود.
مقدار max_thread_count را برابر با ۱ قرار می‌دهد، که اثر آن مشابه تک‌رشته‌ای کردن همه چیز است. (این مورد برای واکِش‌گر اشتراک‌ها اعمال نمی‌شود).
این مقدار همچنین می‌تواند در فایل پیکربندی با max_thread_count=1 تنظیم شود.
--odysee-video-count=amount
تعداد ویدیوهایی که باید در odysee واکشی شوند. این مقدار همچنین می‌تواند در فایل پیکربندی با odysee_video_search_count تنظیم شود.
تعیین جستجو یا عدم جستجو برای ویدیوهای nsfw.
تنها با odysee/O کار می‌کند این مورد همچنین می‌تواند در فایل پیکربندی با nsfw تنظیم شود.
--sort-by=sort
با youtube/Y و odysee/O کار می‌کند.
برای استفاده از مرتب‌سازی متفاوت در هر واکشی، مرتب‌سازی‌ها را با کاما (,) جدا کنید.
برخلاف --sort، این عملیات در حین جستجو رخ می‌دهد، نه پس از آن. نتایج باید بر اساس موارد زیر مرتب شوند:
با youtube/Y و odysee/O کار می‌کند
برای استفاده از مرتب‌سازی زمانی متفاوت در هر واکشی، تاریخ‌ها را با کاما (,) جدا کنید.
جستجوی ویدیوها در بازهٔ زمانی گذشته:
--video-duration=duration
تعیین جستجو برای ویدیوهای طولانی یا کوتاه. گزینه‌های ممکن:
نوع نتایجی که باید دریافت شوند.
انتخاب کیفیت تصویر بندانگشتی (thumbnail). گزینه‌های در دسترس:
نخستین فریم ویدیو (کیفیت پایین)
فریم میانی ویدیو (کیفیت پایین).TP end فریم پایانی ویدیو (کیفیت پایین)
ویژگی‌هایی که ویدیو باید داشته باشد (با کاما از هم جدا شوند).
3d
4k
360
منطقه (کد کشور) برای جستجو.
پشتیبانی‌شده توسط اسکرپ‌های youtube/Y و youtube-trending/T

متفرقه

استفاده از یک نمونهٔ متفاوت invidious.
در صورت ارائهٔ این پرچم، حافظهٔ پنهان نمونه‌ها با نمونه‌های سالم با استفاده از Invidious API تازه‌سازی می‌شود.
نمونه‌های invidious قابل استفاده را چاپ کرده و خارج می‌شود.
--channel-link=link
پیوندهای کانال را از 'https://youtube.com/c/name' به 'https://youtube.com/channel/id' تبدیل می‌کند.
استفاده از تاریخچهٔ جستجو به جای یک جستجوی جدید. این مورد همچنین می‌تواند با search_source=hist در فایل پیکربندی تنظیم شود.
منبع مورد استفاده برای پرس‌وجوی جستجو. مقادیر معتبر عبارتند از:
args
استفاده از آرگومان‌های خط فرمان به عنوان جستجو (پیش‌فرض)
prompt
درخواست جستجو از طریق یک اعلان (prompt)
hist
استفاده از تاریخچهٔ جستجو.
next
استفادهٔ داخلی برای به‌کارگیری جستجوی بعدی در فهرست هنگامی که multi_search فعال باشد.
fn-args
استفادهٔ داخلی برای به‌کارگیری آرگومان‌های ارسالی به تابع به عنوان منبع.
<custom>
در صورت وجود تابعی با نام get_search_from_<source>، یک منبع جستجوی سفارشی می‌تواند استفاده شود. این تابع باید متغیر _search را روی یک جستجو تنظیم کند.
پاک کردن تاریخچهٔ جستجو و تماشا (در صورت استفاده از -x یا --history-clear)
برای مشخص کردن تاریخچهٔ جستجو یا تماشا از --history-clear=<search|watch> استفاده کنید
نگه‌داشتن یا عدم نگه‌داشتن حافظهٔ پنهان پس از پایان کار ytfzf . این مورد همچنین می‌تواند با keep_cache در فایل پیکربندی تنظیم شود.
ارسال گزینه‌های خط فرمان به youtube-dl هنگام بارگیری. 
مثال: --ytdl-opts=
مسیر youtube-dl یا یک انشعاب از youtube-dl را برای بارگیری مشخص می‌کند.
این مورد همچنین می‌تواند با ytdl_path در فایل پیکربندی تنظیم شود.
بارگذاری یک افزونه.
همچنین می‌توانید load_extension extension را به فایل پیکربندی خود اضافه کنید.
تمام افزونه‌ها را فهرست کرده و خارج می‌شود.
فایلی را برای ثبت اطلاعات اشکال‌زدایی تصویر بندانگشتی تعیین می‌کند. این مورد همچنین می‌تواند با thumbnail_debug_log در فایل پیکربندی تنظیم شود. رفتار پیش‌فرض ytfzf را می‌توان با تغییر دادن فایل پیکربندی دگرگون کرد. برای اطلاعات بیشتر ytfzf(5) را ببینید.

چند نوع افزونه وجود دارد:
interfaces (-i, --interface)
scrapers (-c, --scrape)
sort-names (--sort-name)
thumbnail-viewers (-T, --thumb-viewer)
url-handlers (-u, --url_handler)
extensions (-e, --ext)

برای نصب یک افزونه، آن را در مسیر زیر قرار دهید: $YTFZF_SYSTEM_ADDON_DIR/<addon-type>/addon-name

برای استفاده از یک افزونه، از یکی از گزینه‌های ذکرشده در بالا استفاده کنید، یا این خطوط را
load_interface <interface>
scrape=<scraper>
load_sort_name <sort-name>
load_thumbnail_viewer <viewer>
load_url_handler <url-handler>
load_extension <ext>
در فایل پیکربندی خود قرار دهید.

0
موفقیت
1
خطای عمومی
2
گزینه (--option) نامعتبر، مقدار نامعتبر برای گزینه، یا خطای پیکربندی.
3
وابستگی ناموجود
5
جستجوی خالی

$YTFZF_CONFIG_DIR
دایرکتوری ذخیره فایل‌های پیکربندی. پیش‌فرض عبارت است از $XDG_CONFIG_HOME/ytfzf (یا ~/.config/ytfzf)
$YTFZF_CONFIG_FILE
فایل پیکربندی مورد استفاده. پیش‌فرض عبارت است از $YTFZF_CONFIG_DIR/conf.sh
$YTFZF_SUBSCRIPTIONS_FILE
فایل اشتراک‌های مورد استفاده. پیش‌فرض عبارت است از $YTFZF_CONFIG_DIR/subscriptions
$YTFZF_SCRAPELIST_FILE
فایل فهرست واکشی (scrapelist) مورد استفاده. پیش‌فرض عبارت است از $YTFZF_CONFIG_DIR/scrapelist
$YTFZF_THUMBNAIL_VIEWERS_DIR
دایرکتوری نگهداری نمایش‌دهنده‌های تصویر بندانگشتی اضافی. پیش‌فرض عبارت است از $YTFZF_CONFIG_DIR/thumbnail-viewers
$YTFZF_CUSTOM_SCRAPERS_DIR
دایرکتوری برای ذخیره اسکریپت‌های اسکرپر سفارشی. پیش‌فرض عبارت است از $YTFZF_CONFIG_DIR/scrapers
$YTFZF_CUSTOM_INTERFACES_DIR
دایرکتوری برای ذخیره اسکریپت‌های رابط سفارشی. پیش‌فرض عبارت است از $YTFZF_CONFIG_DIR/interfaces
$YTFZF_SORT_NAMES_DIR
دایرکتوری برای ذخیره اسکریپت‌های سفارشی sort-name. پیش‌فرض عبارت است از $YTFZF_CONFIG_DIR/sort-names
$YTFZF_URL_HANDLERS_DIR
دایرکتوری برای ذخیره گرداننده‌های سفارشی نشانی (url-handlers). پیش‌فرض عبارت است از $YTFZF_CONFIG_DIR/url-handlers
$YTFZF_CUSTOM_THUMBNAILS_DIR
دایرکتوری برای ذخیره تصاویر بندانگشتی سفارشی. پیش‌فرض عبارت است از $YTFZF_CONFIG_DIR/thumbnails
$YTFZF_EXTENSIONS_DIR
دایرکتوری برای ذخیره افزونه‌ها. پیش‌فرض عبارت است از $YTFZF_CONFIG_DIR/extensions
$YTFZF_SYSTEM_ADDON_DIR
دایرکتوری برای ذخیره افزونه‌های نصب‌شده سیستمی. پیش‌فرض بسته به نحوه نصب ytfzf ممکن است متفاوت باشد.
$YTFZF_CHECK_VARS_EXISTS
بررسی اینکه آیا متغیرها پیش از تعیین مقادیر پیش‌فرض در محیط تعریف شده‌اند یا خیر. پیش‌فرض عبارت است از 1
$YTFZF_TEMP_DIR
دایرکتوری موقت. پیش‌فرض عبارت است از $TMPDIR/ytfzf-$user-id.
اگر $TMPDIR تعریف نشده باشد، از /tmp استفاده خواهد شد..SH "فایل‌ها (FILES)"
~/.config/ytfzf/conf.sh
فایل پیکربندی. اگر submenu-conf.sh وجود نداشته باشد، این فایل به عنوان پیکربندی در زیرمنوها نیز استفاده خواهد شد.
~/.config/ytfzf/submenu-conf.sh
فایل پیکربندی زیرمنو.
~/.config/ytfzf/subscriptions
فایل اشتراک‌ها.

هر نمونه از ytfzf دایرکتوری اختصاصی خود را در $YTFZF_TEMP_DIR دارد؛ اگر $keep_cache فعال باشد، در عوض از $cache_dir استفاده می‌کند.
ساختار پوشه هر نمونه به این صورت است: (<> نشان‌دهنده جای‌نگه‌دار و ? به معنای اختیاری است)
اگر یک افزونه اسکریپر (scraper) به کار رود، ممکن است از فایل‌های مستندنشده استفاده کند.

$cache_dir
| -- watch_hist
| -- <search>-<pid>
|  | -- created-at
|  | -- searches.list
|  | -- post-scrape
|  | -- <submenu-search>-<submenu-pid>?
|  | -- thumbnails?
|  | -- environment
|  | -- tmp
|  |  | -- curl_config
|  |  | -- <scrape>.html
|  |  | -- <scrape>.json
|  |  | -- <scrape>.json.final?
|  |  | -- menu_keypress
|  |  | -- all-ids.list
|  |  | -- downloaded-ids.list
|  | -- ids
|  | -- videos_json

توضیح هر دایرکتوری/فایل:

حاوی برچسب زمان یونیکس (unix timestamp) در زمان ایجاد پوشه است.
فهرستی از تمام جستجوها.
اگر --multi-search فعال باشد، هر جستجو با یک خط جدید جدا می‌شود.
فایل تاریخچه تماشا.
<search>-<pid>
پوشه والد یک نمونه.
اگر جستجویی مشخص نشده باشد، در عوض از نام “SCRAPE-<scrape>-<pid>” استفاده می‌کند.
پوشه‌ای شامل فایل‌های مربوط به واکشی (scraping) یک نتیجه انتخاب‌شده.
<submenu-search>-<submenu-pid>
زمانی که یک زیرمنو باز می‌شود ایجاد می‌گردد (برای مثال: وقتی یک کانال/لیست‌پخش انتخاب شود).
تصاویر بندانگشتی را برای نمونه ذخیره می‌کند (فقط با -t).
تمام متغیرهایی که در آن نمونه از ytfzf تنظیم شده‌اند و مقادیر آن‌ها.
فایل‌های موقت با اهمیت کمتر را ذخیره می‌کند.
فایل پیکربندی curl برای دانلود بندانگشتی‌ها (فقط با -t).
<scrape>.html
برای اسکریپرهایی که نیاز به واکشی وبگاه‌ها دارند، این خروجی curl است.
<scrape>.json
فایل json واکشی‌شده از وبگاه.
<scrape>.json.final
فایل json نهایی واکشی‌شده از وبگاه. (زمانی استفاده می‌شود که از چندین ریسه (thread) برای واکشی استفاده شود)
کلید فشرده‌شده در fzf.
فایلی شامل تمام شناسه‌های واکشی‌شده. عمدتاً جهت مقایسه با downloaded-ids.json.
فایلی شامل مشخصات بندانگشتی‌های دانلودشده.
فایلی که شناسه هر ویدئوی انتخاب‌شده را ذخیره می‌کند.
فایلی که یک json از تمام ویدیوهای نمایش داده‌شده در fzf را ذخیره می‌کند.
این فایل به دلیل داشتن قالبی مشابه، برای ساخت لیست‌های پخش بسیار مفید است..SH "نویسندگان (AUTHORS)" در ابتدا توسط pystardust نوشته شده است. <https://github.com/pystardust>

باگ‌ها را در GitHub گزارش دهید: <https://github.com/pystardust/ytfzf/issues>

ytfzf(5) youtube-dl(1), mpv(1) fzf(1) dmenu(1)

نرم‌افزار ytfzf یک نرم‌افزار آزاد است: می‌توانید آن را تحت شرایط GNU General Public License نسخه ۳ همان‌طور که توسط بنیاد نرم‌افزار آزاد منتشر شده است، بازتوزیع کرده و/یا تغییر دهید.

نرم‌افزار ytfzf با این امید توزیع شده است که مفید واقع شود، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابلیت فروش یا مناسب بودن برای یک هدف خاص. برای جزئیات بیشتر به GNU General Public License مراجعه کنید.

شما باید به همراه ytfzf نسخه‌ای از GNU General Public License را دریافت کرده باشید. اگر دریافت نکرده‌اید، ببینید: <https://www.gnu.org/licenses>.

سپتامبر 2021 ytfzf 2.0