# MiPlay

**Repository Path**: kiram/MiPlay

## Basic Information

- **Project Name**: MiPlay
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-10
- **Last Updated**: 2026-05-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MiPlay

MiPlay 是小米音箱的隔空播放`桥接器`，可以把多个小米音箱转换为独立 AirPlay 1 设备。
> 本项目参考并整合了 [MiAir](https://github.com/KiriChen-Wind/MiAir)、[miservice-fork](https://pypi.org/project/miservice-fork/)、[AirPlay2-Receiver](https://github.com/openairplay/airplay2-receiver)、[XiaoMusic](https://github.com/hanxi/xiaomusic) 等项目的思路与部分实现，面向自用场景进行了重构。

![miplay-1.webp](./miplay-1.webp)

![miplay-2.webp](./miplay-2.webp)

## ✨ 功能特色

- 小米音箱注册独立 AirPlay 1 设备
- 支持 x86、arm64 架构
- 一机搞定，传统音箱➕小米音箱
    - 小米无线音箱（方便）：MiPlay ➡️ 无线 AirPlay 1
    - 传统有线音箱（专业）：Shairport-Sync ➡️ 有线 AirPlay 2 多房间


## 🚀 部署方式

### 1、Docker Compose（推荐）

```
services:
  miplay:
    image: ghcr.io/juneix/miplay
    # image: docker.1ms.run/juneix/miplay  # 毫秒镜像加速
    container_name: miplay
    network_mode: host
    restart: unless-stopped
    environment:
      WEB_PORT: 8300 #访问端口
    volumes:
      - ./conf:/app/conf
# 如需搭配 Shairport-Sync 使用，请取消注释
#  shairport-sync:
#    image: mikebrady/shairport-sync
#    container_name: airplay2
#    network_mode: host
#    restart: always
#    devices:
#      - /dev/snd:/dev/snd
#    cap_add:
#      - SYS_NICE
```

### 2、Docker CLI

```bash
docker run -d \
  --name miplay \
  --network host \
  --restart unless-stopped \
  -e WEB_PORT=8300 \
  -v "${PWD}/conf:/app/conf" \
  ghcr.io/juneix/miplay
  # docker.1ms.run/juneix/miplay # 毫秒镜像加速 
```

### 3、飞牛应用

飞牛商店的【AirPlay 2 - 隔空播放】已经整合 MiPlay。

![miplay-3.webp](./miplay-3.webp)


### 🔊 音量说明

苹果（分贝）VS 小米音箱（百分比）对照参考表

| 苹果音量 | 滑块位置 | 小米音量 | 说明 |
| :--- | :--- | :--- | :--- |
| **`0.0 dB`** | 100%| **100** | 最大音量 |
| `-5.0 dB` | 约 85% | **83** | |
| `-10.0 dB` | 约 70% | **66** | |
| `-15.0 dB` | 约 50% | **50** | |
| **`-20.0 dB`** | **约 30%** | **33** | 默认安全音量 |
| `-25.0 dB` | 约 15% | **16** | 原版代码音量 |
| **`-30.0 dB`** | 约 1% | **0** | 最小音量 |
| `-144.0 dB` | 0% | **0** | 静音状态 |

## ❤️ 支持项目

- 打赏鼓励：支持我开发更多有趣应用
- 互动群聊：加入 💬 [QQ 群](https://qm.qq.com/q/ZzOD5Qbhce) 可在线催更
- 更多内容：访问 ➡️ [谢週五の藏经阁](https://5nav.eu.org)

<div align="center">
  <table>
    <tr>
      <td align="center">
        <img src="./miplay/web/static/wechat.webp" width="128" /><br/>
        <sub>微信</sub>
      </td>
      <td align="center">
        <img src="./miplay/web/static/alipay.webp" width="128" /><br/>
        <sub>支付宝</sub>
      </td>
    </tr>
  </table>
</div>