Ampcast 音乐播放器使用教程

1. 项目介绍

Ampcast 是一个受 Winamp 启发的音乐播放器。它支持多种流媒体服务，如 Plex、Jellyfin、Emby、Navidrome 和 Subsonic 等，并且还提供了对 Apple Music、Spotify 和 YouTube 的额外支持。Ampcast 拥有内置的视觉特效，如 Milkdrop (Butterchurn)，支持 last.fm 和 ListenBrainz 的 Scrobbling 功能，并且可以从这些服务中播放音乐。Ampcast 可以作为 Web 应用程序或渐进式网络应用程序（PWA）使用，并且提供了桌面应用程序版本，支持 Windows、Mac 和 Linux 系统。

2. 项目快速启动

环境准备

确保你的系统安装了 Node.js，版本要求大于等于 20。

克隆项目

git clone https://github.com/rekkyrosso/ampcast.git
cd ampcast

安装依赖

npm i

构建开发环境

npm run build:dev

启动 Web 服务器

npm run start:dev

在浏览器中访问 http://localhost:8000，即可运行应用程序。

使用不同的主机/端口启动服务器

npm run start:dev -- --host 0.0.0.0 --port 8001

请注意，使用除 localhost 以外的地址可能会遇到 CORS 错误。

配置选项

你可以创建一个 .env 文件来存储 API 密钥和其他配置选项。

3. 应用案例和最佳实践

桌面应用程序

Ampcast 提供了桌面应用程序版本，可以在 Windows、Mac 和 Linux 上运行。从以下链接下载对应系统的版本：

https://github.com/rekkyrosso/ampcast/releases/latest

自托管

如果你希望自托管 Ampcast，可以使用 Docker。Docker 镜像托管在 ghcr.io 上，可以通过以下命令运行容器：

docker run --name ampcast -p 8000:8000 ghcr.io/rekkyrosso/ampcast:latest

或者使用 docker-compose：

docker-compose up -d

使用提供的 docker-compose.yml 文件作为模板。

4. 典型生态项目

目前，Ampcast 作为一个开源项目，其生态系统仍在不断发展中。你可以通过以下途径参与项目，比如：

• 提交问题报告或功能请求；
• 在 GitHub 的讨论区域或 Reddit 上的通用讨论论坛中交流；
• 贡献代码或文档。

Ampcast 使用 TypeScript、GLSL、SCSS、JavaScript、HTML 和 Dockerfile 等技术栈构建。欢迎更多的开发者参与到这个项目中来，共同打造一个优秀的音乐播放器。