.TH ELEKTROID-CLI "1" "Jan 2023"

.SH "نام (NAME)"
elektroid-cli \- ابزار خط فرمان مدیریت سمپل‌ها و دستگاه‌های میدی (MIDI)

.SH "خلاصه دستور (SYNOPSIS)"
.B elektroid-cli
.RI [ options ]
.RI command

.SH "توضیحات (DESCRIPTION)"
.B elektroid-cli
بخشی از بسته Elektroid است که ابزاری برای مدیریت نمونه‌های صوتی (سمپل) و دستگاه‌های MIDI به شمار می‌رود. برای برنامه گرافیکی، راهنمای elektroid را با دستور man elektroid ببینید.
.PP
با استفاده از Elektroid می‌توانید به آسانی فایل‌های صوتی را بارگذاری و بارگیری کرده و انواع داده‌های مختلف مانند پریست‌ها، پروژه‌ها یا کوک‌ها (tuning) را روی دستگاه‌های MIDI گوناگون مدیریت کنید. همچنین می‌توان از آن برای ارسال و دریافت فایل‌های SysEx MIDI بهره برد.

.SH "دستگاه‌های پشتیبانی‌شده (SUPPORTED DEVICES)"
.IP \[bu] 2
Arturia MicroBrute
.IP \[bu]
Arturia MicroFreak
.IP \[bu]
Casio CZ-101
.IP \[bu]
Elektron Analog Four MKI, MKII and Keys
.IP \[bu]
Elektron Analog Heat MKI, MKII and +FX
.IP \[bu]
Elektron Analog Rytm MKI and MKII
.IP \[bu]
Elektron Digitakt I and II
.IP \[bu]
Elektron Digitone I and II and Digitone Keys
.IP \[bu]
Elektron Model:Cycles
.IP \[bu]
Elektron Model:Samples
.IP \[bu]
Elektron Syntakt
.IP \[bu]
Eventide ModFactor, PitchFactor, TimeFactor, Space and H9
.IP \[bu]
KORG padKONTROL
.IP \[bu]
KORG Volca Sample and Volca Sample 2
.IP \[bu]
Moog Little Phatty and Slim Phatty
.IP \[bu]
Novation Summit and Peak
.IP \[bu]
سمپلرهای پیاده‌سازی‌کننده MIDI SDS

.SH "دستورات دستگاه (DEVICE COMMANDS)"
دستورات دستگاه مستقیماً بر روی خود دستگاه اعمال می‌شوند. برای دستوراتی که بر روی انواع داده‌های ارائه‌شده توسط دستگاه عمل می‌کنند، بخش دستورات سیستم‌فایل را ببینید.
.TP
[ \fBld\fR | \fBlist-devices\fR ]
فهرست کردن دستگاه‌ها
.TP
\fBinfo\fR device_number
نمایش اطلاعات دستگاه
.TP
[ \fBdf\fR | \fBinfo-storage\fR ] device_number
نمایش اندازه و میزان مصرف حافظه‌های در دسترس
.TP
\fBsend\fR file device_number
ارسال فایل داده MIDI به دستگاه
.TP
\fBreceive\fR device_number file
دریافت فایل داده MIDI از دستگاه
.TP
\fBupgrade\fR firmware device_number
ارتقای سفت‌افزار دستگاه
.TP
\fBplay\fR file
پخش فایل صوتی
.TP
\fBrecord\fR file
ضبط در فایل صوتی

.SH "دستورات سیستم‌فایل (FILESYSTEM COMMANDS)"
عملیات سیستم‌فایل مختلف روی کانکتورهای گوناگون پیاده‌سازی شده‌اند، بنابراین یک دستور دارای یکی از فرم‌های زیر است:
.IP \[bu] 2
نام کانکتور، دو‌نقطه (':')، نام سیستم‌فایل، دو‌نقطه (':') و خود عملیات. این روش پیشنهادی و ارجح است.
.IP \[bu]
نام کانکتور، خط‌تیره ('-')، نام سیستم‌فایل، خط‌تیره ('-') و خود عملیات. باید از این روش اجتناب شود.
.TP
مسیرهای ارائه‌شده باید همیشه با شناسه دستگاه و علامت دو‌نقطه (':') آغاز شوند، مانند 0:/samples. مسیرهایی که به یک فایل داده، صدا یا پروژه اشاره دارند، به جای نام فایل از نمایه (index) آن فایل استفاده می‌کنند.
.TP
عملیات‌های در دسترس به شرح زیر است:
.TP
[ \fBls\fR | \fBlist\fR ] device_number:path_to_directory
فهرست کردن محتویات دایرکتوری
.TP
\fBmkdir\fR device_number:path_to_directory
ایجاد دایرکتوری و پوشه‌های والد آن در صورت نیاز
.TP
[ \fBrmdir\fR | \fBrm\fR ] device_number:path_to_directory
حذف بازگشتی دایرکتوری
.TP
[ \fBul\fR | \fBupload\fR ] file device_number:path_to_file_or_directory
بارگذاری فایل. اگر مسیر وجود نداشته باشد، ایجاد خواهد شد.
.TP
[ \fBdl\fR | \fBdownload\fR | \fBrdownload\fR | \fBrdl\fR | \fBbackup\fR ] device_number:path_to_file_or_directory [ destination ]
بارگیری فایل در دایرکتوری مقصد یا دایرکتوری جاری در صورت عدم تعیین مقصد.
.TP
\fBmv\fR device_number:path_to_file_or_directory device_number:path_to_file_or_directory
انتقال فایل. اگر مسیر مقصد وجود نداشته باشد، ایجاد خواهد شد.
.TP
\fBrm\fR device_number:path_to_file
حذف فایل
.TP
\fBcl\fR device_number:path_to_file
پاک‌سازی فایل
.TP
\fBcp\fR device_number:path_to_file device_number:path_to_file
کپی کردن فایل
.TP
\fBsw\fR device_number:path_to_file device_number:path_to_file
جابجایی دو فایل (Swap)

.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-v\fR
ارائه خروجی پرجزئیات (Verbose). برای افزایش بیشتر سطح جزئیات، می‌توان بیش از یک بار از آن استفاده کرد.

.SH "مثال‌ها (EXAMPLES)"
.TP
\fBelektroid-cli ld\fR
دستگاه‌های در دسترس را فهرست می‌کند.
.TP
\fBelektroid-cli info 0\fR
اطلاعات مربوط به دستگاه را شامل کانکتور و سیستم‌های فایل در دسترس نمایش می‌دهد.
.TP
\fBelektroid-cli elektron:sample:ul square.wav 0:/waveforms\fR
یک سمپل صوتی را در دستگاه Elektron بارگذاری می‌کند.
.TP
\fBelektroid-cli sds:mono-16b:dl 0:/1\fR
یک سمپل ۱۶ بیتی مونو را از یک سمپلر SDS بارگیری می‌کند.
.TP
\fBelektroid-cli summit:single:ls 0:/A\fR
پچ‌های تکی Novation Summit در بانک A را فهرست می‌کند.

.SH "همچنین ببینید (SEE ALSO)"
صفحه پروژه در گیت‌هاب مثال‌هایی ارائه می‌دهد: <https://dagargo.github.io/elektroid>

.SH "نویسندگان (AUTHORS)"
برنامه elektroid-cli توسط David García Goñi <dagargo@gmail.com> نوشته شده است.
.PP
این صفحه راهنما توسط Dennis Braun <snd@debian.org> برای پروژه دبیان نوشته شده است (اما ممکن است توسط دیگران نیز استفاده شود).