Интерфейс ко всем функциям предоставляет программа 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
конфигурационного файла).