loading

Save

json format error

This page does not display all logs. If you want to view all logs, please run from the source code or refer to this instruction.

# FAQ

This document may not be the latest version. Please visit the Macast Wiki for the latest document.

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.

## How to use third-party player plugin

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 plugin 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

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