# 木头人播放器设计

**Repository Path**: undeadway/modell-player-design

## Basic Information

- **Project Name**: 木头人播放器设计
- **Description**: 木头人播放器的设计文档
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-19
- **Last Updated**: 2026-08-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ![](./logo.svg)

## 名称

锚点播放器（ModellPlayer）

## 简介

### 版本号

0.0.1

### 概要

因为手机、windows、linux 下各用各的音乐播放器，三端极度不统一，体验感严重割裂。  
所以想着自己给自己写一个播放器。
无聊之下，写了一个音乐播放器。  

能实现以下功能

* 可以加入文件和文件夹到播放列表；
* 支持记忆功能，可以是单曲，也可以是播放列表，但只记忆最后一个播放的内容；
* 操作感、界面达到多端统一，目标实现平台：Windows、Linux、Android；
* 可以暂停、停止、上一首、下一首；
* 可以顺序、乱序、循环、单曲循环；
* 可以最小化到系统托盘（windows、Linux）；
* 可以配置最小化设置（windows、Linux）；
* 可以双击列表中的歌曲名称切换播放歌曲；
* 音量调节；
* 可以播放 cue 文件
* 可以调节播放进度
* 更强大的界面操作
* 以及其他暂时没想到的

### 版本控制

#### Electron

目前已经实现了 Electron 。  
但因为 Electron 无法支持 Android ，所以考虑接下来的版本用 Flutter 重写。

#### 未来预计实现的功能

### 运行

下载链接：[度盘提取码：](https://pan.baidu.com/s/1wVvIaWKk2IQDdaUNpZhVgQ)**xvav**

#### Windows
下载 `ModellPlayer-win32-x64.zip`，解压进入后双击 `ModellPlayer.exe` 即可运行程序。

#### Linux
下载 `ModellPlayer-x86_64.AppImage` ，双击直接运行即可。

#### Flutter

学习开发中。

```
lib/
├── main.dart                    # 启动入口，自身没任何逻辑，直接调用 home.dart
├── components/                  # 全局公共基建
│   ├── bottom_tab_bar.dart      # 底部导航栏
│   ├── home.dart/               # 全局首页，用来控制显示哪个模块
│   └── utils/                   # 通用工具
├── features/                    # 业务模块
│   ├── player/
│   │   ├── pages/               # 播放控制主界面
│   │   └── widgets/             # MiniPlayer、歌词等
│   ├── playlist/
│   │   ├── pages/               # 列表主界面
│   │   ├── models/              # Song / Playlist 模型
│   │   └── widgets/             # SongTile
│   └── settings/
│       └── pages/               # 设置主界面
└── shared/
    └── widgets/                 # 等通用组件
```

### 功能详细

1. 首页

显示正在播放的歌曲、循环模式、歌单还是单曲、各种按钮。  
播放歌曲会涉及到IO

UI 参考样式

![](./home.jpg)

2. 歌单

查看歌单，对歌单进行选择、编辑、删除等操作。
也可以从文件系统中选择歌曲加入到歌单，创建歌单（这部分会设计IO）

3. 系统设置

配置歌单的存储位置

版本信息