# lm

**Repository Path**: panyu_me/lm

## Basic Information

- **Project Name**: lm
- **Description**: lm 全名 local-music 本地音乐播放器
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-04-06
- **Last Updated**: 2025-04-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

lm 全名 local-music
# 本地音乐播放器

这是一个简单易用的本地音乐播放器，使用Python和PyQt6开发，支持常见音乐格式的播放和管理。本应用程序提供了直观的用户界面和丰富的功能，让您可以轻松管理和欣赏本地音乐收藏。

## 功能特点

- **多格式支持**：播放MP3、WAV、FLAC、AAC等常见音乐格式
- **音乐库管理**：自动扫描和管理音乐文件，支持按文件夹浏览
- **搜索功能**：快速搜索歌曲、艺术家或专辑
- **播放控制**：播放/暂停、上一首、下一首、进度调整
- **音量控制**：通过滑块轻松调节音量
- **多种播放模式**：顺序播放、单曲循环、随机播放
- **歌词显示**：自动查找和显示LRC格式歌词
- **主题切换**：支持明亮/暗黑主题

## 系统要求

- Windows 7/8/10/11 操作系统
- Python 3.6 或更高版本
- VLC 媒体播放器（用于音频播放引擎）
- 至少 4GB 内存和 100MB 可用磁盘空间

## 安装步骤

1. 确保已安装 Python 3.6 或更高版本
2. 安装 VLC 媒体播放器（可使用项目根目录下的 `vlc-installer.exe` 或 `安装包` 目录中的安装程序）
3. 安装项目依赖：
   ```bash
   pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
   ```
   注意：使用国内镜像源可以加速下载

## 使用说明

1. 启动程序：
   ```bash
   python main.py
   ```
   或直接运行打包后的可执行文件（如果已打包）

2. 添加音乐：
   - 点击菜单栏的"文件" -> "打开文件夹"
   - 选择包含音乐文件的文件夹
   - 程序会自动扫描并添加支持的音乐文件
   - 扫描完成后，音乐文件将显示在播放列表中

3. 浏览音乐：
   - 左侧面板显示已扫描的文件夹
   - 点击文件夹可以查看该文件夹下的所有音乐
   - 使用搜索框可以按歌曲名、艺术家或专辑名搜索

4. 播放控制：
   - 双击播放列表中的歌曲开始播放
   - 使用播放控制按钮（上一首、播放/暂停、下一首）
   - 通过进度条调整播放位置
   - 使用音量滑块调节音量

5. 播放模式：
   - 点击播放模式按钮切换不同的播放模式：
     - 顺序播放：按列表顺序播放
     - 单曲循环：重复播放当前歌曲
     - 随机播放：随机选择下一首歌曲

6. 歌词显示：
   - 程序会自动查找与音乐文件同名的.lrc歌词文件
   - 歌词将在中央面板同步显示
   - 当前播放的歌词行会高亮显示

7. 设置：
   - 点击菜单栏的"设置" -> "偏好设置"
   - 可以设置默认音量、界面主题和默认音乐库路径

## 配置文件

程序的配置文件保存在用户目录下的 `.lm_player` 文件夹中：
- `config.json`：保存程序设置（默认音量、主题、音乐库路径等）
- `music.db`：音乐库数据库（存储所有扫描的音乐文件信息）

这些文件会在首次运行程序时自动创建。如果遇到问题，可以删除这些文件让程序重新创建。

## 打包说明

本项目可以打包为独立的可执行文件，无需安装Python即可运行：

1. 确保已安装所有依赖和VLC媒体播放器
2. 运行打包脚本：
   ```bash
   # 方法1：使用批处理文件
   build.bat
   
   # 方法2：直接运行Python脚本
   python build_exe.py
   ```
3. 打包完成后，可执行文件将位于 `dist\本地音乐播放器` 目录中
4. 双击 `本地音乐播放器.exe` 即可运行程序

## 注意事项

1. 首次运行时，需要通过"打开文件夹"添加音乐文件
2. 如果音乐库显示不正确，可以通过"刷新音乐库"更新
3. 播放列表会自动保存，下次启动时会恢复上次的播放状态
4. 歌词文件应与音乐文件同名，扩展名为.lrc
5. 打包后的程序需要安装VLC媒体播放器才能正常运行

## 项目结构

本项目的详细结构说明请参阅 [项目结构说明.md](./项目结构说明.md) 文档，其中包含：

- 目录结构概览
- 核心模块说明（播放器、音乐库、歌词管理、设置）
- 用户界面模块说明
- 程序入口文件说明
- 构建和打包相关文件说明
- 依赖和资源说明
- 配置文件说明

## 故障排除

如果遇到问题，请尝试以下解决方法：

1. **程序无法启动**
   - 确保已安装VLC媒体播放器
   - 确保已安装Microsoft Visual C++ Redistributable（可在`安装包`目录中找到）
   - 检查是否有杀毒软件阻止程序运行

2. **无法播放音乐**
   - 检查音乐文件格式是否支持（MP3、WAV、FLAC、AAC）
   - 确认音乐文件是否完整可读
   - 检查VLC媒体播放器是否正确安装

3. **音乐库问题**
   - 尝试重新扫描音乐库（文件 -> 刷新音乐库）
   - 检查音乐文件路径是否包含特殊字符
   - 尝试删除 `.lm_player` 文件夹中的 `music.db` 文件，让程序重新创建

4. **歌词不显示**
   - 确保歌词文件与音乐文件同名，且扩展名为.lrc
   - 确保歌词文件与音乐文件在同一目录下
   - 检查歌词文件编码是否为UTF-8

5. **界面显示异常**
   - 尝试切换主题（设置 -> 偏好设置）
   - 检查显示器分辨率是否过低（建议至少1280x720）

## 技术支持

如果以上方法无法解决问题，请提供以下信息联系开发者：

1. 操作系统版本
2. 程序版本
3. 详细的错误信息
4. 问题复现步骤


## 安装软件版本说明
PowerShell-7.5.0-win-x64.msi
VC_redist.x64.exe
vlc-3.0.21-win64.exe