نام (NAME)

feh — نمایشگر تصویر و ابزار فهرست‌نویسی سبک و همه‌کاره

خلاصه دستور (SYNOPSIS)

feh [options] [--] [files | directories | URLs ...]

نسخه (VERSION)

این راهنما نسخه feh 3.12.4 را مستند می‌کند.

سوئیچ‌های زمان کامپایل در این ساخت:

• پشتیبانی از فایل‌های دوردست با libcurl فعال است
• پشتیبانی از چند مانیتور با Xinerama فعال است
• خواننده توکار EXIF با libexif در دسترس است
• بارگذاری مجدد خودکار فایل‌های تغییریافته بر پایه inotify فعال است
• پشتیبانی از libmagic فعال است

توضیحات (DESCRIPTION)

feh یک نمایشگر تصویر سبک‌وزن، قابل‌پیکربندی و چندمنظوره است. این ابزار کاربران خط فرمان را هدف قرار داده است، اما از طریق مدیران فایل گرافیکی نیز قابل اجرا است. جدا از نمایش تصاویر، می‌تواند فهرست‌های متنی و تصاویر بندانگشتی ایجاد کند، فایل‌های قابل‌بارگذاری (یا غیرقابل‌بارگذاری) را نمایش دهد، تصویر پس‌زمینه X11 را تنظیم نماید و کارهای دیگر.

ویژگی‌ها شامل فهرست‌های فایل، حالت‌های گوناگون مرتب‌سازی تصویر، اسکریپت‌های سفارشی برای عملیات و زیرنویس تصاویر است. feh می‌تواند با میانبرهای صفحه‌کلید و ماوس قابل‌تنظیم، ورودی ترمینال و سیگنال‌ها کنترل شود. هنگامی که هیچ آرگومان فایل یا فهرست فایلی مشخص نشده باشد و از --start-at استفاده نشود، feh تمام فایل‌های موجود در دایرکتوری جاری را نمایش می‌دهد.

برچسب‌های EXIF با استفاده از exiv2 / exifgrep از طریق --info (بخش مثال‌های کاربردی (USAGE EXAMPLES) را ببینید), یا به عنوان یک قابلیت توکار با کامپایل feh با exif=1 پشتیبانی می‌شوند. در این ساخت از feh، پشتیبانی توکار از EXIF در دسترس است.

حالت‌ها (MODES)

feh بر پایه چندین حالت گوناگون عمل می‌کند که هنگام راه‌اندازی با گزینه‌های خط فرمان انتخاب می‌شوند.

حالت نمایش اسلایدی (Slideshow) حالت پیش‌فرض است. این حالت یک پنجره باز کرده و اولین تصویر را در آن نمایش می‌دهد؛ موقعیت اسلایدشو می‌تواند با کلیدهای میانبر صفحه‌کلید و ماوس جلو برود (یا به شکل دیگری تغییر کند). در حالت اسلایدشو، تصاویر را می‌توان از فهرست فایل یا از دیسک حذف کرد؛ یک فهرست فایل تغییریافته را می‌توان در دیسک ذخیره کرد و بعداً دوباره باز نمود. همچنین می‌توان یک تصویر را با "feh -" از ورودی استاندارد (stdin) خواند.

حالت کلاژ (Montage) یک تصویر کلاژ/مونتاژ از فهرست فایل‌ها می‌سازد. تصویر حاصل را می‌توان مشاهده یا ذخیره کرد، و اندازه آن را می‌توان بر حسب ارتفاع، عرض یا هر دو محدود کرد.

حالت نمایه (Index) یک خروجی چاپی نمایه‌ای از فهرست فایل‌ها می‌سازد. تصاویر بندانگشتی به همراه نام فایل، اندازه و ابعاد، با استفاده از قلم TrueType به انتخاب شما چاپ می‌شوند. تصویر حاصل را می‌توان مشاهده یا ذخیره کرد، و اندازه آن می‌تواند با ارتفاع، عرض یا هر دو محدود شود.

حالت بندانگشتی (Thumbnail) مانند حالت نمایه است، اما تصاویر بندانگشتی قابل‌کلیک هستند و تصویر انتخاب‌شده را در یک پنجره جدید باز می‌کنند.

حالت چندپنجره‌ای (Multiwindow) تصاویر را به‌جای یک اسلایدشو در یک پنجره، در چندین پنجره مجزا نمایش می‌دهد. با یک فهرست فایل بزرگ استفاده نکنید ;)

حالت فهرست (List) تصاویر را نمایش نمی‌دهد. در عوض، فهرستی به سبک ls-style از فایل‌های موجود در فهرست فایل خروجی می‌دهد، از جمله اطلاعات تصویر مانند اندازه، تعداد پیکسل، نوع و غیره. همچنین حالت Customlist وجود دارد که اطلاعات تصویر را در قالبی سفارشی که با یک رشته قالب‌بندی شبه-printf مشخص شده است، چاپ می‌کند.

feh همچنین می‌تواند تمام فایل‌های قابل‌بارگذاری در یک فهرست فایل یا تمام فایل‌های غیرقابل‌بارگذاری را فهرست کند. این قابلیت برای پاک‌سازی و مرتب‌سازی یک دایرکتوری مفید است.

قالب‌های پشتیبانی‌شده (SUPPORTED FORMATS)

feh می‌تواند هر قالبی را که توسط imlib2 پشتیبانی می‌شود باز کند، به‌ویژه jpeg، png، pnm، tiff و bmp. قالب gif نیز پشتیبانی می‌شود، اما تنها برای تصاویر ثابت. در مورد پویانمایی‌ها، تنها فریم نخست نمایش داده خواهد شد.

هنگام اجرا با --conversion-timeout timeout (و یک مقدار timeout نامنفی) ، feh همچنین با استفاده از برنامه‌های تبدیل خارجی، پشتیبانی محدودی از انواع فایل‌های دیگر دارد. اگر باینری dcraw در دسترس باشد، feh از آن برای نمایش تصاویر بندانگشتی تعبیه‌شده در فایل‌های RAW ارائه‌شده توسط دوربین‌های دیجیتال و موارد مشابه استفاده خواهد کرد. اگر باینری convert از برنامه ImageMagick در دسترس باشد، feh از آن برای بارگذاری انواع فایل مانند svg، xcf و otf استفاده می‌کند.

(قابلیت اختیاری، فعال در این ساخت) feh می‌تواند از libmagic استفاده کند تا فقط فایل‌های تصویری را به Imlib2 ارسال کند. هنگام استفاده از feh با تعداد زیادی فایل غیرتصویری (به‌ویژه با نسخه 1.6.x یا 1.7.0 از Imlib2 ،) این قابلیت می‌تواند سرعت تشخیص فایل‌های غیرتصویری را به‌طور چشمگیری افزایش دهد. اگر احساس می‌کنید Imlib2 می‌تواند فایلی را بارگذاری کند که feh آن را احتمالاً غیرتصویری تشخیص داده است، متغیر محیطی "FEH_SKIP_MAGIC" را تنظیم کنید تا تمام فایل‌ها بدون این بررسی مستقیماً به Imlib2 ارسال شوند. مقدار متغیر محیطی اهمیتی ندارد، تنها کافی است مقداردهی شده باشد.

گزینه‌ها (OPTIONS)

-A, --action [flag][[title]]action

مشخص کردن یک دستور شل به عنوان عملیاتی که روی تصویر اجرا شود. در حالت‌های اسلایدشو یا چندپنجره‌ای، هنگامی که کلید action_0 (پیش‌فرض: Return) فشار داده شود، این عملیات اجرا خواهد شد. در حالت فهرست، برای هر فایل، و در حالت‌های قابل‌بارگذاری/غیرقابل‌بارگذاری، به ترتیب برای هر فایل قابل‌بارگذاری/غیرقابل‌بارگذاری اجرا می‌شود. در حالت بندانگشتی، کلیک کردن روی یک تصویر به جای باز کردن آن، باعث اجرای عملیات خواهد شد.

اگر flag برابر با ";" باشد، feh به جای رفتن به تصویر بعدی (در حالت اسلایدشو) یا بستن پنجره (در حالت چندپنجره‌ای ،) پس از اجرای عملیات، تصویر فعلی را دوباره بارگذاری می‌کند. اگر [title] مشخص شده باشد (به نویسه‌های لفظی "[" و "]" توجه کنید ،) گزینه --draw-actions به جای action عنوان title را در فهرست عملیات نمایش خواهد داد. توجه داشته باشید که title نباید با فاصله شروع شود. اگر با فاصله شروع شود، به گونه‌ای رفتار می‌شود که گویی عملیات فاقد عنوان است. این حالت خاص برای سازگاری با نسخه‌های پیشین در نظر گرفته شده است و تضمین می‌کند که عملیاتی مانند "[ -L %F ] && foo" همچنان کار کنند.

عملیات توسط /bin/sh اجرا خواهد شد. برای ارجاع به اطلاعات تصویر از مشخص‌کننده‌های قالب استفاده کنید، برای جزئیات بخش مشخص‌کننده‌های قالب (FORMAT SPECIFIERS) را ببینید. نمونه کاربرد: "feh -A "mv -n %F ~/images/%N" *".

--action1 .. --action9 [flag][[title]]action

عملیات‌های اضافی که می‌توان آن‌ها را با استفاده از کلید عددی متناظر تنظیم و فعال کرد.

--auto-reload

(قابلیت اختیاری، فعال در این ساخت) بارگذاری خودکار تصویر هنگامی که فایل اصلی آن تغییر کند. توجه داشته باشید که بارگذاری مجدد خودکار (در صورت فعال بودن در ساخت برنامه) به صورت پیش‌فرض فعال است. این گزینه تنها برای فعال‌سازی مجدد بارگذاری خودکار پس از غیرفعال شدن توسط گزینه قبلی --reload=0 مفید است.

