audd cli

audd-cli

オーディオを録音し、コマンド ラインから AudD 音楽認識 API を使用します。

auddスクリプトは AudD API にクエリを実行します。このリポジトリには、 auddとlibnotify使用して一致結果を返すaudd-notif含まれています。

依存関係:

auddスクリプトには以下が必要です。

• カール

• ffmpeg

上記に加えて、 audd-notifスクリプトには以下が必要です。

• jq

• 通知送信

• ダンスティファイ (オプション)

インストール

マニュアル

このリポジトリのクローンを作成し、 $PATHにauddスクリプトとaudd-notifスクリプトを配置するだけです。

アーチ (AUR):

お気に入りの AUR ヘルパーを使用します。

 $ paru -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使用するには、audd から API キーを取得する必要があります。 -aオプションを使用するか、API キーを${XDG_CONFIG_HOME:-$HOME/.config}/audd/api_tokenに書き込むことによって、API キーを指定します。

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

auddオーディオ ファイルを使用してクエリを実行できます (ファイルは大きすぎてはいけません。通常は 20 秒未満です)。ファイルが指定されていない場合は、指定されたオーディオ ソースからオーディオ サンプルを録音します ( -sオプション)。

ffmpeg -sources pulse使用して、利用可能なソースを一覧表示できます。

-rオプションと-oオプションを理解するには、API ドキュメントを読むことをお勧めします。