SpotifyLyrics部署指南：在Windows、Linux和macOS上的完整安装

SpotifyLyrics部署指南：在Windows、Linux和macOS上的完整安装

【免费下载链接】spotifylyricsFetches and displays lyrics to currently playing song in Spotify.项目地址: https://gitcode.com/gh_mirrors/sp/spotifylyrics

SpotifyLyrics是一款能够实时获取并显示Spotify当前播放歌曲歌词的实用工具，让音乐欣赏体验更加丰富。本指南将详细介绍如何在Windows、Linux和macOS三大主流操作系统上安装配置SpotifyLyrics，从环境准备到启动运行，助你轻松实现歌词同步显示。

📋 系统环境准备

在开始安装SpotifyLyrics之前，请确保你的系统满足以下基本要求：

• 已安装Python 3.6或更高版本
• 已安装Spotify桌面客户端
• 稳定的网络连接（用于获取歌词数据）

你可以通过以下命令检查Python版本：

python --version # 或 python3 --version

📦 核心依赖安装

SpotifyLyrics依赖于多个Python库来实现歌词获取和界面显示功能。项目根目录下的requirements.txt文件列出了所有必要依赖，主要包括：

• requests：用于网络请求获取歌词数据
• PyQt5：提供图形用户界面支持
• pyobjc-framework-Cocoa（macOS特有）：与Spotify客户端交互

通用依赖安装命令

pip install -r requirements.txt # 或 pip3 install -r requirements.txt

💻 Windows系统安装步骤

1. 克隆项目仓库

git clone https://gitcode.com/gh_mirrors/sp/spotifylyrics cd spotifylyrics

2. 安装系统依赖

Windows用户可能需要额外安装Microsoft Visual C++ Redistributable，以确保PyQt5等库正常运行。

3. 启动应用程序

python SpotifyLyrics.pyw

程序将自动创建系统托盘图标，右键点击可访问设置菜单。

🐧 Linux系统安装步骤

1. 克隆项目仓库

git clone https://gitcode.com/gh_mirrors/sp/spotifylyrics cd spotifylyrics

2. 安装系统依赖

# Debian/Ubuntu系统 sudo apt-get install python3-pyqt5 python3-requests # Fedora/RHEL系统 sudo dnf install python3-qt5 python3-requests

3. 启动应用程序

python3 SpotifyLyrics.pyw

🍎 macOS系统安装步骤

1. 克隆项目仓库

git clone https://gitcode.com/gh_mirrors/sp/spotifylyrics cd spotifylyrics

2. 安装额外依赖

macOS需要安装AppleScript支持库以与Spotify客户端通信：

pip3 install pyobjc-framework-Cocoa

3. 授权辅助功能

在"系统偏好设置 > 安全性与隐私 > 隐私 > 辅助功能"中，授予终端或你的IDE控制Spotify的权限。

4. 启动应用程序

python3 SpotifyLyrics.pyw

⚙️ 基本配置说明

SpotifyLyrics提供了简单的配置选项，你可以通过编辑example-theme.ini文件来自定义歌词显示样式，包括：

• 字体大小和颜色
• 背景透明度
• 窗口位置和大小

修改完成后，将文件重命名为theme.ini即可应用自定义主题。

🔍 常见问题解决

问题1：无法获取歌词

• 确保Spotify正在播放歌曲
• 检查网络连接是否正常
• 尝试重启Spotify和SpotifyLyrics

问题2：应用程序无法启动

• 检查Python版本是否符合要求
• 确认所有依赖已正确安装
• 查看终端输出的错误信息

问题3：macOS上无法控制Spotify

• 重新检查辅助功能授权
• 确保Spotify桌面客户端已安装并运行
• 尝试运行getCurrentSong.AppleScript测试AppleScript通信

🎉 开始使用SpotifyLyrics

完成上述步骤后，SpotifyLyrics将在后台运行，并自动为你当前播放的Spotify歌曲显示同步歌词。你可以通过系统托盘图标随时访问设置，调整显示效果以获得最佳体验。

享受你的音乐时光，让歌词与旋律完美同步！

【免费下载链接】spotifylyricsFetches and displays lyrics to currently playing song in Spotify.项目地址: https://gitcode.com/gh_mirrors/sp/spotifylyrics