بارگذاری خودکار در حالت‌های کلاژ، نمایه یا بندانگشتی پشتیبانی نمی‌شود.

--auto-rotate

(قابلیت اختیاری، موجود در این ساخت) (منسوخ‌شده به نفع پشتیبانی جهت‌یابی خودکار در Imlib2) چرخش خودکار تصاویر بر اساس داده‌های EXIF. فایل‌های تصویر را تغییر نمی‌دهد.

توجه داشته باشید که Imlib2 نسخه +1.7.5 چرخش خودکار را خودش انجام می‌دهد، بنابراین این گزینه در سیستم‌های دارای Imlib2 نسخه 1.7.5 یا بالاتر منسوخ است. feh در حال حاضر نمی‌تواند این موضوع را در زمان اجرا تشخیص دهد.

-Z, --auto-zoom

بزرگ‌نمایی تصاویر به اندازه صفحه نمایش در حالت تمام‌صفحه / ابعاد هندسی ثابت.

-x, --borderless

ایجاد پنجره‌های بدون حاشیه.

--cache-size size

تنظیم حافظه موقت (کش) درون‌حافظه‌ای imlib2 بر حسب size مگابایت (MiB). اندازه کش بزرگ‌تر می‌تواند کارایی را به‌ویژه برای اسلایدشوهای کوچک بهبود دهد، اما به هزینه مصرف حافظه بیشتر. size باید بین 0 تا 2048 مگابایت باشد و مقدار پیش‌فرض آن 4 است.

-P, --cache-thumbnails

فعال‌سازی ذخیره‌سازی موقت تصاویر بندانگشتی. تصاویر بندانگشتی در مسیر $XDG_CACHE_HOME/thumbnails ذخیره می‌شوند که پیش‌فرض آن ~/.cache/thumbnails است. توجه داشته باشید که تصاویر بندانگشتی تنها در صورتی کش می‌شوند که اندازه بندانگشتی پیکربندی‌شده از 256x256 پیکسل تجاوز نکند.

-K, --caption-path path

مسیر دایرکتوری حاوی زیرنویس تصاویر. این گزینه نمایش زیرنویس را فعال می‌کند و اگر زیرنویس در path (که نسبت به دایرکتوری هر تصویر سنجیده می‌شود) پیدا شود، روی تصویر نمایش‌داده‌شده قرار می‌گیرد. به عنوان مثال با مسیر زیرنویس "captions/" و مشاهده تصویر "images/foo.jpg ،" زیرنویس در مسیر "images/captions/foo.jpg.txt" جستجو خواهد شد.

--conversion-timeout timeout

برنامه feh می‌تواند از ImageMagick برای تبدیل فایل‌های غیرقابل‌بارگذاری به یک قالب فایل پشتیبانی‌شده استفاده کند. از آنجا که این کار ممکن است زمان زیادی ببرد، به‌طور پیش‌فرض غیرفعال است. مقدار timeout را روی یک مقدار نامنفی تنظیم کنید تا فعال شود. یک مقدار مثبت تعیین می‌کند پس از چند ثانیه تلاش‌های تبدیل متوقف شوند؛ مقدار صفر باعث می‌شود feh به طور نامحدود تلاش کند. مقادیر منفی با غیرفعال کردن کامل فرایند تبدیل، حالت پیش‌فرض را بازمی‌گردانند.

--class class

تنظیم مقدار کلاس X11 روی class. پیش‌فرض: feh

-L, --customlist format

تصاویر را نمایش ندهید، در عوض اطلاعات تصویر را مطابق با format چاپ کنید. بخش مشخص‌کننده‌های قالب (FORMAT SPECIFIERS) را ببینید.

-G, --draw-actions

رسم عملیات‌های تعریف‌شده و کاری که انجام می‌دهند در گوشه بالا سمت چپ تصویر.

--draw-exif

(قابلیت اختیاری، موجود در این ساخت) نمایش برخی اطلاعات EXIF در گوشه پایین سمت چپ، مشابه استفاده از --info همراه با exiv2 / exifgrep.

-d, --draw-filename

نمایش نام فایل در گوشه بالا سمت چپ تصویر.

--draw-tinted

نمایش متن‌های روی تصویر (ایجادشده توسط --draw-filename و غیره) روی یک پس‌زمینه نیمه‌شفاف برای بهبود خوانایی آن‌ها.

--edit

فعال‌سازی ویرایش پایه‌ای فایل‌ها. این کار باعث می‌شود چرخش و قرینه‌سازی (متصل‌شده به کلیدهای "<" ، ">" ، "|" و "_" به‌طور پیش‌فرض) فایل اصلی روی دیسک را تغییر دهد و نه فقط تصویر نمایش‌داده‌شده را.

-f, --filelist file

این گزینه مشابه فهرست‌های پخش در نرم‌افزارهای پخش موسیقی است. اگر file وجود داشته باشد، برای خواندن فهرستی از فایل‌ها جهت بارگذاری به ترتیبی که نوشته شده‌اند خوانده خواهد شد. قالب آن فهرستی از نام فایل‌های تصویری، به‌صورت مطلق یا نسبی نسبت به پوشه جاری، یک نام فایل در هر خط است.

اگر file وجود نداشته باشد، در پایان نشست نمایش، از روی فهرست فایل‌های داخلی ایجاد خواهد شد. این قابلیت برای ذخیره نتایج مرتب‌سازی‌های پیچیده (مانند -Spixels) برای مشاهده در آینده بسیار مناسب است.

هرگونه تغییری در فهرست فایل‌های داخلی (مانند حذف یک فایل یا هرس شدن آن به دلیل غیرقابل‌بارگذاری بودن) در هنگام خروج feh در file ذخیره خواهد شد. می‌توانید با تعیین فایل‌ها در خط فرمان همزمان با تعیین لیست، آن‌ها را به فهرست فایل اضافه کنید.

اگر file برابر با "-" باشد، feh فهرست فایل را از ورودی استاندارد خود خواهد خواند.

-e, --font font

تنظیم قلم عمومی (global font). باید یک قلم TrueType موجود در دایرکتوری جاری یا پوشه قلم‌ها باشد و به شکل fontname/size تعریف شود، مانند "yudit/12" (که مقدار پیش‌فرض است).

-C, --fontpath path

تعیین path به عنوان دایرکتوری اضافی برای جستجوی قلم‌ها؛ می‌تواند چندین بار برای افزودن چندین مسیر استفاده شود.

--tap-zones

فعال‌سازی نواحی لمسی برای فایل قبلی/بعدی در حالت اسلایدشو.

--force-aliasing

غیرفعال کردن صاف‌کردن لبه‌ها (anti-aliasing) برای بزرگ‌نمایی، تنظیم پس‌زمینه و غیره.

-I, --fullindex

مشابه حالت نمایه، اما با اطلاعات اضافی زیر تصاویر بندانگشتی. دقیقاً مانند دستور زیر کار می‌کند: "feh --index --index-info "%n\n%S\n%wx%h"". گزینه‌های گزینه‌های حالت کلاژ (MONTAGE MODE OPTIONS) را فعال می‌کند.

نکته: این گزینه نیازمند بارگذاری تمام تصاویر برای محاسبه ابعاد پنجره feh است، بنابراین هنگام استفاده با فایل‌های بسیار، مدتی طول می‌کشد تا پنجره feh نمایان شود. از --preload برای دریافت نوار پیشرفت استفاده کنید.

-F, --fullscreen

تمام‌صفحه کردن پنجره. توجه داشته باشید که در این حالت، تصاویر بزرگ همیشه متناسب با اندازه صفحه کوچک می‌شوند، و --zoom zoom فقط روی تصاویر کوچک‌تر تأثیر می‌گذارد و هرگز بزرگ‌تر از اندازه لازم برای جا گرفتن در صفحه مقیاس‌بندی نمی‌کند. تنها استثنا مقدار zoom برابر 100 است که در این حالت تصاویر همیشه با بزرگ‌نمایی ۱۰۰٪ نشان داده می‌شوند.

هنگامی که با --thumbnails ترکیب شود، این گزینه تنها روی تصاویری که از نمای بندانگشتی باز می‌شوند تأثیر می‌گذارد. خود فهرست بندانگشتی همچنان در پنجره معمولی نمایش داده خواهد شد.

-g, --geometry width x height | + x + y | width x height + x + y

استفاده از یک اندازه پنجره ثابت مطابق رشته هندسی به سبک X string ، مانند 640x480. یک جابجایی اختیاری x+y+ برای پنجره نیز می‌تواند تعیین شود. برای کوچک کردن تصاویر بزرگتر همانند حالت تمام‌صفحه، آن را با --scale-down ترکیب کنید. توجه داشته باشید که این گزینه اندازه پنجره را تحمیل نمی‌کند؛ تغییر آن توسط مدیر پنجره کاشی‌کار یا به صورت دستی همچنان ممکن است. با این حال، تغییر اندازه خودکار غیرفعال می‌ماند.

-Y, --hide-pointer

پنهان کردن نشانگر ماوس (برای اسلایدشوها کاربرد دارد).

-B, --image-bg style

