| OPERON(1) | OPERON(1) |
نام (NAME)
operon - برچسب‌گذار موسیقی در خط فرمان
خلاصه دستور (SYNOPSIS)
operon [--version] [--help] [-v | --verbose] <command> [<argument>...] operon help <command>
گزینه‌ها (OPTIONS)
- -h, --help
- نمایش راهنما و خروج
- --version
- چاپ نسخه برنامه
- -v, --verbose
- حالت پرجزئیات
مرور دستورها (COMMAND-OVERVIEW)
ویرایش برچسب‌ها (Edit Tags)
add افزودن یک مقدار به برچسب remove حذف یک مقدار از برچسب set تنظیم یک برچسب و حذف مقادیر موجود clear حذف برچسب‌ها copy رونوشت برچسب‌ها از یک فایل به فایل دیگر edit ویرایش برچسب‌ها در یک ویرایشگر متنی fill تکمیل برچسب‌ها بر اساس مسیر فایل
نمایش فراداده فایل (Show file metadata)
list فهرست کردن برچسب‌ها info فهرست کردن اطلاعات فایل print چاپ برچسب‌ها بر اساس الگوی داده‌شده
ویرایش تصاویر تعبیه‌شده (Edit Embedded Images)
image-extract استخراج تصاویر تعبیه‌شده image-set تنظیم تصویر تعبیه‌شده image-clear حذف تصاویر تعبیه‌شده
متفرقه (Miscellaneous)
tags فهرست کردن تمام برچسب‌های متداول help نمایش اطلاعات راهنما
add
افزودن برچسب جدید <tag> با مقدار <value> به تمامی فایل‌ها.
operon add [-h] <tag> <value> <file>...
- -h, --help
- نمایش راهنما و خروج
- مثال:
- operon add artist 'The Beatles' song1.ogg song2.ogg
remove
حذف تمام مقادیری از برچسب <tag> که با <value> یا عبارت منظم <pattern> مطابقت دارند از تمام فایل‌ها.
operon remove [-h] [--dry-run] <tag> (-e <pattern> | <value>) <file>...
- -h, --help
- نمایش راهنما و خروج
- --dry-run
- چاپ نتایج بدون تغییر هیچ فایلی
- -e,--regexp <regexp>
- حذف تمام مقادیر برچسب که با عبارت منظم داده‌شده مطابقت دارند
- مثال:
- operon remove artist 'The Beatles' song.ogg
set
جایگزینی تمامی مقادیر برچسب <tag> با <value> در تمام فایل‌ها.
operon set [-h] [--dry-run] <tag> <value> <file>...
- -h, --help
- نمایش راهنما و خروج
- --dry-run
- چاپ نتایج بدون تغییر هیچ فایلی
- مثال:
- operon set artist 'The Beatles' song.ogg
clear
حذف تمام برچسب‌هایی که با <tag> یا عبارت منظم <pattern> مطابقت دارند از تمام فایل‌ها. اگر --all مشخص شده باشد، تمام برچسب‌های شناخته‌شده حذف خواهند شد.
operon clear [-h] [--dry-run] (-a | -e <pattern> | <tag>) <file>...
- -h, --help
- نمایش راهنما و خروج
- --dry-run
- چاپ نتایج بدون تغییر هیچ فایلی
- -a, --all
- حذف تمام برچسب‌ها
- -e,--regexp <regexp>
- حذف تمام برچسب‌هایی که با عبارت منظم داده‌شده مطابقت دارند
- مثال:
- operon clear -a song.ogg
operon clear -e 'musicbrainz_.*' song.ogg
operon clear date song.ogg
تمام برچسب‌ها را از فایل <source> به <dest> کپی می‌کند. تمام برچسب‌ها در <dest> حفظ خواهند شد. در صورتی که قالب مقصد از تنظیم یک برچسب از مبدأ پشتیبانی نکند، هیچ برچسبی کپی نخواهد شد. برای نادیده گرفتن برچسب‌هایی که توسط قالب مقصد پشتیبانی نمی‌شوند، --ignore-errors را ارسال کنید.
operon copy [-h] [--dry-run] [--ignore-errors] <source> <dest>
- -h, --help
- نمایش راهنما و خروج
- --dry-run
- چاپ نتایج بدون تغییر دادن هیچ فایلی
- --ignore-errors
- رد کردن برچسب‌هایی که فایل هدف از آن‌ها پشتیبانی نمی‌کند
- مثال:
- operon copy song.flac song.ogg
edit
تمام برچسب‌ها را در یک ویرایشگر متن نمایش می‌دهد و هرگونه تغییر اعمال‌شده در متن را روی برچسب‌ها اعمال خواهد کرد. operon از ویرایشگر مشخص‌شده در متغیرهای محیطی VISUAL یا EDITOR استفاده می‌کند و در صورت عدم تنظیم آن‌ها، به 'nano' بازمی‌گردد.
operon edit [-h] [--dry-run] <file>...
- -h, --help
- نمایش راهنما و خروج
- --dry-run
- چاپ نتایج بدون تغییر دادن هیچ فایلی
- مثال:
- VISUAL=vi operon edit song.flac
fill
تکمیل برچسب‌ها بر اساس مسیرهای فایل و یک الگوی مشخص.
operon fill [-h] [--dry-run] <pattern> <file>...
- -h, --help
- نمایش این پیام راهنما و خروج
- --dry-run
- نمایش تغییرات، بدون اعمال آن‌ها
- مثال:
- operon fill --dry-run "<tracknumber>. <title>" "01. Was Ist Ist.flac"
نمایش فراداده‌های فایل (SHOW FILE METADATA)
list
تمام برچسب‌ها، مقادیر و شرح هر برچسب را در یک جدول فهرست می‌کند.
operon list [-h] [-a] [-t] [-c <c1>,<c2>...] <file>
- -h, --help
- نمایش راهنما و خروج
- -a, --all
- همچنین فهرست کردن برچسب‌های برنامه‌ای (programmatic)
- -t, --terse
- خروجی مختصر و مناسب برای پردازش توسط اسکریپت است
- -c, --columns <name>,...
- تعیین می‌کند کدام ستون‌ها و با چه ترتیبی باید چاپ شوند
- مثال:
- operon list -a song.flac
operon list -t -c tag,value song.ogg
متاداده‌های غیر برچسبی مانند طول، اندازه و قالب را فهرست می‌کند.
operon info [-h] [-t] [-c <c1>,<c2>...] <file>
- -h, --help
- نمایش راهنما و خروج
- -t, --terse
- خروجی فشرده است و برای پردازش اسکریپتی مناسب می‌باشد
- -c, --columns <name>,...
- تعیین می‌کند که کدام ستون‌ها و با چه ترتیبی چاپ شوند
- مثال:
- operon info a.ogg
اطلاعات هر فایل را که از مقادیر برچسب‌ها ساخته شده است چاپ می‌کند. این الگو می‌تواند با ارسال یک رشتهٔ الگو سفارشی‌سازی شود (برای قالب الگو quodlibet(1) را ببینید)
operon print [-h] [-p <pattern>] <file>...
- -h, --help
- نمایش راهنما و خروج
- -p,--pattern <pattern>
- استفاده از یک الگوی سفارشی
- مثال:
- operon print -p "<album> - <artist>" a.ogg
ویرایش تصاویر تعبیه‌شده (EDIT EMBEDDED IMAGES)
image-extract
استخراج تمام تصاویر تعبیه‌شده در دایرکتوری کاری فعلی یا دایرکتوری مقصد مشخص‌شده.
operon image-extract [-h] [--dry-run] [--primary] [-d <destination>] <file>...
- -h, --help
- نمایش راهنما و خروج
- --dry-run
- تصاویر یافت‌شده و مسیر فایل‌های حاصل را چاپ می‌کند، اما آن‌ها را ذخیره نمی‌کند
- --primary
- تنها استخراج تصاویر اصلی برای هر فایل
- -d,--destination <destination>
- ذخیرهٔ تمام تصاویر در مقصد مشخص‌شده
- مثال:
- operon image-extract asong.mp3 anotherone.ogg
image-set
تصویر ارائه‌شده را به عنوان تصویر اصلی تعبیه‌شده تنظیم می‌کند و تمام تصاویر تعبیه‌شدهٔ دیگر را حذف می‌نماید.
operon image-set <image-file> <file>...
- -h, --help
- نمایش راهنما و خروج
- مثال:
- operon image-set cover.jpg song.mp3
حذف تمام تصاویر جاسازی‌شده از تمام فایل‌های مشخص‌شده.
operon image-clear <file>...
- -h, --help
- نمایش راهنما و خروج
- مثال:
- operon image-clear song.mp3
متفرقه (MISCELLANEOUS)
tags
فهرست کردن تمام برچسب‌های رایج
operon tags [-h] [-a] [-t] [-c <c1>,<c2>...]
- -h, --help
- نمایش راهنما و خروج
- -a, --all
- همچنین برچسب‌های برنامه‌نویسی‌شده را فهرست می‌کند
- -t, --terse
- خروجی مختصر و مناسب برای پردازش در اسکریپت است
- -c, --columns <name>,...
- ستون‌هایی که باید چاپ شوند و ترتیب آن‌ها را مشخص می‌کند
- مثال:
- operon tags -a
operon tags -t -c tag
help
operon help [<command>]
- مثال:
- operon help list
همچنین ببینید (SEE ALSO)
regex(7) exfalso(1) quodlibet(1)