audd cli

Аудд-кли

Записывайте звук и используйте API распознавания музыки AudD из командной строки.

Сценарии audd запрашивают API AudD. Этот репозиторий также содержит audd-notif , который использует audd и libnotify для возврата результата сопоставления.

Зависимости:

Сценарий audd требует:

• завиток

• ffmpeg

В дополнение к вышесказанному сценарий audd-notif требует:

• jq

• уведомить-отправить

• данстифицировать (необязательно)

Установка

Руководство

Просто клонируйте этот репозиторий и поместите сценарии audd и audd-notif в свой $PATH .

Арка (АУР):

Использование вашего любимого помощника AUR:

 $ пара -S audd-cli-git

Использование

$ audd -h
Usage: audd [OPTION]... [FILE]
Query the AudD music recognition API.

Get a free API token at: https://audd.io/

The API token can be read from file:
$ echo "api-token" > "~/.config/audd/api_token"

If no FILE is provided, a recording is made using the AUDIO_SOURCE.

Usage:
    -h                    Show this message and exit.
    -a API_KEY            AudD API token.
    -s AUDIO_SOURCE       ffmpeg audio input source, (default: "default").
    -t RECORDING_TIME     Length of recording time, in seconds, (default: 3).
    -r API_RETURN         AudD API return parameter, see https://docs.audd.io/,
                          (default: "apple_music,spotify").
    -o                    Use the "recognizeWithOffset" endpoint.

Чтобы использовать audd вам необходимо получить ключ API от audd. Укажите ключ API либо с помощью опции -a , либо записав ключ API в ${XDG_CONFIG_HOME:-$HOME/.config}/audd/api_token :

 $ echo "api-token" > "~/.config/audd/api_token"

audd может выполнить запрос, используя аудиофайл (файл не должен быть слишком большим, обычно короче 20 секунд), или, если файл не указан, он запишет аудиосэмпл из предоставленного источника звука (опция -s ).

Вы можете использовать ffmpeg -sources pulse для получения списка доступных источников.

Я рекомендую прочитать документацию по API, чтобы понять параметры -r и -o .