نام (NAME)

quodlibet - مدیریت‌کننده و پخش‌کننده کتابخانه صوتی

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

quodlibet [ --print-playing | control ]
exfalso [ directory ]

توضیحات (DESCRIPTION)

نرم‌افزار Quod Libet یک برنامه مدیریت موسیقی است. این برنامه روش‌های گوناگونی را برای مشاهده کتابخانه صوتی، به همراه پشتیبانی از رادیوهای اینترنتی و خوراک‌های صوتی ارائه می‌دهد. همچنین این ابزار دارای قابلیت‌های بسیار انعطاف‌پذیری برای ویرایش برچسب‌های متادیتا و جستجو است.

این صفحه راهنما صرفاً یک مرجع کوتاه برای Quod Libet است. مستندات کامل در نشانی زیر در دسترس است: https://quodlibet.readthedocs.io/en/latest/guide/index.html.

گزینه‌ها (OPTIONS)

--add-location=<location>: افزودن یک فایل یا دایرکتوری به کتابخانه
--debug: چاپ اطلاعات اشکال‌زدایی
--enqueue=<filename|query>: قرار دادن یک نام فایل یا نتایج پرسمان در صف
--enqueue-files=<filename[,filename..]>: قرار دادن فایل‌های جداشده با ویرگول در صف
--filter <tag=value>: فیلتر کردن بر اساس مقدار یک برچسب
--focus: فوکوس کردن روی پخش‌کننده در حال اجرا
--force-previous: پرش اجباری به آهنگ قبلی
--help: نمایش اطلاعات مختصر نحوه استفاده
--hide-window: پنهان کردن پنجره اصلی
--list-browsers: فهرست کردن مرورگرهای موجود
--next: پرش به آهنگ بعدی
--no-plugins: شروع بدون افزونه‌ها
--open-browser=BrowserName: باز کردن یک مرورگر جدید
--pause: مکث پخش
--play: شروع پخش
--play-file=filename: پخش یک فایل
--play-pause: تغییر وضعیت پخش/مکث
--previous: پرش به آهنگ قبلی در صورت نزدیک بودن به آغاز، در غیر این صورت بازآغازی پخش
--print-playing: چاپ اطلاعات درباره آهنگ در حال پخش. می‌توانید رشته‌ای همانند ساختار شرح‌داده‌شده در بخش تغییر نام فایل‌ها ارائه دهید.
--print-playlist: چاپ لیست پخش کنونی
--print-query=<query>: چاپ نام فایل‌های حاصل از پرسمان
--print-query-text: چاپ متن پرسمان فعال
--print-queue: چاپ محتویات صف
--query=search-string: جستجو در کتابخانه صوتی
--queue=<on|off|t>: نمایش یا پنهان کردن صف
--quit: خروج از Quod Libet
--random=tag: فیلتر کردن بر اساس یک مقدار تصادفی
--rating=<[+|-]0.0..1.0>: تنظیم امتیاز آهنگ در حال پخش
--rating-down: کاهش امتیاز آهنگ در حال پخش به اندازه یک ستاره
--rating-up: افزایش امتیاز آهنگ در حال پخش به اندازه یک ستاره
--refresh: نوسازی و پویش دوباره کتابخانه
--repeat=<off|on|t>: خاموش، روشن یا تغییر وضعیت تکرار
--repeat-type=<current|all|one|off>: تکرار آهنگ در حال پخش، تکرار فهرست کنونی، توقف پس از یک آهنگ، یا خاموش کردن تکرار
--run: اجرای Quod Libet در صورتی که در حال اجرا نباشد
--seek=<[+|-][HH:]MM:SS>: پرش زمانی درون آهنگ در حال پخش
--set-browser=BrowserName: تنظیم مرورگر کنونی
--show-window: نمایش پنجره اصلی
--shuffle=<off|on|t>: خاموش، روشن یا تغییر وضعیت پخش تصادفی
--shuffle-type=<random|weighted|off>: تنظیم نوع پخش تصادفی به تصادفی کامل (random)، ترجیح دادن آهنگ‌های با امتیاز بالاتر (weighted)، یا خاموش کردن آن
--start-hidden: عدم نمایش هیچ پنجره‌ای هنگام شروع
--start-playing: شروع بلافاصله پخش
--status: چاپ وضعیت پخش.TP --stop توقف پخش
--stop-after=<0|1|t>: توقف پس از پایان آهنگ در حال پخش
--toggle-window: تغییر وضعیت نمایش یا پنهان‌سازی پنجره اصلی
--unfilter: حذف فیلترهای فعال مرورگر
--unqueue=<filename|query>: حذف یک فایل یا پرس‌وجو از صف
--version: نمایش نسخه و کپی‌رایت
--volume=<[+|-]0..100>: تنظیم بلندی صدا
--volume-down: کاهش بلندی صدا
--volume-up: افزایش بلندی صدا
--with-pattern=<pattern>: تنظیم قالب خروجی دستورهای --print-playing، --print-playlist، --print-query و --print-queue. می‌توانید یک رشته الگوی برچسب مشابه آنچه در بخش «تغییر نام فایل‌ها (RENAMING FILES)» در ادامه آمده است وارد کنید.

کاورهای آلبوم (ALBUM COVERS)

