audtool - справочное руководство, опции, примеры команд


ИМЯ

audtool - небольшой инструмент для управления Audacious из командной строки.

СИНТАКСИС

audtool [instance] command [parameter ...] ...

ОПИСАНИЕ

audittool отправляет команды запущенному экземпляру Audacious.

Он может отправлять множество общих команд, таких как переход к следующей песне в списке воспроизведения, а также может распечатывать информацию о состоянии, например название текущей песни.

экземпляр может быть указан как -1, -2 и т. д. (до -9), чтобы указать, какой экземпляр Audacious для управления запуском нескольких экземпляров.

КОМАНДЫ

Текущая информация о песне:

--current-song

Печать отформатированного названия текущей песни. В зависимости от настроек Audacious, это может включать такую информацию, как имя исполнителя и альбома. Чтобы напечатать только название песни, используйте --current-song-tuple-data title.

--current-song-filename

Распечатайте имя файла (полный путь или URI) текущей песни.

--current-song-length

Вывести длину текущей песни в формате M:SS.

--current-song-length-seconds

Вывести длину текущей песни в секундах.

--current-song-length-frames

Вывести длину текущей песни в миллисекундах.

--current-song-output-length

Распечатайте счетчик времени воспроизведения в формате M:SS.

--current-song-output-length-seconds

Распечатать счетчик времени воспроизведения в секундах.

--current-song-output-length-frames

Вывести счетчик времени воспроизведения в миллисекундах.

--current-song-bitrate

Распечатайте потоковый битрейт в битах в секунду.

--current-song-bitrate-kbps

Вывести потоковый битрейт в килобитах в секунду (1 килобит=1000 бит).

--current-song-frequency

Выведите частоту дискретизации в герцах.

--current-song-frequency-khz

Выведите частоту дискретизации в килогерцах.

--current-song-channels

Распечатайте количество аудиоканалов.

--current-song-tuple-data field

Вывести значение именованного поля (исполнитель, год, жанр и т. д.) для текущей песни. Если имя поля не указано, будет напечатан список разрешенных полей.

--current-song-info

Распечатайте потоковый битрейт, частоту дискретизации и количество аудиоканалов.

Команды воспроизведения:

--playback-play

Начать воспроизведение. При паузе воспроизведение возобновится с той же точки. Если он уже активен и не приостановлен, он перезапустится с начала песни.

--playback-pause

Приостановите воспроизведение или возобновите его, если оно уже было приостановлено.

--playback-playpause

Эквивалентно --playback-pause, если воспроизведение активно, иначе --playback-play.

--playback-stop

Остановить воспроизведение.

--playback-playing

Возвращает код выхода 0 (true), если воспроизведение активно.

--playback-paused

Возвращает код выхода 0 (true), если воспроизведение приостановлено.

--playback-stopped

Возвращает код выхода 0 (true), если воспроизведение не активно.

--playback-status

Вывести статус воспроизведения ("воспроизведение", "пауза" или "остановлено").

--playback-seek time

Ищите заданное время в секундах относительно начала песни.

--playback-seek-relative time

Поиск заданного времени в секундах относительно текущего счетчика времени.

--playback-record

Переключить запись выходного потока (используя FileWriter).

--playback-recording

Возвращает код выхода 0 (true), если запись потока включена.

Выбор плейлиста:

--select-displayed

Указывает, что любые последующие команды списка воспроизведения должны применяться к списку воспроизведения, отображаемому в данный момент Audacious, независимо от того, какой список воспроизведения воспроизводится. Этот параметр вступает в силу до тех пор, пока он не будет переопределен с помощью --select-playing или пока не будет перезапущен Audacious.

Также затрагиваются следующие команды:

--current-song
--current-song-filename
--current-song-length[-seconds,-frames]
--current-song-tuple-data
--select-playing

