jdellinger/geemusic

GeeMusic Docker镜像说明

镜像概述

GeeMusic是一个非官方的Alexa技能，旨在连接Google Music与Amazon Alexa设备，让用户无需切换到Amazon Music或订阅额外服务即可通过Alexa语音控制Google Music的播放。本Docker镜像提供该服务的容器化部署方式，方便用户在自有服务器上运行。

核心功能

已实现功能

• 播放指定艺术家、专辑、歌曲、播放列表或电台（例如：“播放Radiohead的歌曲”“播放专辑Plastic Beach”）
• 通过Alexa原生指令控制播放状态（暂停、跳过等）
• 对当前播放歌曲进行点赞/点踩
• 查询当前播放内容
• 播放“我很幸运”电台或最新专辑

Roadmap

• 播放睡前电台
• 播放派对电台

使用场景

适用于拥有Amazon Alexa设备（如Echo、Dot）且主要使用Google Music的用户，希望通过语音指令直接控制Google Music播放，无需切换音乐服务。

配置说明

运行容器时需设置以下环境变量：

• GOOGLE_EMAIL: Google账号***（建议开启2FA并使用应用专用密码）
• GOOGLE_PASSWORD: Google账号密码（或应用专用密码）
• APP_URL: 服务的公开HTTPS URL（无末尾斜杠，如https://your-domain.com）
• DEBUG_MODE: 是否开启调试模式（True/False）
• USE_LIBRARY_FIRST: 是否优先使用个人音乐库（True/False，根据Google Play订阅状态决定）

Docker部署示例

1. 克隆仓库并构建镜像：

bash
git clone https://github.com/stevenleeg/geemusic.git
cd geemusic
docker build -t geemusic .

2. 运行容器：

bash
docker run -d -e GOOGLE_EMAIL=your-email@example.com -e GOOGLE_PASSWORD=your-app-specific-password \
-e APP_URL=https://your-public-url.com -p 4000:4000 docker.xuanyuan.run/geemusic

注意：服务需保持运行且可公开访问，同时需在Amazon Alexa开发者平台配置技能指向该服务的URL（需添加/alexa后缀）。 ===FULL_DESC===