Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/xfangfang/Macast

Macast is a cross-platform application which using mpv as DLNA Media Renderer.
https://github.com/xfangfang/Macast

dlna linux macos media-renderer mpv upnp upnp-renderer windows

Last synced: 23 days ago
JSON representation

Macast is a cross-platform application which using mpv as DLNA Media Renderer.

Lists

README 

        
slogan



# Macast



[![visitor](https://visitor-badge.glitch.me/badge?page_id=xfangfang.Macast)](https://github.com/xfangfang/Macast/releases/latest)

![stars](https://img.shields.io/badge/dynamic/json?label=github%20stars&query=stargazers_count&url=https%3A%2F%2Fapi.github.com%2Frepos%2Fxfangfang%2FMacast)

[![downloads](https://img.shields.io/github/downloads/xfangfang/Macast/total?color=blue)](https://github.com/xfangfang/Macast/releases/latest)

[![plugins](https://shields-staging.herokuapp.com/github/directory-file-count/xfangfang/Macast-plugins?type=dir&label=plugins)](https://github.com/xfangfang/Macast-plugins)

[![pypi](https://img.shields.io/pypi/v/macast)](https://pypi.org/project/macast/)

[![aur](https://img.shields.io/aur/version/macast-git?color=yellowgreen)](https://aur.archlinux.org/packages/macast-git/)

[![build](https://img.shields.io/github/workflow/status/xfangfang/Macast/Build%20Macast)](https://github.com/xfangfang/Macast/actions/workflows/build-macast.yaml)

[![mac](https://img.shields.io/badge/MacOS-10.14%20and%20higher-lightgrey?logo=Apple)](https://github.com/xfangfang/Macast/releases/latest)

[![windows](https://img.shields.io/badge/Windows-7%20and%20higher-lightgrey?logo=Windows)](https://github.com/xfangfang/Macast/releases/latest)

[![linux](https://img.shields.io/badge/Linux-Xorg-lightgrey?logo=Linux)](https://github.com/xfangfang/Macast/releases/latest)



[中文说明](README_ZH.md)



A menu bar application using mpv as **DLNA Media Renderer**. You can push videos, pictures or musics from your mobile phone to your computer.



## Installation



- ### MacOS || Windows || Debian



  Download link:  [Macast release latest](https://github.com/xfangfang/Macast/releases/latest)



- ### Package manager



  ```shell

  pip install macast

  macast-gui # or macast-cli

  ```



  Please see our wiki for more information(like **aur** support): [#package-manager](https://github.com/xfangfang/Macast/wiki/Installation#package-manager)  

  Linux users may have problems installing using pip. Two additional libraries that I have modified need to be installed:



  ```shell

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

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

  ```



  **See [this](https://github.com/xfangfang/Macast/wiki/Installation#linux) for Linux compatibility**



- ### Build from source



  Please refer to: [Macast Development](docs/Development.md)



## Usage



- **For ordinary users**  

After opening this app, a small icon will appear in the **menubar** / **taskbar** / **desktop panel**, then you can push your media files from a local DLNA client to your computer.



- **For advanced users**  

  1. By loading the [Macast-plugins](https://github.com/xfangfang/Macast-plugins), Macast can support third-party players like IINA and PotPlayer.  

  For more information, see: [#how-to-use-third-party-player-plug-in](https://github.com/xfangfang/Macast/wiki/FAQ#how-to-use-third-party-player-plug-in)

  2. You can modify the shortcut keys or configuration of the default mpv player by yourself, see: [#how-to-set-personal-configurations-to-mpv](https://github.com/xfangfang/Macast/wiki/FAQ#how-to-set-personal-configurations-to-mpv)



- **For developer**  

You can use a few lines of code to add support for other players like IINA and PotPlayer or even add additional features, like downloading media files while playing videos.  

Tutorials and examples are shown in: [Macast/wiki/Custom-Renderer](https://github.com/xfangfang/Macast/wiki/Custom-Renderer).  

Fell free to submit a pull request to [Macast-plugins](https://github.com/xfangfang/Macast-plugins).  



## FAQ

If you have any questions about this application, please check: [Macast/wiki/FAQ](https://github.com/xfangfang/Macast/wiki/FAQ).  

If this does not solve your problem, please open a new issue to notify us, we are willing to help you solve the problem.



## Screenshots



You can copy the video link after the video is casted：  

copy_uri



Or select a third-party player plug-in  

select_renderer



## Relevant links



[UPnP™ Device Architecture 1.1](http://upnp.org/specs/arch/UPnP-arch-DeviceArchitecture-v1.1.pdf)



[UPnP™ Resources](http://upnp.org/resources/upnpresources.zip)



[UPnP™ ContentDirectory:1 service](http://upnp.org/specs/av/UPnP-av-ContentDirectory-v1-Service.pdf)



[UPnP™ MediaRenderer:1 device](http://upnp.org/specs/av/UPnP-av-MediaRenderer-v1-Device.pdf)



[UPnP™ AVTransport:1 service](http://upnp.org/specs/av/UPnP-av-AVTransport-v1-Service.pdf)



[UPnP™ RenderingControl:1 service](http://upnp.org/specs/av/UPnP-av-RenderingControl-v1-Service.pdf)



[python-upnp-ssdp-example](https://github.com/ZeWaren/python-upnp-ssdp-example)