Интерфейс ко всем функциям предоставляет программа ardj. Эта программа первым параметром принимает имя команды, которое может сопровождаться дополнительными параметрами. Все команды и возможные параметры описаны в этом разделе.
При использовании оболочек bash и zsh работает автодополнение команд и параметров, можно использовать кнопку TAB для ускоренного набора.
add-incoming-tracksИщет файлы в папке, указанной в параметре incoming_path конфигурационного файла. Все
найденные файлы с расширениями .mp3 и .ogg перемещаются в медиатеку и удаляются. Если файл не может быть удалён — он игнорируется (чтобы не
добавлять его повторно при каждом последующем вызове).
Эта команда является эквивалентом команды upload джаббера.
configЗапускает текстовый редактор с открытым для редактирования конфигурационным файлом.
console [jid]Открывает интерактивную консоль, эмулирующую общение через джаббер (только без джаббера и вообще без использования сети). Эта функция полезна для отладки, например, когда пользователь жалуется на неожиданное поведение команды, которое не воспроизводится у других пользователей.
db-consoleОткрывает интерактивную консоль для работы с базой данных, SQLite или MySQL. Может использоваться в скриптах (запросы надо передавать через stdin).
db-initИнициализация недостающих таблиц и индексов базы данных. Эта процедура обычно выполняется при установке пакета и больше не нужна. Выполнить её вручную может понадобиться, например, если вы случайно уничтожили базу данных и хотите начать сначала.
db-purgeУдаляет из базы данных мусор, вроде неиспользуемых меток и файлов, относящихся к дорожкам, которые были удалены.
db-statsПоказывает информацию о количестве композиций и их суммарной продолжительности, например: "2883 tracks, 192.0 hours".
download-artist nameСохраняет запрос на загрузку песен указанного исполнителя. Сама загрузка выполняется позже, в фоновом режиме.
Эта команда является эквивалентом команды download джаббера.
export-total-listenersВыводит в stdout общую статистику прослушиваний.
export-yesterday-listenersВыводит в stdout подробную статистику прослушиваний за последние сутки.
find-new-tracksЗапускает поиск новой музыки. Сначала выбираются исполнители, имеющие дорожки с оценками выше средней, затем в Last.fm и Jamendo ищется новая музыка этих исполнителей, которую позволено скачивать.
fix-artist-namesПроверяет имя исполнителя по базе данных Last.fm и исправляет, если сервер рекомендует это. Обычно это приводит к изменению регистра, но может и полностью заменить имя, например, исправив ложную транслитерацию.
helpВыводит краткую сводку по поддерживаемым командам.
mark-hitlistОтмечает примерно десяток лучших песен меткой "hitlist". Реальное количество дорожек обычно чуть больше, потому что отмечаются все дорожки с рейтингом не ниже десятой по счёту (то есть на десятом месте может быть несколько дорожек).
Если настроено взаимодействие с Last.fm, отмеченные дорожки добавляются в «любимые».
mark-liked-by label jid1 jid2 ...Отмечает меткой "label" композиции, которые нравятся всем указанным пользователям. Эту команду можно использовать для создания специфической атмосферы перед прямыми включениями, когда известны будущие участники.
mark-longОтмечает меткой "long" композиции с продолжительностью выше средней. Можно использовать метку для исключения слишком длинных песен из дневной ротации.
mark-orphansОтмечает меткой "orphan" композиции, не находящиеся ни в одном плейлисте.
merge-votesСклеивает голоса пользователей в соответствии со значением параметра jabber_aliases
конфигурационного файла.
queue-flushОчищает очередь заказов.
scan-replaygain [files...]Запускает сканирование ReplayGain для всех файлов, у которых нет нужной информации. Если параметр
files не указан — сканирует все файлы в медиатеке.
Для сканирования используются программы mp3gain и vorbisgain.
serveЗапускает веб-сервер для доступа к Web API. Сервер обычно доступен по адресу localhost:8080, но этот
адрес может быть изменён параметром api_socket конфигурационного файла. Сервер используется
плагином для ices и некоторыми командами джаббера.
Запускать сервер вручную может понадобиться только в отладочных целях. В повседневной работе его запускает системная служба, ещё это можно сделать командой sudo start ardj-server (по умолчанию команда доступна без пароля всем пользователям из группы "ardj").
tags files...Выводит содержимое поддерживаемых тэгов. Эта функция обычно используется в отладочных целях, чтобы убедиться в работоспособности функции чтения тэгов и в корректности самих тэгов. Для работы используется библиотека python-mutagen.
twit "text..."Отправляет указанный текст в Твиттер. Работает только при корректном заполнении параметра
twitter конфигурационного файла, в противном случае пишет что делать.
twit-repliesВыводит сообщения, отправленные на имя используемой учётной записи. Предположительно бесполезная функция.
update-scheduleСобирает на Last.fm информацию о предстоящих концертах интересных исполнителей (имеющих дорожки с
оценками выше средней) и сохраняет её в файл типа JavaScript, указанный в параметре
event_schedule_path конфигурационного файла; этот файл можно использовать для вывода карты на
сайте.
Работает только при корректной настройке взаимодействия с Last.fm.
update-track-lengthsСверяет продолжительность файлов с информацией из базы данных и корректирует её. Полезно запускать после ручного вмешательства в медиатеку.
update-track-weightsСдвигает текущий рейтинг каждой дорожки к реальному. Вредная функция; описанная процедура выполняется автоматически при каждом проигрывании, ручной запуск только сбивает рейтинги.
xmpp-send "message text" [jid]Отправляет сообщение указанному пользователю или в чат, если пользователь не указан (название комнаты
указывается в параметре jabber_chat_room конфигурационного файла).