audius-py

A Python SDK and CLI for the Audius Platform.

安装

通过pip

pip install audius-py

从源代码（从根项目目录）

pip install .

注意：为了使用SDK的媒体播放器功能，您必须安装VLC媒体播放器。

快速使用

要创建一个audius SDK实例，请

from audius.sdk import Audius

audius = Audius()

建议您设置一个自定义应用名称（默认为audius-py）。一种方法是通过环境变量

export AUDIUS_APP_NAME="My_Audius_App"

然后，当您创建Audius SDK对象时，它将自动使用此值。

您还可以在创建SDK时指定应用名称（和其他配置），如下所示

from audius.config import Config
from audius.sdk import Audius

config = Config(app_name="my_app")
sdk = Audius(config=config)

另一个配置值示例是主机，例如

export AUDIUS_HOST_NAME="https://audius.example.com"

或

from audius.config import Config

Config(host="https://audius.exmaple.com")

如果您没有指定主机，audius-py将从已知的Audius应用主机列表中选择一个随机主机。要查看所有可用的主机，请运行以下命令

audius hosts

CLI

通过执行以下操作查看所有命令

audius --help

本指南将展示如何直接在终端中流式传输Audius上的一首热门歌曲。首先，使用CLI浏览热门艺术家

audius users top

输出应如下所示

1: Zedd (id=XlJby)
2: Skrillex (id=eAZl3)
3: Aluna (id=5j9VM)
4: kennybeats (id=DrZwG)
5: trillsammy (id=NzMW8)
6: ODESZA (id=2oNg1)
7: noodles (id=b9w8J)
8: kayzo (id=LMdyZ)
9: Disclosure (id=E2O1R)
10: Fat Nick (id=oGKZd)

接下来，复制并使用以下命令中的一个用户ID进行选择

audius users tracks eAZl3

输出应如下所示

Track: Kliptown Empyrean (id=G0wyE)

最后，通过使用其ID在以下命令中播放曲目

audius tracks play G0wyE

歌曲现在应该正在您的终端中流式传输！如果您真的很喜欢这首曲目，可以通过以下操作下载它

audius tracks download G0wyE song.mp3

默认情况下，audius-py会尝试找到最佳播放器。但是，您可以使用--player标志指定您选择的播放器。

audius tracks play G0wyE --player vlc

Python SDK

直接使用Python SDK

from audius.sdk import Audius

sdk = Audius(app="my_app")
for artist in sdk.users.top():
    print(artist["name"])