Skip to content
xfangfang edited this page Jan 15, 2022 · 10 revisions

Macast is still in the early stage of development, so it may not be available on your device. In this case, please try the beta version or submit a issue to help us do better.

I don't know how to use

Just open this app, and 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.
You can copy the video link after the video is casted:
copy_uri

Or select a third-party player plug-in (Macast > v0.6)
select_renderer

How to use third-party player plug-in(Macast > v0.6)

  1. Download the plugin you want from xfangfang/Macast-plugins
  2. Open the Macast, and click Open Config Directory in the setting menu
  3. put [some plugin].py in renderer directory
  4. Restart Macast and choose the plugins you want

if you can't find any plug-in you want, check here to learn how to write a custom renderer plug-in, and feel welcome to open a pull requests.

Unable to find Macast from your DLNA client

  • Check whether your firewall blocks Macast.
    A simple way to check firewall is to access the port opened by Macast from other devices (the default is 1068, and you can find in the settings menu)
  • Check your router.
    You should open UPnP and close AP Isolation.
  • Software problems.
    If you are using an iOS device, please make sure that the app's permission to find and connect to devices on your local network is turned on.
    And on some application, you need to wait more than 30s to find Macast. Please wait patiently.
  • UDP multicast problem.
    It is said that Windows and some routers will have adaptation problems, resulting in the failure of Windows to join multicast. In this case, You need to modify the windows registry to force IGMP version to v2.
  • Multiple network cards or complex network conditions.
    Ensure that Macast can be used under the condition of single network card and the same LAN with your DLNA client, solutions for more complex situations are still working in progress.

Crash at startup

Macast opens port 1068 by default. When there is a port conflict on your computer, the application will crash. Please set the application port manually. , then Macast will load the ports you specify from the configuration file.

Unable to close or unresponsive

When a third-party player plug-in is used, the plug-in usually needs to open more threads or processes, resulting in a non response problem when the application exits, which is usually caused by the plug-in itself.

where is the configuration file located

platform path
MacOS $HOME/Library/Application\ Support/Macast/
Linux $HOME/.config/Macast
Windows %HOMEPATH%\AppData\Local\xfangfang\Macast

Language support

check the shell command in docs/i18n.md, feel free to open a pull requests.

How to set personal configurations to mpv

refer to the mpv manual about how to set personal configs: https://mpv.io/manual/stable/#files

create a configuration file at :

platform path
MacOS ~/.config/mpv/mpv.conf
Linux ~/.config/mpv/mpv.conf
Windows %HOMEPATH%\AppData\Roaming\mpv\mpv.conf

and put some mpv command line options into the configuration file, like:

fs-screen==1

this option tells mpv to fullscreen open a new video in desktop 1. more about fs-screen options: https://mpv.io/manual/stable/#options-fs-screen

vf=lavfi="fps=fps=60:round=down"

Convert the video to specified constant frame rate by duplicating or dropping frames as necessary.

In this way, you can also modify the shortcut keys of the mpv player -- just put input.conf to the same directory: https://mpv.io/manual/stable/#input-conf