Указывает, что при активном воспроизведении любые последующие команды списка воспроизведения должны применяться к воспроизводимому в данный момент списку воспроизведения. Когда воспроизведение остановлено, поведение такое же, как и при --select-displayed. Этот параметр используется по умолчанию.

Команды плейлиста:

--playlist-advance

Перейти к следующей песне в плейлисте.

--playlist-reverse

Перейти к предыдущей песне в плейлисте.

--playlist-addurl path

Добавьте песню в конец плейлиста. Можно указать либо URI, либо локальный путь к файлу (абсолютный или относительный).

--playlist-insurl path position

Вставьте песню в заданную позицию (на основе одной) в списке воспроизведения.

--playlist-addurl-to-new-playlist path

Добавьте песню в список воспроизведения «Сейчас исполняется», при необходимости создав список воспроизведения, и начните воспроизведение песни. В зависимости от настроек Audacious список воспроизведения может быть сначала очищен.

--playlist-delete position

Удалить песню в указанной позиции из плейлиста.

--playlist-length

Вывести количество песен в плейлисте.

--playlist-song position

Печать отформатированного названия песни в плейлисте.

--playlist-song-filename position

Распечатайте имя файла (полный путь или URI) песни в списке воспроизведения.

--playlist-song-length position

Вывести длину песни в плейлисте в формате M:SS.

--playlist-song-length-seconds position

Вывести длину песни в плейлисте в секундах.

--playlist-song-length-frames position

Вывести длину песни в плейлисте в миллисекундах.

--playlist-tuple-data field position

Вывести значение именованного поля для песни в плейлисте.

--playlist-display

Распечатайте названия всех песен в плейлисте.

--playlist-position

Печать позиции текущей песни в списке воспроизведения.

--playlist-jump position

Перейти к песне в указанной позиции в плейлисте.

--playlist-clear

Очистите плейлист.

--playlist-auto-advance-status

Вывести статус автопрокрутки плейлиста ("включено" или "выключено").

--playlist-auto-advance-toggle

Включить автоматическое продвижение плейлиста.

--playlist-repeat-status

Вывести статус повтора плейлиста ("включено" или "выключено").

--playlist-repeat-toggle

Включить повтор плейлиста.

--playlist-shuffle-status

Вывести статус воспроизведения в случайном порядке ("включено" или "выключено").

--playlist-shuffle-toggle

Переключить плейлист в случайном порядке.

--playlist-stop-after-status

Вывести опцию «остановить после текущей песни» («вкл.» или «выкл.»).

--playlist-stop-after-toggle

Включите опцию «остановить после текущей песни».

Дополнительные команды плейлиста:

--number-of-playlists

Вывести количество открытых плейлистов.

--current-playlist

Вывести номер текущего плейлиста, где «текущий» интерпретируется в соответствии с --select-display или --select-playing.

--play-current-playlist

Начать воспроизведение в текущем плейлисте, возобновив воспроизведение с последней воспроизведенной точки, если это возможно. Когда действует --select-display, эту команду можно использовать для переключения воспроизведения на отображаемый список воспроизведения.

--set-current-playlist playlist

Показать заданный плейлист. Когда действует --select-playing и воспроизводится другой список воспроизведения, эта команда также переключит воспроизведение на данный список воспроизведения. Параметр --select-displayed отключает это поведение.

--current-playlist-name

Печать названия текущего плейлиста.

--set-current-playlist-name title

Установите название текущего плейлиста.

--new-playlist

Вставьте новый список воспроизведения после текущего и переключитесь на него, как если бы использовался --set-current-playlist.

--delete-current-playlist

Удалить текущий плейлист.

Команды очереди воспроизведения:

--playqueue-add position

Добавьте песню в указанную позицию плейлиста в очередь.

--playqueue-remove position

Удалить песню в данной позиции плейлиста из очереди.

--playqueue-is-queued position

Возвращает код выхода 0 (true), если песня в данной позиции плейлиста находится в очереди.

--playqueue-get-queue-position position

