Kalama NPM | npm.io

kalama

Поисковик музыки и плеер с текстовым интерфейсом.

Зачем

Эта программа предназначена для тех, кто много времени проводит в консоли и любит слушать музыку.

Скорее всего, она подойдёт для гиков, которые не предсталяют своей жизни без таких программ, как zsh, midnight-commander, nano (а то и vim).

Установка

Установите Node.js
Выполните в консоли:

npm i -g kalama

Для Linux или OSX понадобится дополнительно установить MPlayer.

Debian:

sudo apt install mplayer

OSX:

brew install mplayer

Для Windows установка MPlayer не требуется, потому что kalama делает это автоматически.

Как пользоваться

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

kalama

Затем введите название исполнителя, трека или альбома. Для навигации по списку используйте стрелки. Для выбора — клавишу Enter.

Если был выбран исполнитель, то дальше понадобится выбрать альбом.

После этого запустится плеер.

Для управления плеером используйте комбинации клавиш:

пробел — пауза/пуск
Ctrl + стрелка вправо — следующая песня
Ctrl + стрелка влево — предыдущая песня
стрелки вверх/вниз, затем Enter — перемещение по плейлисту
стрелка вправо — перемотать вперёд на 10 секунд
стрелка влево — перемотать назад на 10 секунд
Ctrl + S — скачать все песни данного плейлиста
Ctrl + W — скачать все песни данного плейлиста во временную папку и показать QR-код для скачивания zip-архива с песнями на мобильное устройство
Ctrl + C — выход
Ctrl + L — показать help
+ — повысить громкость
- — понизить громкость
Escape — "умная клавиша" для переключения в другое окно. Используйте её, чтобы выйти из плеера в поиск, из поиска в плеер (если он был ранее запущен), из help-а или из окна загрузки альбома (при этом загрузка не остановится)

Настройка

Чтобы посмотреть все настройки, выполните команду:

kalama conf-list

Чтобы сбросить все настройки к заводским, выполните команду:

kalama conf-clear

Чтобы задать ключ конфигурации, выполните команду:

kalama conf-set <ключ> <значение>

Чтобы сбросить ключ конфигурации к значению по умолчанию, выполните команду:

kalama conf-delete <ключ>

Доступные ключи конфигурации:

downloads-dir — папка для сохранения песен
temp-dir — временная папка
volume — громкость
cacheMaxSize — максимальный размер кэша (в байтах). По умолчанию 1000000000. Поставьте 0, если не хотите кэшировать треки

В настройках можно использовать макросы:

{OS_DOWNLOADS} — папка "Загрузки" данного пользователя
{OS_HOME} — домашняя папка данного пользователя
{OS_TMP} — временная папка
{/} — разделитель папок в имени файла (/ для UNIX, \ для Windows)
{COLON} — разделитель путей (: для UNIX, ; для Windows)

Как это работает

kalama ищет музыку в открытом онлайн-каталоге, затем воспроизводит её с помощью проигрывателя MPlayer. MPlayer — это открытый проигрыватель, доступный для многих платформ, включая Linux, OSX, Windows. Пользователям с OSX и Linux его необходимо установить вручную. Для Windows MPlayer включён в пакет kalama.

Кэширование

Для более стабильного воспроизведения и экономии трафика kalama скачивает прослушиваемые треки в папку ~/.cache/kalama. Треки, которые давно не воспроизводились, вытесняются из кэша более новыми. Её размер задан в конфигурации параметром cacheMaxSize и по умолчанию равен 1 Гб. Вы можете задать любой размер кэша и проигрыватель будет удалять старые файлы, чтобы держать кэш в заданных пределах. Чтобы выключить кэш, установите размер равным нулю. kalama conf-set cacheMaxSize 0.