kalama

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

Зачем

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

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

Установка

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

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.