audd cli

audd-cli

Nehmen Sie Audio auf und verwenden Sie die AudD-Musikerkennungs-API über die Befehlszeile.

Die audd -Skripte fragen die AudD-API ab. Dieses Repository enthält auch audd-notif , das audd und libnotify verwendet, um das Übereinstimmungsergebnis zurückzugeben.

Abhängigkeiten:

Das audd -Skript erfordert:

• Locken

• ffmpeg

Darüber hinaus erfordert das audd-notif -Skript Folgendes:

• jq

• benachrichtigen-senden

• verdunsten (optional)

Installation

Handbuch

Klonen Sie einfach dieses Repo und platzieren Sie die Skripte audd und audd-notif in Ihrem $PATH .

Bogen (AUR):

Mit Ihrem bevorzugten AUR-Helfer:

 $ paru -S audd-cli-git

Verwendung

$ 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.

Um audd verwenden zu können, benötigen Sie einen API-Schlüssel von audd. Geben Sie den API-Schlüssel entweder mit der Option -a an oder indem Sie den API-Schlüssel in ${XDG_CONFIG_HOME:-$HOME/.config}/audd/api_token schreiben:

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

audd kann eine Abfrage mithilfe einer Audiodatei durchführen (die Datei sollte nicht zu groß sein, normalerweise kürzer als 20 Sekunden), oder wenn keine Datei bereitgestellt wird, wird ein Audiobeispiel von der bereitgestellten Audioquelle aufgezeichnet (Option -s ).

Sie können ffmpeg -sources pulse verwenden, um verfügbare Quellen aufzulisten.

Ich empfehle, die API-Dokumente zu lesen, um die Optionen -r und -o zu verstehen.