Plex Media Server Detection - Atelier-Shiori/hachidori GitHub Wiki

Hachidori supports detection with Plex Media Server. This means you can detect media from all clients (Plex Home Theater, Plex Web and Plex Media Player) without having to turn off the Plex Agent. The program will retrieve the metadata of the playing video file to get the source file name used for detection. If you are playing transcoded media, Plex Agent's Metadata will be used instead if available or the title.

You must login with your Plex account before you can detect from Plex Media Server. You can do this in the Plex Preferences pane. Once you log in, Hachidori will save the token to the Keychain.

Here are the settings:

  • Host: This host name to your Plex server. Plex Media Server detection will work with IP address and and hostnames (example.no-ip.org). However, you shouldn't disable ping as Hachidori relies on it to see if the server is online. To detect outside your network, you need to use a sub-domain/domain linked to public IP address and if necessary, use port forwarding. You may also specify an IP address to a host address in the /etc/hosts file and it will detect.
  • Port: The port number for Plex Media Server. You shouldn't change this unless your server is running off a different port.
  • Use secure connection - Hachidori will use HTTPS to communicate with Plex Media Server if this option is enabled.
  • Client ID: The unique identifier used for Plex web API.

Not detecting anything?

Hachidori will only detect sessions where the video is playing. Since a user can have multiple sessions, it will only take the one that is currently playing a video file.