GetStarted

Introduction

What is Macast?

---

Macast ---- the name comes from Mac + cast. It was originally running only on MacOS as a DLNA media renderer. In subsequent development, it has been compatible with Linux and windows.

MPV is built-in as video player, Macast supports DLNA protocol by default and can be extended to other players and other protocols through the plugin system.

Getting Started

---

See more about Installation

• 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, Macast can support third-party players like IINA and PotPlayer. For more information, see: #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
• 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. Fell free to submit a pull request to Macast-plugins.

Install Plugin

You can find plugins at Macast-plugins

How to install plugin

It is recommended to click the advanced setting of Macast and download the plugin in your web browser.

How to install plugin manually

1. Download Macast from GitHub Release.
2. Download the plugin you want from this repo（See next section for how to download and where to save）.
3. Open Macast, and click Open Config Directory in the setting menu.
4. Put the [some plugin].py you just download into the corresponding folder(renderer or protocol depends on what kind of plugin) of the Macast configuration directory.
5. Restart Macast and choose the plugin you want.

How to download Plugins

You can click [some plugin].py on the right side of the table, and then save the displayed text to the renderer or protocol folder with the corresponding file name.

1. Put Player plugin(like: IINA PotPlayer WebBrowser) in the renderer folder.

2. Put Protocol plugin(like: Nirvana) in the protocol folder.

3. Never forget to read the README.

The following table may not be updated in time. Please go to Macast-plugins to view the latest list.

Plugins	MacOS	Linux	Windows	Description	Links
IINA	☑️			IINA support for Macast	iina.py README
PotPlayer			☑️	PotPlayer support for Macast	potplayer.py README
PI-FM-RDS		☑️ (Only for RaspberryPi)		Use this to send MP3 music in the form of FM broadcast	pi_fm.py README
WebBrowser	☑️	☑️	☑️	This can be used to download media files or get some m3u8 played	web.py README
Nirvana（Protocol）	☑️	☑️	☑️	A protocol created by Bilibili.	nirvana.py README

Write a new plugin

If you can't find any plugins you like, check CustomPlugin to learn how to write a custom plugin, and feel welcome to open a pull requests.