Macast

README_EN

Macast是一个跨平台的 菜单栏\状态栏 应用，用户可以使用电脑接收发送自手机的视频、图片和音乐，支持主流视频音乐软件和其他任何符合DLNA协议的投屏软件。

😂 请尽量使用英语在Github交流，如果喜欢的话可以点个star关注后续更多协议支持的更新

安装

进入页面选择对应的操作系统下载即可，应用使用方法及截图见下方。

• MacOS || Windows || Debian

  下载地址1: Macast 最新正式版 github下载

  下载地址2: Macast 最新正式版 gitee下载（上面访问无效可使用此备用链接）

• 包管理

  你也可以使用包管理器安装macast

  # 需要 python>=3.6
  pip install macast

  请查看我们的wiki页面获取更多的包管理相关信息（如：aur）: Macast/wiki/Installation#package-manager
  Linux用户使用包管理器安装时运行可能会有问题，建议替换如下两个库为我修改过的库（分别负责菜单显示与文本复制）：

  pip install git+https://github.com/xfangfang/pystray.git
  pip install git+https://github.com/xfangfang/pyperclip.git

  Linux用户如果安装或运行有问题，可以查看 这里

• 从源码构建或运行

  构建请参阅: Macast Development 和 build-macast.yaml

  运行只需要clone仓库，根据不同的操作系统于requirements文件中安装相关的包，并在项目根目录运行 Macast.py 即可。

使用方法

• 普通用户

  1. 打开应用后，菜单栏 \ 状态栏 \ 任务栏 会出现一个图标，这时你的设备就可以接收来自同一局域网的DLNA投放了。

• 进阶用户

  1. 通过手动加载 Macast插件, Macast可以支持调用其他播放器，如：IINA、PotPlayer等等，或适配国内各家私有的DLNA协议.
  2. 在应用内点击高级设置，可以直接在内置的插件商店中快速下载插件（使用github仓库地址，如果网络条件不好刷新不出来，那么还是通过手动加载的方式下载吧）
  3. 支持修改默认播放器的快捷键或其他参数，见：#how-to-set-personal-configurations-to-mpv

• 程序员

  1. 可以依照教程完成自己的脚本，快速地适配到你喜欢的播放器，或者增加一些新的功能插件，比如：边下边看，自动复制视频链接等等。教程和一些示例代码在：Macast/wiki/Custom-Renderer
  2. 也可以参考 nirvana 快速适配第三方魔改的DLNA协议。

欢迎大家提交代码到Macast插件。
注意：不要轻易加载非官方仓库下载的插件，这里“插件”本身是可以运行在电脑上的任意代码，不建议加载非官方提供的插件。

开发计划

• 完成第一版应用，支持MacOS
• 添加对Linux和Windows的支持
• 完善协议，增强软件适配性
• 统一MacOS与其他平台的UI
• 添加多播放器支持
• 添加多网卡支持
• 添加自定义端口和自定义播放器名称
• 改进目前的播放器控制页面
• 增加插件商店
• 添加bilibili弹幕投屏
• 支持airplay

出现问题的可能原因及解决办法（更详细内容见项目的wiki）

0. 应用闪退
   大概率是由windows的hyper-v占用端口号导致的，建议修改hyper-v占用的端口号范围或修改本应用的启动端口号（Macast配置文件位置）
1. 无法搜索到Macast——被电脑防火墙拦截
   手机尝试访问 http://电脑ip:1068，如:192.168.1.123:1068 如果出现helloworld 等字样排除问题。
   具体端口号见应用菜单设置的第一项，如果没有则为默认的1068
2. 无法搜索到Macast——路由器问题
   路由器需要开启UPnP，关闭ap隔离，确认固件正常（部分openwrt有可能有问题）
3. 无法搜索到Macast——手机软件有问题
   可以重启软件或更换软件尝试，或向其他投屏接收端电视测试 尝试在搜索页面等待久一点（最多1分钟如果搜不到那应该就是别的问题了） 如操作系统为IOS，注意要开启软件的本地网络发现权限
4. 无法搜索到Macast——网络问题
   请确定手机和电脑处在同一网段下，比如说：电脑连接光猫的网线，手机连接路由器wifi，这种情况大概率是不在同一网段的，可以查看手机和电脑的ip前缀是否相同。
5. 无法搜索到Macast——其他未知问题
   尝试在同一局域网手机投电视，如果可以正常投说明问题还是出在电脑端，继续检查电脑问题或查看如何报告bug

对于反馈问题的说明

1. 先确保自己有认真读过使用说明
2. 在提issue时，请及时地回复作者的消息，太多人提完问题或者反馈就消失，提之前先看别人问过没有，提之后积极参与讨论。如果您做不到回复issue，请不要随便提issue浪费开发者的时间。
3. 遇到问题不要只说现象，请附带所有你认为能帮助开发者解决问题的信息，这会让开发者认为你很聪明，且极大的帮助加快解决你的问题与节省开发者的时间。
4. 如果你遇到了某个问题，请优先考虑是自己没有看使用说明，比如我遇到过很多很多遭遇了投屏搜索不到的用户，直接评论说，“这个软件用不了”。用不了那是我编出来逗你玩的吗？检查一下自己的防火墙OK？
5. 如果你不能自己去写，请不要提出那种很难实现的需求，开发者愿意解决的是：“我有个需求，讨论一下要怎么实现” 而不是 “可以帮我给这个软件加上***功能吗？”

如何报告bug

准备以下信息，推荐到Github报告问题，点击 new issue 去反馈问题：

1. 你的电脑系统类型和版本：如Win10 20h2
2. 你使用的手机系统和软件：如 安卓 bilibili
3. bug复现：如何复现bug与bug是否可以稳定复现
4. 程序运行的log（复现问题时候的log）：
   - windows下载debug版应用, 拖入cmd执行，复现问题后，关闭应用，ctrl-a全选复制：download debug
   - mac 终端输入：/Applications/Macast.app/Contents/MacOS/Macast 回车运行，复现问题后，关闭应用，复制log
   - linux 安装deb后，命令行运行 macast \ 或直接从源码运行 \ 或包管理安装后命令行运行 macast-cli，复现问题后，关闭应用，复制log

用户反馈

点击链接加入群聊【小方的软件工地】：983730955

当然也可以考虑捐赠 获得贵宾售后服务（开玩笑） 支持Macast和他的开发者们为了这个软件熬过的日日夜夜

使用截图

如果系统设置为中文，Macast会自动切换中文界面

在投放视频或其他媒体文件后，可以点击应用图标复制媒体下载链接

支持选择第三方播放器

相关链接

UPnP™ Device Architecture 1.1

UPnP™ Resources

UPnP™ ContentDirectory:1 service

UPnP™ MediaRenderer:1 device

UPnP™ AVTransport:1 service

UPnP™ RenderingControl:1 service

python-upnp-ssdp-example