استفاده از style به عنوان پس‌زمینه برای بخش‌های شفاف تصویر و موارد مشابه. مقادیر پذیرفته‌شده: default، checks، یا یک رنگ XColor (مانند "black" یا "#428bdd"). توجه داشته باشید که برخی شل‌ها با نویسه مربع (#) مانند نویسه خاص رفتار می‌کنند، بنابراین ممکن است لازم باشد آن را نقل‌قول کنید یا با بک‌اسلش اسکیپ نمایید تا کد XColor به درستی کار کند. در حالت پنجره‌ای، مقدار پیش‌فرض checks است (یک پس‌زمینه شطرنجی تا بخش‌های شفاف تصویر به راحتی دیده شوند). در حالت‌های تمام‌صفحه و تنظیم پس‌زمینه، مقدار checks پذیرفته نمی‌شود و پیش‌فرض black است.

-i, --index

فعال‌سازی حالت نمایه (Index). حالت نمایه مشابه حالت کلاژ است و همان گزینه‌ها را می‌پذیرد. این حالت یک برگه نمایه از تصاویر بندانگشتی ایجاد می‌کند و نام تصویر را زیر هر بندانگشتی چاپ می‌کند. حالت نمایه برخی گزینه‌های دیگر را فعال می‌کند، بخش‌های گزینه‌های حالت نمایه و بندانگشتی (INDEX AND THUMBNAIL MODE OPTIONS) و گزینه‌های حالت کلاژ (MONTAGE MODE OPTIONS) را ببینید.

--info [flag]command_line

اجرای command_line و نمایش خروجی آن در گوشه پایین سمت چپ تصویر. می‌تواند مثلاً برای نمایش ابعاد تصویر یا اطلاعات EXIF استفاده شود. از بخش مشخص‌کننده‌های قالب (FORMAT SPECIFIERS) پشتیبانی می‌کند. اگر flag روی ";" تنظیم شود، خروجی به‌طور پیش‌فرض نمایش داده نمی‌شود، بلکه باید با کلید toggle_info فعال شود.

--insecure

هنگام مشاهده فایل‌ها با پروتکل HTTPS، این گزینه تمام بررسی‌های گواهی را غیرفعال می‌کند. اجازه می‌دهد تصاویر موجود در سایت‌های دارای گواهی‌های خودامضاشده یا منقضی‌شده باز شوند، اما امنیت آن بیشتر از HTTP ساده نیست.

-k, --keep-http

هنگام مشاهده فایل‌ها با استفاده از HTTP، برنامه feh به طور معمول نسخه‌های محلی را پس از مشاهده، یا در صورت کش شدن هنگام خروج حذف می‌کند. این گزینه آن‌ها را برای همیشه روی دیسک، یا در دایرکتوری مشخص‌شده توسط --output-dir ، یا در دایرکتوری کاری جاری ذخیره می‌کند.

--keep-zoom-vp

هنگام جابجایی بین تصاویر، تنظیمات بزرگ‌نمایی و درگاه دید (سطح بزرگ‌نمایی و جابجایی‌های X و Y) را حفظ می‌کند.

-l, --list

عدم نمایش تصاویر. آن‌ها را تجزیه و تحلیل کرده و فهرستی به سبک ls(1) نمایش می‌دهد. در اسکریپت‌ها برای یافتن تصاویری با اندازه/رزولوشن/نوع مشخص و غیره مفید است.

-U, --loadable

تصاویر را نمایش ندهید. فقط در صورتی که imlib2 بتواند آن‌ها را با موفقیت بارگذاری کند، نامشان را چاپ کنید. اگر حداقل یک تصویر در بارگذاری ناموفق باشد، مقدار false بازمی‌گرداند. هنگامی که با --action ترکیب شود، عملیات مشخص‌شده برای هر تصویر قابل‌بارگذاری اجرا خواهد شد.

--max-dimension width x height

فقط نمایش تصاویری با عرض <= width و ارتفاع <= height. اگر فقط به یکی از پارامترها اهمیت می‌دهید، دیگری را روی 0 (یا یک مقدار منفی) تنظیم کنید.

-M, --menu-font font

استفاده از font (قلم TrueType، همراه با اندازه، مانند "yudit/12") به عنوان قلم منو.

--min-dimension width x height

فقط نمایش تصاویری با عرض >= width و ارتفاع >= height. اگر فقط به یکی از پارامترها اهمیت می‌دهید، دیگری را روی 0 بگذارید.

-m, --montage

فعال‌سازی حالت کلاژ (Montage). حالت کلاژ یک تصویر جدید متشکل از یک شبکه از تصاویر بندانگشتی مربوط به تصاویر فهرست فایل ایجاد می‌کند. هنگامی که حالت کلاژ انتخاب می‌شود، گزینه‌های معین دیگری در دسترس قرار می‌گیرند. بخش گزینه‌های حالت کلاژ (MONTAGE MODE OPTIONS) را ببینید.

-w, --multiwindow

غیرفعال کردن حالت اسلایدشو. با این تنظیم، به‌جای باز کردن چندین فایل در حالت اسلایدشو، چندین پنجره باز خواهد شد؛ یک پنجره به ازای هر فایل.

--no-conversion-cache

هنگام بارگذاری تصاویر از طریق HTTP، ImageMagick یا dcraw، برنامه feh آن‌ها را تنها یک بار بارگذاری/تبدیل می‌کند و در گذرهای بعدی اسلایدشو از فایل کش‌شده استفاده مجدد می‌نماید. این گزینه حافظه پنهان را غیرفعال می‌کند. همچنین زمانی که از --reload استفاده شود غیرفعال می‌گردد. اگر با فایل‌هایی کار می‌کنید که از طریق یکی از این منابع به طور مکرر تغییر می‌کنند از آن استفاده کنید. توجه داشته باشید که عملکرد را کاهش می‌دهد.

--no-jump-on-resort

پس از مرتب‌سازی مجدد فهرست فایل‌ها، به تصویر اول نپرید.

-N, --no-menus

هیچ منویی را بارگذاری یا نمایش ندهید.

--no-screen-clip

به طور پیش‌فرض، اندازه پنجره‌ها به اندازه صفحه نمایش محدود است. با این گزینه، پنجره‌ها به اندازه تصویر درون خود خواهند بود. توجه داشته باشید که پنجره‌ها ممکن است از این طریق بسیار بزرگ شوند و در برخی مدیران پنجره غیرقابل مدیریت گردند.

--no-xinerama

(قابلیت اختیاری، فعال در این ساخت) غیرفعال کردن پشتیبانی از Xinerama.

--on-last-slide hold | quit | resume

انتخاب رفتار برنامه هنگامی که تلاش می‌شود در آخرین اسلاید به تصویر بعدی (یا در اولین اسلاید به تصویر قبلی) در یک اسلایدشو بروید.

با مقدار hold ، برنامه feh در این حالت از پیشروی بازمی‌ماند و به نمایش تصویر اول/آخر ادامه می‌دهد. این حالت برای اسلایدشوهای خطی در نظر گرفته شده است. هنگام استفاده از دستورات ناوبری غیر از تصویر قبلی و بعدی، رفتار نامشخص است.

مقدار quit باعث می‌شود هنگام تلاش برای پیشروی فراتر از آخرین تصویر اسلایدشو، feh خارج شود. این رفتار گزینه منسوخ‌شده --cycle-once است.

مقدار resume رفتار پیش‌فرض است: در آخرین (اولین) تصویر، feh به تصویر اول (آخر) دور می‌زند.

-j, --output-dir directory

ذخیره فایل‌ها در directory هنگام استفاده از --keep-http یا دستورات save_image یا save_filelist. به طور پیش‌فرض، فایل‌ها در دایرکتوری کاری جاری ذخیره می‌شوند.

-p, --preload

پیش‌بارگذاری تصاویر. این به معنای نگه‌داشتن آن‌ها در حافظه RAM نیست، بلکه به این معناست که در ابتدا روی آن‌ها پیمایش انجام شده و تصاویر غیرقابل‌بارگذاری حذف شوند. در غیر این صورت هنگام ورق زدن حذف خواهند شد. این گزینه همچنین تصاویر را برای به‌دست آوردن داده‌های مورد نیاز در مرتب‌سازی مانند اندازه پیکسل، نوع و غیره تجزیه و تحلیل می‌کند. اگر یکی از این حالت‌های مرتب‌سازی را مشخص کنید، پیش‌بارگذاری به طور خودکار انجام خواهد شد.

-q, --quiet

خطاهای غیرمهلک مربوط به بارگذاری‌های ناموفق گزارش نشوند. حالت‌های پرگویی (verbose) و آرام (quiet) مانعه‌الجمع نیستند؛ اولی پیام‌های اطلاعاتی را کنترل می‌کند و دومی فقط خطاها را.

-z, --randomize

هنگام مشاهده چندین فایل در یک اسلایدشو، فهرست فایل‌ها را قبل از نمایش به صورت تصادفی مرتب کنید. هر زمان که اسلایدشو چرخش کند (یعنی از تصویر آخر به اول منتقل شود)، فهرست دوباره به طور تصادفی مرتب می‌شود.

-r, --recursive

باز کردن بازگشتی تمام دایرکتوری‌های موجود در آرگومان‌های خط فرمان به محتوای آن پوشه‌ها تا عمیق‌ترین سطح.

--no-recursive

دایرکتوری‌ها به صورت بازگشتی باز نشوند. این حالت پیش‌فرض است، اما برای لغو پوسته‌های حاوی --recursive مفید است.

-R, --reload int

بارگذاری مجدد فهرست فایل و تصویر جاری پس از int ثانیه. برای مشاهده وب‌کم‌های HTTP یا پوشه‌هایی با تغییرات مکرر کاربردی است. (توجه داشته باشید که بارگذاری مجدد فهرست فایل هنوز آزمایشی است.) برای غیرفعال کردن هر نوع بارگذاری خودکار، آن را روی صفر تنظیم کنید.

اگر تصویری حذف شود، feh یا تصویر بعدی را نشان می‌دهد یا خارج می‌شود. اما اگر تصویری همچنان وجود داشته باشد ولی دیگر بارگذاری نشود، feh به تلاش برای بارگذاری آن ادامه خواهد داد.

تنظیم این گزینه باعث غیرفعال شدن بارگذاری مجدد خودکار مبتنی بر inotify می‌شود. بارگذاری مجدد در حالت‌های کلاژ، نمایه یا بندانگشتی پشتیبانی نمی‌شود.

-n, --reverse

معکوس کردن ترتیب مرتب‌سازی. از این گزینه برای معکوس کردن ترتیب فهرست فایل‌ها استفاده می‌شود. به عنوان مثال برای مرتب‌سازی معکوس بر اساس عرض تصویر، از -nSwidth استفاده کنید.

-., --scale-down

مقیاس‌بندی تصاویر متناسب با ابعاد هندسی پنجره (در صورت عدم تعیین ابعاد، پیش‌فرض اندازه صفحه است). توجه داشته باشید که در حال حاضر هنگام تعویض تصاویر، ابعاد پنجره به‌روزرسانی نمی‌شود. این گزینه برای مدیران پنجره کاشی‌کار توصیه می‌شود. این گزینه در حالت تمام‌صفحه و حالت فهرست بندانگشتی نادیده گرفته می‌شود.

در محیط‌های کاشی‌کار، همچنین باعث قرار گرفتن تصویر در مرکز پنجره می‌شود.

--scroll-step count

پیمایش به اندازه count پیکسل هر زمان که یکی از کلیدهای scroll_up، scroll_down، scroll_left یا scroll_right فشرده شود. توجه داشته باشید که این گزینه در صورت نیاز به معکوس کردن جهت پیمایش، اعداد منفی را نیز می‌پذیرد. برای چگونگی معکوس کردن دائمی آن بخش ساختار پیکربندی کلیدها (KEYS CONFIG SYNTAX) را ببینید. پیش‌فرض: 20

-D, --slideshow-delay float

در حالت اسلایدشو، بین تغییر خودکار اسلایدها به اندازه float ثانیه مکث شود. برای ارائه‌ها کاربرد دارد. برای تعیین تأخیر (که برابر با float * (-1) خواهد بود) اما شروع feh در حالت توقف موقت (paused)، یک عدد منفی مشخص کنید.

-S, --sort sort_type

مرتب‌سازی فهرست فایل‌ها بر اساس پارامترهای تصویر. انواع مجاز مرتب‌سازی عبارتند از: name, none, filename, dirname, mtime, width, height, pixels, size, format. برای حالت‌های مرتب‌سازی غیر از name, none, filename, dirname, یا mtime ، یک اجرای پیش‌بارگذاری (preload) لازم است که باعث تأخیری متناسب با تعداد تصاویر در فهرست می‌شود.

حالت mtime با جدیدترین تصویر تغییریافته شروع می‌شود. حالت‌های width, height, pixels و size با کوچک‌ترین‌ها آغاز می‌شوند. از --reverse برای مرتب‌سازی بر اساس قدیمی‌ترین یا بزرگ‌ترین در ابتدا استفاده کنید.

برای name, filename, و dirname می‌توانید از --version-sort برای مرتب‌سازی طبیعی اعداد استفاده کنید، به طوری که مثلاً 10.jpg بعد از 2.jpg بیاید.

حالت none پیش‌فرض است؛ می‌توانید آن را به صراحت مشخص کنید تا حالت مرتب‌سازی تعیین‌شده در بخش‌های قبلی آرگومان‌های خط فرمان نادیده گرفته شود.

-|, --start-at filename

شروع فهرست فایل از filename. اگر هیچ فایل یا فهرست فایل دیگری در خط فرمان مشخص نشده باشد، feh ابتدا تمام فایل‌های موجود در دایرکتوری که filename در آن قرار دارد را بارگذاری می‌کند. به این ترتیب، می‌توان به یک تصویر خاص نگاه کرد و با کلیدهای قبلی/بعدی در آن پوشه مرور کرد. برای مثال‌ها بخش مثال‌های کاربردی (USAGE EXAMPLES) را ببینید. اگر filename یک نشانی اینترنتی دوردست باشد و هیچ فایل یا فهرست فایلی تعیین نشده باشد، feh فایل filename را نمایش می‌دهد و تلاشی برای بارگذاری فایل‌ها یا پوشه‌های دیگر نمی‌کند.

نکته: اگر در فهرست فایل خود از مسیرهای نسبی استفاده می‌کنید، filename نیز باید یک مسیر نسبی باشد. اگر از مسیرهای مطلق استفاده می‌کنید، آن هم باید مسیر مطلق باشد. اگر feh نتواند تطابق دقیقی پیدا کند، نام پایه‌ای (نام فایل بدون پسوند دایرکتوری) را مقایسه می‌کند. این امر ممکن است در صورت وجود چندین فایل با نام پایه یکسان در فهرست، منجر به عدم تطابق شود.

-T, --theme theme

بارگذاری گزینه‌ها از فایل پیکربندی با نام theme - برای اطلاعات بیشتر بخش ساختار پیکربندی پوسته‌ها (THEMES CONFIG SYNTAX) را ببینید. توجه داشته باشید که گزینه‌های خط فرمان همیشه بر گزینه‌های پوسته تقدم دارند. پوسته را می‌توان از طریق نام برنامه نیز تعیین کرد (مثلاً با پیوندهای نمادین ،) بنابراین به‌طور پیش‌فرض feh به دنبال یک پوسته به نام "feh" می‌گردد.

-t, --thumbnails

مشابه حالت نمایه، اما تصاویر بندانگشتی اجراکننده‌های قابل‌کلیک تصویر هستند. توجه داشته باشید که --fullscreen و --scale-down بر پنجره تصاویر بندانگشتی تأثیری ندارند. با این حال، برای پنجره‌های تصویری که از حالت بندانگشتی باز می‌شوند کار می‌کنند. همچنین از گزینه‌های حالت نمایه و بندانگشتی (INDEX AND THUMBNAIL MODE OPTIONS) و همچنین گزینه‌های حالت کلاژ (MONTAGE MODE OPTIONS) پشتیبانی می‌کند.

-~, --thumb-title string

تنظیم title برای پنجره‌هایی که از حالت بندانگشتی باز می‌شوند. همچنین بخش مشخص‌کننده‌های قالب (FORMAT SPECIFIERS) را ببینید.

-^, --title title

تنظیم عنوان پنجره. روی همه پنجره‌ها به جز آن‌هایی که از حالت بندانگشتی باز می‌شوند اعمال می‌گردد. بخش مشخص‌کننده‌های قالب (FORMAT SPECIFIERS) را ببینید.

-u, --unloadable

تصاویر را نمایش ندهید. فقط در صورتی که imlib2 نتواند آن‌ها را با موفقیت بارگذاری کند، نامشان را چاپ کنید. اگر حداقل یک تصویر قابل‌بارگذاری باشد، مقدار false بازمی‌گرداند. هنگامی که با --action ترکیب شود، عملیات مشخص‌شده برای هر فایل غیرقابل‌بارگذاری اجرا خواهد شد.

-V, --verbose

خروجی دادن اطلاعات مفید، نوارهای پیشرفت و غیره.

-v, --version

خروجی دادن اطلاعات نسخه و خروج.

--version-sort

هنگامی که با --sort name, --sort filename, یا --sort dirname ترکیب شود: استفاده از مرتب‌سازی طبیعی برای نام‌های فایل و دایرکتوری. در این حالت، نام‌های فایل به گونه‌ای مرتب می‌شوند که یک انسان عادی انتظار دارد، به عنوان مثال "2.jpg" قبل از "10.jpg" می‌آید. توجه داشته باشید که این گزینه تنها زمانی مؤثر است که حالت مرتب‌سازی با --sort تنظیم شده باشد.

--window-id windowid

رسم روی یک پنجره موجود X11 با شناسه windowid. این گزینه برای استفاده با نرم‌افزارهایی مانند xscreensaver یا xsecurelock طراحی شده است که پنجره‌ای را برای برنامه‌های دیگر جهت رسم درون آن فراهم می‌کنند. اگر پنجره‌ای متعلق به نرم‌افزاری را مشخص کنید که انتظار ندارد feh درون آن رسم کند، یا سعی کنید از گزینه‌ها یا کلیدهایی استفاده کنید که بر ویژگی‌های پنجره تأثیر می‌گذارند (مانند حالت تمام‌صفحه)، رفتارهای غیرمنتظره‌ای رخ خواهد داد.

--xinerama-index monitor

(قابلیت اختیاری، فعال در این ساخت) نادیده گرفتن نظر feh's در مورد مانیتور فعال Xinerama. ممکن است در شرایط خاصی مفید باشد که در آن مدیر پنجره، پنجره feh را روی مانیتور Xinerama به نام A قرار می‌دهد در حالی که feh فرض می‌کند روی مانیتور B قرار خواهد گرفت.

در حالت تنظیم پس‌زمینه: هنگام استفاده با هر گزینه‌ای غیر از --bg-tile: تنها والپیپر را روی monitor تنظیم می‌کند. تمام مانیتورهای دیگر با رنگ سیاه/سفید پر خواهند شد. این قابلیت بیش از همه در پیکربندی Xinerama با مانیتورهای هم‌پوشان کاربرد دارد. برای نمونه، فرض کنید دو نمایشگر هم‌پوشان دارید (شاخص 0 و 1) که شاخص 0 کوچک‌تر است. برای قرار دادن پس‌زمینه در مرکز نمایشگر شاخص 0 و پر کردن فضای اضافه روی شاخص 1 با رنگ سیاه/سفید، هنگام تنظیم کاغذدیواری از "--xinerama-index 0"; استفاده کنید.

از xrandr --listmonitors برای تعیین نحوه نگاشت شناسه‌های مانیتور Xinerama به صفحه‌ها/مانیتورها در سیستم خود استفاده کنید.

--zoom percent | max | fill

بزرگ‌نمایی تصاویر به میزان percent در حالت تمام‌صفحه یا زمانی که ابعاد پنجره ثابت است. هنگامی که با --auto-zoom ترکیب شود، بزرگ‌نمایی به درصد مشخص‌شده percent محدود خواهد شد. تعیین max مشابه تنظیم --auto-zoom است؛ استفاده از fill باعث می‌شود feh تصویر را مشابه حالت --bg-fill بزرگ‌نمایی کند.

--zoom-step percent

بزرگ‌نمایی و کوچک‌نمایی تصاویر به میزان percent (پیش‌فرض: 25) هنگام استفاده از کلیدها و دکمه‌های زوم.

گزینه‌های حالت کلاژ (MONTAGE MODE OPTIONS)

این گزینه‌های اضافی می‌توانند برای حالت‌های نمایه، کلاژ و (تا حدی) بندانگشتی استفاده شوند.

-a, --alpha int

هنگام ترسیم تصاویر بندانگشتی روی پس‌زمینه، سطح شفافیت آن‌ها را روی int (0 - 255) تنظیم می‌کند.

-b, --bg file | trans

استفاده از file به عنوان پس‌زمینه برای کلاژ. با مشخص کردن این گزینه، اندازه کلاژ به طور پیش‌فرض اندازه file خواهد بود اگر محدودیتی برای اندازه تعیین نشده باشد. از طرف دیگر، اگر file برابر "trans" باشد، پس‌زمینه شفاف خواهد شد.

-X, --ignore-aspect

به طور پیش‌فرض، بندانگشتی‌های کلاژ نسبت تصویر خود را حفظ می‌کنند و در عین حال در thumb-width/-height جا می‌گیرند. این گزینه آن‌ها را مجبور می‌کند به اندازه‌ای باشند که توسط --thumb-width و --thumb-height تنظیم شده است. این امر از هرگونه فضای خالی در کلاژ نهایی جلوگیری می‌کند.

-H, --limit-height pixels

محدود کردن ارتفاع کلاژ.

-W, --limit-width pixels

محدود کردن عرض کلاژ؛ پیش‌فرض 800 پیکسل است.

اگر هر دو گزینه --limit-width و --limit-height مشخص شوند، کلاژ دقیقاً در ابعاد width x height پیکسل خواهد بود.

-o, --output file

ذخیره کلاژ ایجادشده در file.

-O, --output-only file

تنها ذخیره کلاژ ایجادشده در file بدون نمایش آن.

-s, --stretch

به طور معمول، اگر تصویری کوچک‌تر از اندازه بندانگشتی مشخص‌شده باشد، بزرگ نخواهد شد. اگر این گزینه تنظیم شود، تصویر برای پر کردن اندازه بندانگشتی بزرگ‌نمایی می‌شود. نسبت تصویر حفظ خواهد شد مگر اینکه --ignore-aspect مشخص شود.

-E, --thumb-height pixels

تنظیم ارتفاع بندانگشتی.

-y, --thumb-width pixels

تنظیم عرض بندانگشتی.

گزینه‌های حالت نمایه و بندانگشتی (INDEX AND THUMBNAIL MODE OPTIONS)

علاوه بر گزینه‌های حالت کلاژ (MONTAGE MODE OPTIONS) شامل --alpha, --bg, --limit-height, --limit-width, --output, --output-only, --thumb-height, --thumb-width, گزینه‌های زیر نیز قابل استفاده هستند:

--index-info format

نمایش اطلاعات تصویر بر اساس format در زیر بندانگشتی‌ها در حالت نمایه / بندانگشتی. بخش مشخص‌کننده‌های قالب (FORMAT SPECIFIERS) را ببینید. می‌تواند شامل خطوط جدید باشد. از "--index-info ''" برای نمایش بندانگشتی‌ها بدون هیچ متن اطلاعاتی استفاده کنید.

نکته: اگر فرمت‌های مرتبط با تصویر (مانند %w یا %s) را مشخص کنید، feh نیاز دارد تمام تصاویر را برای محاسبه ابعاد پنجره خود بارگذاری کند. بنابراین هنگام استفاده از آن‌ها با فایل‌های بسیار، مدتی طول می‌کشد تا پنجره feh نمایان شود. از --preload برای نمایش نوار پیشرفت استفاده کنید.

-@, --title-font font

تنظیم قلم برای چاپ عنوان روی نمایه؛ اگر هیچ قلمی مشخص نشود، عنوانی چاپ نخواهد شد.

-J, --thumb-redraw n

بازترسیم پنجره بندانگشتی‌ها در حین تولید هر n تصویر یک‌بار. بازترسیم زمان زیادی می‌برد، بنابراین مقدار پیش‌فرض 10 است. مقدار n = 1 را قرار دهید تا پنجره بندانگشتی فوراً به‌روز شود. با n = 0 ، تنها یک بار پس از بارگذاری تمام بندانگشتی‌ها پنجره بازترسیم می‌شود.

تنظیم تصویر پس‌زمینه (BACKGROUND SETTING)

در بسیاری از محیط‌های رومیزی، feh می‌تواند به عنوان ابزار تنظیم تصویر پس‌زمینه نیز استفاده شود. مگر اینکه گزینه --no-fehbg را مشخص کنید، اسکریپتی برای تنظیم پس‌زمینه جاری در مسیر ~/.fehbg می‌نویسد. بنابراین برای بازیابی پس‌زمینه خود در هر بار شروع X، می‌توانید "~/.fehbg &" را به اسکریپت راه‌اندازی X خود (مانند ~/.xinitrc) اضافه کنید. توجه داشته باشید که خط فرمان نوشته‌شده در ~/.fehbg همواره شامل گزینه --no-fehbg است تا اطمینان حاصل شود که به دلیل تفاوت در چیدمان صفحه نمایش X11 یا موارد مشابه، ناخواسته تغییر نمی‌کند.

توجه داشته باشید که feh از تنظیم والپیپر در میزکارهای گنوم شل پشتیبانی نمی‌کند. در این محیط می‌توانید به جای آن از دستور زیر استفاده کنید: "gsettings set org.gnome.desktop.background picture-uri file:///path".

برای گزینه‌های --bg-center, --bg-fill, و --bg-max ، می‌توانید از --geometry برای تعیین یک جابجایی (offset) از یک سمت مانیتور به جای وسط‌چین کردن تصویر استفاده کنید. مقادیر مثبت از سمت چپ/بالا و مقادیر منفی از سمت پایین/راست فاصله ایجاد می‌کنند. 0+ و 0- هر دو مقادیر معتبر و متمایزی هستند.

توجه داشته باشید که تمام گزینه‌ها به جز --bg-tile از Xinerama پشتیبانی می‌کنند. به عنوان مثال، اگر چندین مانیتور متصل دارید و مثلاً از --bg-center استفاده می‌کنید، feh تصویر را در هر مانیتور وسط‌چین می‌کند یا جابجایی مناسب اعمال می‌نماید. حتی می‌توانید بیش از یک فایل مشخص کنید؛ در این صورت، فایل اول روی مانیتور 0، فایل دوم روی مانیتور 1 و به همین ترتیب تنظیم می‌شود. از دستور xrandr --listmonitors برای تعیین نحوه نگاشت شناسه‌های مانیتور Xinerama به صفحه‌ها/مانیتورها در پیکربندی خود استفاده کنید.

از --no-xinerama برای در نظر گرفتن کل نمایشگر X به عنوان یک مانیتور واحد هنگام تنظیم والپیپر استفاده کنید. همچنین می‌توانید از --xinerama-index برای استفاده از feh به عنوان تنظیم‌کننده پس‌زمینه برای یک مانیتور خاص استفاده نمایید.

--bg-center

وسط‌چین کردن فایل روی پس‌زمینه. اگر خیلی کوچک باشد، با حاشیه‌ای مشخص‌شده توسط --image-bg احاطه خواهد شد.

--bg-fill

مانند --bg-scale ، اما با بزرگ‌نمایی تصویر تا زمانی که جا بگیرد نسبت تصویر را حفظ می‌کند. بخشی از تصویر به صورت افقی یا عمودی بریده خواهد شد.

--bg-max

مانند --bg-fill ، اما مقیاس‌بندی تصویر به حداکثر اندازه‌ای که با حاشیه در یک طرف روی صفحه جا می‌گیرد. رنگ حاشیه را می‌توان با --image-bg تنظیم کرد.

--bg-scale

جا دادن فایل در پس‌زمینه بدون تکرار آن، بریدن بخش‌هایی از آن یا استفاده از حاشیه. اما نسبت تصویر نیز حفظ نمی‌شود.

--bg-tile

کاشی‌کاری (تکرار) تصویر در صورتی که برای صفحه نمایش خیلی کوچک باشد.

--no-fehbg

عدم نوشتن فایل ~/.fehbg.

مشخص‌کننده‌های قالب (FORMAT SPECIFIERS)

%a

اطلاعات وضعیت اسلایدشو (در حال پخش/متوقف‌شده)

%f

مسیر/نام فایل تصویر. به دلیل عدم اسکیپ شل در گزینه‌های --action و --info پشتیبانی نمی‌شود (به جای آن از %F استفاده کنید).

%F

مسیر/نام فایل اسکیپ‌شده تصویر برای استفاده در --action ، --info و سایر دستورات شل.

%g

ابعاد پنجره w,h بر حسب پیکسل (یادافزا: geometry)

%h

ارتفاع تصویر

%l

تعداد کل فایل‌ها در فهرست فایل

%L

رونوشت موقت از فهرست فایل. استفاده‌های متعدد از %L در همان رشته قالب، همان رونوشت را بازمی‌گرداند.

%m

حالت جاری

%n

نام تصویر. به دلیل عدم اسکیپ شل در گزینه‌های --action و --info پشتیبانی نمی‌شود (به جای آن از %N استفاده کنید).

%N

نام اسکیپ‌شده تصویر برای استفاده در --action ، --info و سایر دستورات شل.

%o

جابجایی x,y گوشه بالا سمت چپ تصویر نسبت به گوشه پنجره بر حسب پیکسل

%p

تعداد پیکسل‌های تصویر

%P

تعداد پیکسل‌های تصویر با قالب خوانا برای انسان با پسوند k/M (کیلوپیکسل / مگاپیکسل)

%r

چرخش تصویر. یک چرخش نیم‌دور به راست برابر با pi است.

%s

اندازه تصویر بر حسب بایت

%S

اندازه تصویر با فرمت خوانا برای انسان (kB / MB)

%t

قالب تصویر

%u

شماره فایل جاری

%w

عرض تصویر

%v

نسخه feh

%V

شناسه فرایند (PID)

%z

بزرگ‌نمایی تصویر جاری، گردشده تا دو رقم اعشار

%Z

بزرگ‌نمایی تصویر جاری، با دقت بالاتر

%%

نویسه لفظی %

پیکربندی (CONFIGURATION)

برنامه feh دارای سه فایل پیکربندی است: themes برای تعاریف پوسته، keys برای اتصالات کلیدها و buttons برای اتصالات دکمه‌های ماوس. برنامه سعی می‌کند آن‌ها را از مسیر $XDG_CONFIG_HOME/feh/ بخواند، که (در صورت تنظیم نبودن XDG_CONFIG_HOME) پیش‌فرض آن ~/.config/feh/ است. اگر فایل‌ها در آن دایرکتوری پیدا نشوند، مسیر /etc/feh/ را نیز امتحان خواهد کرد.

تمام فایل‌های پیکربندی با خطوطی که با نویسه "#" شروع می‌شوند به عنوان توضیح (کامنت) رفتار می‌کنند. توضیحات در انتهای خط پشتیبانی نمی‌شوند.

ساختار پیکربندی پوسته‌ها (THEMES CONFIG SYNTAX)

فایل .config/feh/themes امکان نام‌گذاری گروه‌هایی از گزینه‌ها را به عنوان پوسته (theme) فراهم می‌کند.

این فایل ورودی‌هایی به شکل "theme options ..." می‌پذیرد، جایی که theme نام ورودی و options گزینه‌هایی هستند که هنگام استفاده از پوسته اعمال خواهند شد.

توجه داشته باشید که تجزیه‌کننده گزینه‌ها مانند یک پوسته معمولی رفتار نمی‌کند: بسط نام فایل و توالی‌های اسکیپ با بک‌اسلش پشتیبانی نمی‌شوند و همان‌طور که هستند به تجزیه‌کننده گزینه‌های feh ارسال می‌گردند. با این حال، نقل‌قول کردن آرگومان‌ها رعایت می‌شود و می‌تواند برای آرگومان‌های دارای فاصله خالی استفاده شود. بنابراین، عبارت "--info "foo bar"" همان‌طور که انتظار می‌رود عمل می‌کند (یعنی رشته "foo bar را نمایش می‌دهد ،") در حالی که رشته گزینه "--info foo\ bar" تنها "foo\" را نمایش می‌دهد و اعلام می‌کند که فایل bar وجود ندارد. لطفاً هنگام نوشتن فایل‌های پوسته این نکته را در نظر داشته باشید.

یک ورودی نمونه عبارت است از: "imagemap -rVq --thumb-width 40 --thumb-height 30 --index-info '%n\n%wx%h'".

می‌توانید به دو روش از این پوسته استفاده کنید: یا فراخوانی "feh -Timagemap *.jpg" ، یا ایجاد یک پیوند نمادین به feh با نام پوسته‌ای که می‌خواهید استفاده کنید. برای مثال بالا، این دستور خواهد بود: "ln -s `which feh ` ~/bin/imagemap". اکنون کافی است دستور "imagemap *.jpg" را برای استفاده از این گزینه‌ها اجرا کنید.

توجه داشته باشید که می‌توانید با قرار دادن بک‌اسلش در انتهای یک خط ناتمام، یک پوسته را در چند خط بشکنید. یک جفت گزینه-آرگومان منفرد نباید در چند خط قرار گیرد. یک خط منفرد نباید طولانی‌تر از 1023 نویسه باشد، اما هیچ حد بالایی برای طول یک پوسته وجود ندارد.

گزینه‌های خط فرمان همیشه بر گزینه‌های پوسته تقدم دارند.

ساختار پیکربندی کلیدها (KEYS CONFIG SYNTAX)

فایل .config/feh/keys اتصالات کلیدها را تعریف می‌کند. این فایل شامل ورودی‌هایی به شکل زیر است: "action [key1 [key2 [key3]]]".

هر key یک نام کلیدواژه X11 (keysym) است که توسط xev(1) نشان داده می‌شود، مانند "Delete". می‌تواند به صورت اختیاری با تغییردهنده‌هایی برای کلیدهایی مانند Control شروع شود که در این صورت key به شکل mod-keysym خواهد بود (به عنوان مثال "C-Delete" برای Ctrl+Delete یا "C-1-Delete" برای Ctrl+Alt+Delete).

تغییردهنده‌های موجود عبارتند از C برای Control ، S برای Shift و 1, 4 برای Mod1 و Mod4. برای تطابق یک حرف بزرگ انگلیسی مانند "S" به جای "s ،" نیازی به تغییردهنده Shift نیست.

تعیین یک action بدون هیچ کلیدی، اتصال آن را لغو می‌کند (یعنی اتصالات پیش‌فرض حذف می‌شوند).

نکته: از یک کلید یکسان برای چندین عملیات استفاده نکنید. هنگام اختصاص یک عملیات به یک کلید (یا دکمه ماوس) جدید، مطمئن شوید که اتصال آن از عملیات قبلی (در صورت وجود) لغو شده باشد. برنامه feh اتصالات متناقض را بررسی نمی‌کند، بنابراین رفتار آن‌ها نامشخص خواهد بود.

برای فهرستی از نام‌های action ، بخش کلیدها (KEYS) را ببینید. توجه داشته باشید که همه نام‌های کلیدهای استفاده‌شده در آنجا با keysymهای X11 مطابقت ندارند. به‌ویژه کلیدهای صفحه‌به‌بالا (Prior / Page_Up ،) صفحه‌به‌پایین (Next / Page_Down) و کلیدهای بخش عددی صفحه‌کلید (KP_*) مطابقت ندارند.

کلیدها (KEYS)

عملیات‌ها و اتصالات کلیدهای پیش‌فرض زیر می‌توانند در یک پنجره تصویر استفاده شوند. (رشته‌های درون [براکت‌ها] نام‌های عملیات پیکربندی هستند). اگر feh درون یک ترمینال اجرا شود و ورودی استاندارد آن برای تصاویر یا فهرست‌های فایل استفاده نشده باشد، ورودی کلید از ترمینال نیز پذیرفته می‌شود. با این حال، پشتیبانی از ورودی ترمینال در حال حاضر به بیشتر نویسه‌های حرفی-عددی (0-9 a-z A-Z و چند مورد دیگر ،) کلیدهای جهت‌نما، return و backspace محدود است. کلید تغییردهنده Alt (Mod1) نیز پشتیبانی می‌شود.

a [toggle_actions]

تغییر وضعیت نمایش عملیات‌ها (--draw-actions را ببینید)

A [toggle_aliasing]

فعال/غیرفعال کردن صاف‌کردن لبه‌ها (anti-aliasing)

c [toggle_caption]

حالت ورود زیرنویس. اگر --caption-path مشخص شده باشد، ویرایش زیرنویس فعال می‌شود. زیرنویس در پایین صفحه زرد رنگ شده و قابل ویرایش است. کلید return را برای تأیید و ذخیره زیرنویس، یا escape را برای لغو ویرایش فشار دهید. توجه داشته باشید که با استفاده از ⟨Ctrl+return⟩ می‌توانید یک خط جدید واقعی درون زیرنویس درج کنید.

d [toggle_filenames]

تغییر وضعیت نمایش نام فایل (--draw-filename را ببینید)

e [toggle_exif]

(قابلیت اختیاری، موجود در این ساخت) تغییر وضعیت نمایش برچسب‌های EXIF

f [toggle_fullscreen]

تغییر وضعیت حالت تمام‌صفحه

g [toggle_fixed_geometry]

فعال/غیرفعال کردن تغییر اندازه خودکار پنجره هنگام تغییر تصاویر.

h [toggle_pause]

توقف موقت/ادامه اسلایدشو. در حالت توقف، اسلایدها بر اساس --slideshow-delay به طور خودکار تغییر نخواهند کرد.

i [toggle_info]

تغییر وضعیت نمایش اطلاعات (--info را ببینید)

k [toggle_keep_vp]

تغییر وضعیت نگه‌داشتن بزرگ‌نمایی و درگاه دید. در صورت فعال بودن، feh هنگام تعویض تصاویر، بزرگ‌نمایی و جابجایی X, Y را حفظ خواهد کرد.

L [save_filelist]

ذخیره فهرست فایل جاری با نام "feh_PID_ID_filelist". در دایرکتوری تعیین‌شده توسط --output-dir (در صورت تنظیم) و در غیر این صورت در دایرکتوری کاری جاری ذخیره می‌شود.

m [toggle_menu]

نمایش منو. از کلیدهای جهت‌نما و return برای انتخاب گزینه‌ها، و از ⟨escape⟩ برای بستن منو استفاده کنید.

n, ⟨space⟩, ⟨Right⟩ [next_img]

نمایش تصویر بعدی. در حالت بندانگشتی تصویر بعدی را انتخاب می‌کند.

o [toggle_pointer]

تغییر وضعیت پنهان/آشکار بودن نشانگر ماوس

p, ⟨BackSpace⟩, ⟨Left⟩ [prev_img]

نمایش تصویر قبلی. در حالت بندانگشتی تصویر قبلی را انتخاب می‌کند.

q, ⟨Escape⟩ [quit]

خروج از feh

r [reload_image]

بارگذاری مجدد تصویر جاری. برای وب‌کم‌ها کاربردی است

s [save_image]

ذخیره تصویر جاری به صورت "feh_PID_ID_FILENAME". در دایرکتوری تعیین‌شده توسط --output-dir (در صورت تنظیم) و در غیر این صورت در دایرکتوری کاری جاری ذخیره می‌شود.

w [size_to_image]

تغییر اندازه پنجره متناسب با اندازه تصویر فعلی (به علاوه/منهای زوم، در صورت تنظیم). در حالت‌های scale-down و fixed-geometry، این کار محدودیت‌های اندازه پنجره را نیز به‌روزرسانی می‌کند.

x [close]

بستن پنجره جاری

z [jump_random]

پرش به یک موقعیت تصادفی در فهرست فایل جاری

Z [toggle_auto_zoom]

تغییر وضعیت بزرگ‌نمایی خودکار.

[, ] [prev_dir, next_dir]

پرش به اولین تصویر از توالی قبلی یا بعدی تصاویری که نام دایرکتوری یکسانی در فهرست فایل فعلی دارند. اگر می‌خواهید مطمئن شوید تمام تصاویر یک پوشه با هم دسته‌بندی می‌شوند، از sort dirname-- استفاده کنید.

<, > [orient_3, orient_1]

چرخش تصویر به اندازه ۹۰ درجه در جهت پادساعت‌گرد یا ساعت‌گرد.

هنگامی که از --edit استفاده می‌شود، این کار تصویر را در فایل اصلی نیز می‌چرخاند. چرخش بدون افت کیفیت است، اما در صورت استفاده با تصاویر JPEG ممکن است اعوجاجی در برخی گوشه‌های تصویر ایجاد کند. چرخش در جهت عکس آن‌ها را برطرف می‌کند. برای اطلاعات بیشتر درباره چرخش بدون افت کیفیت JPEG راهنمای jpegtran(1) را ببینید. نکته: برنامه feh فرض می‌کند این قابلیت برای استانداردسازی جهت تصویر استفاده می‌شود. برای تصاویر JPEG، برچسب جهت EXIF را بعد از هر چرخش بدون قید و شرط روی 1 تنظیم می‌کند ("0,0 گوشه بالا چپ است"). برای جزئیات درباره نحوه تغییر این پرچم راهنمای jpegexiforient(1) را ببینید.

_ [flip]

قرینه‌سازی عمودی تصویر. هنگام استفاده از --edit ، تصویر در فایل اصلی نیز قرینه می‌شود (بالا را ببینید).

| [mirror]

قرینه‌سازی افقی تصویر. هنگام استفاده از --edit ، تصویر در فایل اصلی نیز قرینه می‌شود (بالا را ببینید).

0 .. 9 [action_0 .. action_9]

اجرای عملیات متناظر (0 = --action, 1 = --action1 و غیره).

⟨Return⟩ [action_0]

اجرای دستور تعریف‌شده توسط --action

⟨Home⟩ [jump_first]

نمایش تصویر اول

⟨End⟩ [jump_last]

نمایش تصویر آخر

⟨page up⟩ [jump_fwd]

حرکت به جلو به میزان حدود ۵٪ از فهرست فایل

⟨page down⟩ [jump_back]

حرکت به عقب به میزان حدود ۵٪ از فهرست فایل

+ [reload_plus]

افزایش تأخیر بارگذاری مجدد به اندازه ۱ ثانیه

- [reload_minus]

کاهش تأخیر بارگذاری مجدد به اندازه ۱ ثانیه

⟨Delete⟩ [remove]

حذف فایل جاری از فهرست فایل

⟨Ctrl+Delete⟩ [delete]

حذف فایل جاری از فهرست فایل و پاک کردن آن از دیسک

⟨keypad Left⟩, ⟨Ctrl+Left⟩ [scroll_left]

پیمایش به سمت چپ

⟨keypad Right⟩, ⟨Ctrl+Right⟩ [scroll_right]

پیمایش به سمت راست

⟨keypad up⟩, ⟨Ctrl+Up⟩ [scroll_up]

پیمایش به سمت بالا

⟨keypad Down⟩, ⟨Ctrl+Down⟩ [scroll_down]

پیمایش به سمت پایین. توجه داشته باشید که کلیدهای پیمایش به دلایل کارایی بدون صاف‌کردن لبه‌ها کار می‌کنند؛ پس از پیمایش، کلید render را برای صاف‌کردن لبه‌های تصویر بزنید.

⟨Alt+Left [scroll_left_page]⟩

پیمایش یک صفحه به سمت چپ

⟨Alt+Right [scroll_right_page]⟩

پیمایش یک صفحه به سمت راست

⟨Alt+Up [scroll_up_page]⟩

پیمایش یک صفحه به سمت بالا

⟨Alt+Down [scroll_down_page]⟩

پیمایش یک صفحه به سمت پایین

R, ⟨keypad begin⟩ [render]

صاف‌کردن لبه‌های تصویر (anti-alias). در حالت بندانگشتی، تصویر انتخاب‌شده فعلی را باز می‌کند.

⟨keypad +⟩, ⟨Up⟩ [zoom_in]

بزرگ‌نمایی

⟨keypad -⟩, ⟨Down⟩ [zoom_out]

کوچک‌نمایی

*, ⟨keypad *⟩ [zoom_default]

بزرگ‌نمایی به ۱۰۰٪

/, ⟨keypad /⟩ [zoom_fit]

بزرگ‌نمایی متناسب با اندازه پنجره

! [zoom_fill]

بزرگ‌نمایی برای پر کردن اندازه پنجره مانند --bg-fill

ساختار پیکربندی دکمه‌ها (BUTTONS CONFIG SYNTAX)

فایل .config/feh/buttons. این فایل مانند فایل پیکربندی کلیدها عمل می‌کند: ورودی‌ها به شکل زیر هستند: "action [binding]".

هر binding یک شماره دکمه است. می‌تواند به صورت اختیاری با تغییردهنده‌هایی مانند Control شروع شود که در این صورت binding به شکل mod-button خواهد بود (به عنوان مثال C-1 برای Ctrl + دکمه چپ).

نکته: از یک دکمه برای چندین عملیات استفاده نکنید. برنامه feh اتصالات متناقض را بررسی نمی‌کند، بنابراین رفتار آن‌ها نامشخص خواهد بود. یا عملیات ناخواسته را لغو اتصال کنید، یا آن را به یک دکمه استفاده‌نشده دیگر متصل نمایید. ترتیب اتصال / لغو اتصال اهمیتی ندارد.

برای تغییردهنده‌های موجود بخش ساختار پیکربندی کلیدها (KEYS CONFIG SYNTAX) را ببینید.

عملکردهای ماوس (MOUSE ACTIONS)

اتصالات پیش‌فرض: هنگام مشاهده یک تصویر، دکمه ۱ ماوس تصویر را جابجا می‌کند (pan) (آن را به اطراف حرکت می‌دهد) یا هنگامی که فقط کلیک شود، به تصویر بعدی می‌رود (تنها در حالت اسلایدشو). کشیدن‌های سریع با کمتر از 2 پیکسل جابجایی در هر محور به عنوان کلیک در نظر گرفته می‌شوند تا به کاربران تبلت‌های گرافیکی کمک شود. دکمه ۲ ماوس بزرگ‌نمایی می‌کند (کلیک و کشیدن از چپ به راست برای بزرگ‌نمایی، از راست به چپ برای کوچک‌نمایی، یک بار کلیک برای بازگرداندن زوم به ۱۰۰٪) و دکمه ۳ ماوس منو را باز می‌کند.

ترکیب Ctrl+دکمه ۱ تصویر را تار یا تیز می‌کند (کشیدن به سمت چپ برای تاری، به سمت راست برای وضوح/تیزی بیشتر ؛) ترکیب Ctrl+دکمه ۲ تصویر را حول نقطه مرکزی می‌چرخاند.

نکته‌ای درباره حالت‌های جابجایی (pan) و بزرگ‌نمایی (zoom): در حالت جابجایی، اگر به لبه پنجره برسید اما هنوز تصویر به پایان نرسیده باشد، feh مکان‌نما را به لبه مقابل منتقل می‌کند تا بتوانید به جابجایی ادامه دهید.

هنگام کلیک روی دکمه زوم و رها کردن فوری آن، تصویر به بزرگ‌نمایی ۱۰۰٪ بازمی‌گردد. هنگام کلیک و حرکت دادن ماوس در حین پایین نگه داشتن دکمه، بزرگ‌نمایی در سطح زوم قبلی ادامه می‌یابد. بزرگ‌نمایی همیشه به گونه‌ای انجام می‌شود که پیکسلی که روی آن وارد حالت زوم شده‌اید ثابت باقی بماند. بنابراین برای بزرگ کردن بخش خاصی از یک تصویر، دکمه زوم را روی همان بخش کلیک کنید.

سیگنال‌ها (SIGNALS)

در حالت‌های اسلایدشو و چندپنجره‌ای، feh سیگنال‌های زیر را مدیریت می‌کند:

SIGUSR1

حالت اسلایدشو: رفتن به تصویر بعدی؛ بارگذاری مجدد تصویر جاری اگر اسلایدشو شامل یک فایل باشد. حالت چندپنجره‌ای: بارگذاری مجدد تمام تصاویر.

SIGUSR2

حالت اسلایدشو: رفتن به تصویر قبلی؛ بارگذاری مجدد تصویر جاری اگر اسلایدشو شامل یک فایل باشد. حالت چندپنجره‌ای: بارگذاری مجدد تمام تصاویر.

مثال‌های کاربردی (USAGE EXAMPLES)

در اینجا چند نمونه از ترکیب‌های مفید گزینه‌ها آورده شده است. همچنین ببینید: ⟨https://feh.finalrewind.org/examples⟩

feh ~/Pictures

نمایش تمام تصاویر در ~/Pictures

feh -r ~/Pictures

نمایش بازگشتی تمام تصاویر موجود در ~/Pictures و زیرشاخه‌های آن

feh -rSfilename --version-sort ~/Pictures

مشابه بالا، اما با مرتب‌سازی طبیعی. به‌طور پیش‌فرض، feh فایل‌ها را بر اساس ترتیب رشته‌ای نام آن‌ها نشان می‌دهد، یعنی به عنوان مثال "foo 10.jpg" قبل از "foo 2.jpg" می‌آید. در این حالت، آن‌ها به گونه‌ای مرتب می‌شوند که یک انسان انتظار دارد.

feh -t -Sfilename -E 128 -y 128 -W 1024 ~/Pictures

نمایش تصاویر بندانگشتی ۱۲۸x۱۲۸ پیکسل، محدود کردن عرض پنجره به ۱۰۲۴ پیکسل.

feh -t -Sfilename -E 128 -y 128 -W 1024 -P -C /usr/share/fonts/truetype/ttf-dejavu/ -e DejaVuSans/8 ~/Pictures

مشابه بالا، اما همراه با فعال‌سازی کش تصاویر بندانگشتی و استفاده از قلم کوچک‌تر.

feh -irFarial/14 -O index.jpg ~/Pictures

ایجاد یک برگه نمایه چاپی از ~/Pictures و تمام دایرکتوری‌های زیر آن، با استفاده از قلم Arial اندازه ۱۴ برای نوشتن اطلاعات زیر هر تصویر بندانگشتی. ذخیره تصویر به عنوان index.jpg بدون نمایش آن، و سپس خروج. توجه داشته باشید که این دستور حتی بدون یک سرور فعال X نیز کار می‌کند.

feh --unloadable -r ~/Pictures

چاپ تمام تصاویر غیرقابل‌بارگذاری در ~/Pictures، به صورت بازگشتی.

feh -f by_width -S width --reverse --list .

نوشتن فهرستی از تمام تصاویر موجود در پوشه درون فایل by_width، مرتب‌شده بر اساس عرض (عریض‌ترین تصاویر در ابتدا)

feh -w ~/Pictures/holidays

باز کردن هر تصویر در ~/Pictures/holidays در پنجره مجزای خود

feh -FD5 -Sname ~/Pictures/presentation

نمایش تصاویر در presentation/...، مرتب‌شده بر اساس نام، در حالت تمام‌صفحه، و تغییر خودکار به تصویر بعدی پس از ۵ ثانیه

feh -rSwidth -A "mv -n %F ~/images/%N" ~/Pictures

مشاهده تمام تصاویر در ~/Pictures و زیرشاخه‌های آن، مرتب‌شده بر اساس عرض، و انتقال تصویر به ~/images/image_name با فشردن کلید enter

feh --start-at ~/Pictures/foo.jpg

مشاهده تمام تصاویر در ~/Pictures، با شروع از foo.jpg. تمام تصاویر دیگر همچنان در اسلایدشو هستند و به طور معمول قابل مشاهده خواهند بود.

feh --start-at ~/Pictures/foo.jpg ~/Pictures

مشابه بالا.

feh --info "exifgrep '(Model|DateTimeOriginal|FNumber|ISO|Flash)' %F | cut -d . -f 4-" .

نمایش برخی اطلاعات EXIF، استخراج‌شده توسط exifprobe/exifgrep

feh --action 'rm %F' -rl --max-dimension 1000x800

حذف بازگشتی تمام تصاویر با ابعاد کمتر یا مساوی ۱۰۰۰x۸۰۰ پیکسل از دایرکتوری جاری.

feh -L '%w %h %f' | awk '{ if ($1 > $2) { print $0 } }' | cut -d ' ' -f 3- | feh -f -

نمایش تصاویر افقی (عرض تصویر بزرگ‌تر از ارتفاع) در دایرکتوری جاری.

وابستگی‌ها (DEPENDENCIES)

هنگامی که از --edit استفاده می‌شود، feh به باینری‌های jpegtran و jpegexiforient (که معمولاً در بسته‌هایی مانند "libjpeg-progs" یا مشابه آن توزیع می‌شوند) برای چرخش بدون افت کیفیت JPEG نیاز دارد.

برای مشاهده تصاویر از نشانی‌های اینترنتی مانند "http:// ،" برنامه feh باید با پشتیبانی libcurl کامپایل شده باشد. این قابلیت در این ساخت فعال است.

باگ‌های شناخته‌شده (KNOWN BUGS)

نسخه‌های Imlib2 پیش از 1.7.4 قادر به بارگذاری تصاویر gif، tiff و webp نیستند اگر نام فایل به ترتیب به gif، tiff یا webp ختم نشود. به‌ویژه این بدان معناست که feh در سیستم‌هایی با نسخه Imlib2 قدیمی‌تر از 1.7.4 قادر به نمایش تصاویر gif، tiff و webp از ورودی استاندارد (stdin) یا نشانی‌های شبکه نیست.

نسخه‌های Imlib2 نسخه +1.7.5 به طور خودکار تصاویر را بر اساس برچسب‌های EXIF آن‌ها می‌چرخانند. هنگامی که با گزینه --auto-rotate ترکیب شود، این امر باعث می‌شود تصاویر دو بار چرخانده شوند و در جهت نادرست قرار گیرند. به عنوان یک راهکار، از --auto-rotate در سیستم‌های دارای نسخه Imlib2 برابر 1.7.5 یا جدیدتر استفاده نکنید.

در سیستم‌های دارای giflib 5.1.2، برنامه feh ممکن است نتواند تصاویر gif را بارگذاری کند. برای دستگاه‌های mips، mipsel و arm متأثر، پشتیبانی از gif کاملاً از کار افتاده است، در حالی که در سامانه‌های x86 / x86_64 تصاویر gif معمولاً تنها در صورتی بارگذاری می‌شوند که اولین تصویر در فهرست فایل باشند. به نظر می‌رسد این مشکل یک باگ در giflib باشد، برای جزئیات نشانی ⟨https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=813729⟩ را ببینید. راهکار: استفاده از --conversion-timeout 5 (یا مقداری مثبت دیگر) برای بارگذاری تصاویر gif با استفاده از imagemagick، یا بازگشت به giflib 5.1.1، یا ارتقا به giflib 5.1.4.

هنگام بارگذاری تصاویر با استفاده از libcurl، برنامه feh به اقدامات کلید یا ماوس واکنشی نشان نخواهد داد.

حالت بندانگشتی تا حدودی ناکارآمد است و به همین دلیل به سرعتی که می‌توانست باشد نیست.

گزینه --scale-down تزئینات پنجره را در نظر نمی‌گیرد و بنابراین ممکن است پنجره را کمی بیش از حد بزرگ کند.

مجوز (LICENSE)

حق نشر (C) ۱۹۹۹، ۲۰۰۰ توسط Paul Duncan. حق نشر (C) ۱۹۹۹، ۲۰۰۰ توسط Tom Gilbert و مشارکت‌کنندگان. حق نشر (C) ۲۰۱۰-۲۰۲۵ توسط Birte Kristina Friesel و مشارکت‌کنندگان.

بدین وسیله به هر شخصی که نسخه‌ای از این نرم‌افزار و فایل‌های مستندات مرتبط («نرم‌افزار») را دریافت می‌کند، بدون پرداخت هزینه، اجازه داده می‌شود که بدون محدودیت با نرم‌افزار رفتار کند؛ از جمله بدون محدودیت حقوق استفاده، کپی، تغییر، ادغام، انتشار، توزیع، اعطای مجوز فرعی و/یا فروش نسخه‌های نرم‌افزار، و اجازه دادن به افرادی که نرم‌افزار به آن‌ها ارائه می‌شود تا این کار را انجام دهند، با رعایت شرایط زیر:

اعلان حق نشر فوق و این مجوزنامه باید در تمامی نسخه‌ها یا بخش‌های عمده نرم‌افزار و مستندات آن گنجانده شود و در مستندات و بسته‌های نرم‌افزاری که این نرم‌افزار در آن‌ها استفاده شده است مورد قدردانی قرار گیرد.

این نرم‌افزار «به همان صورتی که هست» (AS IS) ارائه می‌شود، بدون هرگونه ضمانت صریح یا ضمنی، از جمله اما نه محدود به ضمانت‌های تجاری بودن، مناسب بودن برای یک هدف خاص و عدم نقض حقوق. در هیچ موردی نویسندگان در قبال هرگونه ادعا، خسارت یا سایر مسئولیت‌ها، اعم از اقدام قراردادی، شبه‌جرم یا غیر آن، که از یا در ارتباط با نرم‌افزار یا استفاده یا سایر معاملات در نرم‌افزار ناشی شود، مسئول نخواهند بود.

توسعه‌دهنده فعلی: Birte Friesel ⟨derf@finalrewind.org⟩

نویسنده اولیه (دیگر توسعه نمی‌دهد): Tom Gilbert ⟨feh_sucks@linuxbrit.co.uk⟩

وب‌سایت: https://feh.finalrewind.org