Skip to content
xfangfang edited this page Sep 10, 2021 · 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 (available in beta version)
select_renderer

How to use third-party player plug-in

  1. Download the beta version from GitHub actions
  2. Download the plugin you want from xfangfang/Macast-plugins
  3. Open the Macast, and click Open Config Directory in the setting menu
  4. put [some plugin].py in renderer directory
  5. 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 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 use an iOS application, 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.
    DLNA uses UDP multicast to discover new devices. Port 1900 may be occupied on windows and some Linux. At this time, macast cannot receive requests from DLNA clients. In this case, please close other applications.
    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.
    To ensure that it can be used under the condition of single network card and the same LAN, solutions for more complex situations are still under consideration.

Crash at startup

Macast opens port 1068 by default. When there is a port conflict on your computer, the application will crash. Please try the beta version. In the beta version, Macast will automatically switch the conflicting ports, or 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

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

Clone this wiki locally