# Macast

**Repository Path**: wd34zc/macast

## Basic Information

- **Project Name**: Macast
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: GPL-3.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-18
- **Last Updated**: 2026-06-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<img align="center" src="macast_slogan.png" alt="slogan" height="auto"/>

# Macast 魔改版

> **本项目基于 [xfangfang/Macast](https://github.com/xfangfang/Macast) 进行修改，感谢原作者 xfangfang 的开源精神与优秀作品。如果你觉得 Macast 好用，请去原项目点个 Star，也欢迎下载原版体验。**

---

## 魔改内容

基于 Macast v0.7，做了以下改动：

### Bug 修复

| 问题 | 修复 |
|------|------|
| Android 手机投屏时 SUBSCRIBE 返回 500 错误 | 处理 `Timeout: infinite` 头，兼容非标准 UPnP 客户端 |
| 新版 mpv 拒绝 `loadfile` 的 options 参数 | 移除 options 参数，全屏等功能改用独立 IPC 命令 |
| 投屏后 mpv 窗口在后台，需手动点击 | 通过 AttachThreadInput 抢键盘焦点，投屏自动前置 |

### 功能增强

| 功能 | 快捷键 | 说明 |
|------|--------|------|
| 全屏切换 | **空格** | 全屏 / 退出全屏 |
| 暂停播放 | **回车** | 暂停 / 继续 |
| 音量控制 | **↑ / ↓** | 音量 +5 / -5 |
| 倍速调节 | **z / x / c** | z 减速 0.1x、x 加速 0.1x、c 恢复 1.0x |

### 界面优化

- 右键托盘菜单扁平化，去掉二级设置菜单，所有选项一览无余
- 新增「使用说明」菜单项，点击打开内置网页查看快捷键
- 隐藏 IP 和版本号，菜单更简洁
- 内置设置网页全面中文化

### 技术变更

- 网络库从 `netifaces` 迁移到 `ifaddr`（纯 Python，更易安装）
- 内置 mpv 更新至 2026-06-10 版本
- 编译了中文 `.mo` 翻译文件，托盘右键菜单全部显示中文
- 新增 `tools/po2mo.py` .po 编译工具

---

## 安装与运行

从 [Releases](../../releases) 下载 `Macast-Windows-v0.7.dong.exe`，双击运行即可。

源码运行：
```shell
pip install -r requirements/common.txt
python Macast.py
```

---

## 许可

本项目遵循原项目 [GPL v3](https://github.com/xfangfang/Macast/blob/main/LICENSE) 许可证。

---

## 致谢

再次感谢 [xfangfang](https://github.com/xfangfang) 创造了 Macast，让手机投屏到电脑变得如此简单。