Вывести позицию песни в очереди в заданной позиции плейлиста.

--playqueue-get-list-position position

Распечатать позицию песни в плейлисте в заданной позиции очереди.

--playqueue-length

Вывести количество песен в очереди.

--playqueue-display

Вывести названия всех песен в очереди.

--playqueue-clear

Очистить очередь.

Регулятор громкости и эквалайзер:

--get-volume

Вывести текущий уровень громкости в процентах.

--set-volume level

Установите текущий уровень громкости в процентах.

--equalizer-activate [on|off]

Активировать или деактивировать эквалайзер.

--equalizer-get

Распечатайте настройки эквалайзера (предусилитель и усиление для всех полос) в децибелах.

--equalizer-set preamp band0 band1 band2 band3 band4 band5 band6 band7 band8 band9

Установите настройки эквалайзера (предусилитель и усиление для всех полос) в децибелах.

--equalizer-get-preamp

Распечатайте предварительное усиление эквалайзера в децибелах.

--equalizer-set-preamp preamp

Установите предварительное усиление эквалайзера в децибелах.

--equalizer-get-band band

Выведите усиление данной полосы эквалайзера (0-9) в децибелах.

--equalizer-set-band band gain

Установите усиление данной полосы эквалайзера (0-9) в децибелах.

Разнообразный:

--mainwin-show [on|off]

Показать или скрыть окно Audacious.

--filebrowser-show [on|off]

Показать или скрыть окно добавления файлов.

--jumptofile-show [on|off]

Показать или скрыть окно «Переход к песне».

--preferences-show [on|off]

Показать или скрыть окно настроек.

--about-show [on|off]

Показать или скрыть окно «О программе».

--version

Распечатать информацию о версии.

--plugin-is-enabled plugin

Возвращает код выхода 0 (true), если данный плагин включен. Плагин указывается с помощью установленного имени файла без пути к папке и суффикса: например, crossfade для lib/audacious/Effect/crossfade.so.

--plugin-enable plugin [on|off]

Включить или отключить данный плагин. Обратите внимание, что плагины интерфейса и вывода нельзя отключить напрямую, поскольку каждый из них всегда должен быть активен. Включение интерфейса или плагина вывода автоматически отключит предыдущий плагин.

--config-get [section:]name

Распечатайте значение параметра конфигурации. Любое использование этой команды полностью не поддерживается. Как найти раздел и название данного параметра, остается читателю в качестве упражнения.

--config-set [section:]name value

Измените значение параметра конфигурации. Эта команда не поддерживается и опасна. Это может иметь неожиданные побочные эффекты (например, сбой Audacious) или вообще не иметь никакого эффекта. Используйте его на свой страх и риск!

--shutdown

Выключите Audacious.

--help

Распечатайте краткое описание команд auditool.

Команды могут иметь префикс `--' (длинные параметры в стиле GNU) или нет, на ваш выбор.

ОШИБКИ

В настоящее время в auditool нет известных ошибок; если вы их найдете, сообщите о них по адресу https://redmine.audacious-media-player.org/projects/audacious.

АВТОРЫ

audtool был написан Джорджем Авериллом nhjm@nhjm.net и Ариадной Конилл ariadne@dereferenced.org.

Эта страница руководства была написана Адамом Сесиль gandalf@le-vert.net и Киёси Аман kiyoshi@atheme.org. Некоторые дополнительные настройки были внесены Ариадной Конилл ariadne@dereferenced.org и Тони Вруном chainsaw@gentoo.org. Страница руководства была обновлена для Audacious 3.7 и более поздних версий Джоном Линдгреном john@jlindgren.net.

Эта работа находится под лицензией Creative Commons Attribution 3.0 Unported License https://creativecommons.org/licenses/by/3.0/.

СМОТРИТЕ ТАКЖЕ

audacious(1)

ВЕБ-САЙТ

https://audacious-media-player.org