Maloja 自托管音乐记录数据库使用教程

Maloja 自托管音乐记录数据库使用教程

maloja Self-hosted music scrobble database to create personal listening statistics and charts 项目地址: https://gitcode.com/gh_mirrors/ma/maloja

1. 项目介绍

Maloja 是一个简单易用的自托管音乐记录数据库，用于创建个人聆听统计和图表。该项目允许用户以易于解析的格式始终访问自己的数据，而不需要与任何公共或官方音乐数据库同步。Maloja 提供了多种功能，包括关联艺术家分析、多艺术家曲目记录、自定义图片上传、代理记录等功能，同时提供了一个符合标准的 API 以便与其他应用程序或扩展进行交互。

2. 项目快速启动

以下是使用 Docker 或 Podman 快速启动 Maloja 的步骤。

首先，确保你的系统中已安装了 Docker 或 Podman。

然后，执行以下命令来运行 Maloja 容器：

docker run -p 42010:42010 -v $PWD/malojadata:/mljdata -e MALOJA_DATA_DIRECTORY=/mljdata -e MALOJA_SKIP Setup=true krateng/maloja

如果你使用的是 rootless Podman，上述命令不适用。请使用适合 Podman 的参数。

如果要设置管理员密码，可以添加环境变量 MALOJA_FORCE_PASSWORD。

docker run -e MALOJA_FORCE_PASSWORD=yourpassword ...

请将 yourpassword 替换为你的密码。

启动容器后，你可以在浏览器中访问 http://localhost:42010 来使用 Maloja。

3. 应用案例和最佳实践

应用案例

• 个人聆听习惯追踪：使用 Maloja 记录你的音乐播放历史，生成个人专属的聆听统计图表。
• 音乐收藏管理：通过自定义图片和艺术家关联，更好地管理和展示你的音乐收藏。

最佳实践

• 数据导入：如果你之前使用过 Last.fm、Spotify 或 ListenBrainz，可以将数据导出并导入到 Maloja 中。
• API 使用：为不同的音乐播放器设置不同的 API 密钥，以便记录播放数据。

4. 典型生态项目

目前，Maloja 社区并没有明确列出典型的生态项目。但是，你可以通过其提供的 API 和扩展点来开发自己的插件或集成其他音乐服务。此外，社区欢迎贡献者提供新的功能或改进现有功能。

maloja Self-hosted music scrobble database to create personal listening statistics and charts 项目地址: https://gitcode.com/gh_mirrors/ma/maloja