کاورهای آلبوم باید در همان دایرکتوری آهنگ‌های مربوطه قرار گیرند و نام فایل آن‌ها شامل عبارت‌های "folder" ،"front" یا "cover" باشد. اگر می‌خواهید چندین آلبوم را در یک دایرکتوری ذخیره کنید اما تصاویر کاور متمایزی داشته باشید، نام فایل تصویر مناسب باید شامل مقدار برچسب labelid باشد، مانند COCX-32760 cover.jpg.

برچسب‌های متصل (TIED TAGS)

در بسیاری از بخش‌های Quod Libet می‌توانید از «برچسب‌های متصل» (tied tags) استفاده کنید. برچسب‌های متصل دو نام برچسب هستند که با یک "~" به یکدیگر متصل شده‌اند، مانند "title~version" یا "album~part". برچسب‌های متصل حتی در صورت نبود یکی از برچسب‌ها منجر به نمایش «مناسب» می‌شوند؛ به عنوان مثال، در صورت وجود برچسب نسخه، "title~version" به صورت Title - Version نمایش داده می‌شود، اما در صورت نبود آن، تنها Title نمایش می‌یابد. شما می‌توانید هر تعداد برچسب را به یکدیگر متصل کنید.

نحو جستجو (SEARCH SYNTAX)

تمام کادرهای جستجوی Quod Libet از جستجوهای پیشرفته با ساختارهای زیر پشتیبانی می‌کنند:

tag = value
tag = !value
tag = "value"
tag = /value/
tag = &(value1, value2)
tag = |(value1, value2)
!tag = value
|(tag1 = value1, tag2 = value2)
&(tag1 = value1, tag2 = value2)
#(numerictag < value)
#(numerictag = value)
#(numerictag > value)

پسوند 'c' در انتهای رشته‌ها یا عبارات باقاعده، جستجو را به حروف بزرگ و کوچک حساس (case-sensitive) می‌کند. مقادیر عددی می‌توانند به صورت اعداد صحیح، اعداد ممیز شناور، قالب MM:SS یا عبارات انگلیسی ساده وارد شوند، مانند "3 days" یا "2 hours".

ببینید: https://quodlibet.readthedocs.io/en/latest/guide/searching.html.

تمام برچسب‌های داخلی با نویسه ~ شروع می‌شوند. برچسب‌های داخلی غیرعددی عبارتند از ~basename، ~dirname، ~filename، ~format، ~length، ~people و ~rating. برچسب‌های داخلی عددی عبارتند از ~#added، ~#bitrate، ~#disc، ~#lastplayed، ~#laststarted، ~#length، ~#mtime، ~#playcount، ~#skipcount و ~#track.

ببینید: https://quodlibet.readthedocs.io/en/latest/guide/tags/internal_tags.html..SH "تغییر نام فایل‌ها (RENAMING FILES)"

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

<tracknumber>. <title~version>

می‌توانید از یک '|' استفاده کنید تا متنی را فقط در صورت موجود بودن برچسب نمایش دهید:

<tracknumber|<tracknumber>. ><title~version>

همچنین می‌توانید با افزودن یک '|' دیگر، متن مشخصی را برای زمانی که برچسب وجود ندارد تعیین کنید:

<album|<album>|No Album> - <title>

ببینید: https://quodlibet.readthedocs.io/en/latest/guide/renaming_files.html.

پس‌انه‌های صوتی (AUDIO BACKENDS)

برنامه Quod Libet از GStreamer برای پخش صدا استفاده می‌کند. این برنامه تلاش می‌کند پیکربندی GStreamer را از GConf بخواند، اما در صورت عدم موفقیت، به osssink بازمی‌گردد. می‌توانید گزینه pipeline را در ~/.quodlibet/config تغییر دهید تا از یک سینک (sink) دیگر استفاده کنید، یا گزینه‌هایی را به سینک ارسال کنید. به عنوان مثال، می‌توانید از esdsink یا alsasink device=hw:1 استفاده کنید.

ببینید: https://quodlibet.readthedocs.io/en/latest/guide/playback/backends.html.

فایل‌ها (FILES)

~/.quodlibet/songs: یک dict پایتون از متاداده‌های نهان‌سازی‌شده در قالب pickle. حذف این فایل تمام آهنگ‌ها را از کتابخانه شما پاک خواهد کرد.
~/.quodlibet/config: فایل پیکربندی Quod Libet. این فایل هنگام خروج Quod Libet بازنویسی می‌شود.
~/.quodlibet/current: یک فایل "key=value" شامل اطلاعات مربوط به آهنگی که هم‌اکنون در حال پخش است.
~/.quodlibet/control: یک FIFO متصل به آخرین نمونه اجراشده از برنامه. گزینه‌های --next، --previous و غیره از این برای کنترل پخش‌کننده استفاده می‌کنند.
~/.quodlibet/plugins/: پلاگین‌ها را در اینجا قرار دهید.
~/.quodlibet/browsers/: مرورگرهای سفارشی کتابخانه را در اینجا قرار دهید.

ببینید: https://quodlibet.readthedocs.io/en/latest/guide/interacting.html.

گزارش باگ‌ها (BUGS)

برای دیدن فهرستی از تمام باگ‌ها و درخواست‌های قابلیت‌های جدید که در حال حاضر باز هستند، https://github.com/quodlibet/quodlibet/issues را ببینید.

نویسندگان (AUTHORS)

Joe Wreschnig و Michael Urman نویسندگان اصلی Quod Libet هستند.

همچنین ببینید (SEE ALSO)

https://quodlibet.readthedocs.io/en/latest/guide,
https://quodlibet.readthedocs.io/en/latest/guide/faq.html,
regex(7), gst-launch(1)