Install Guide Mac

Overview

1. Extract PlexConnect
2. Create Certificates and install them on the AppleTV and PlexConnect server
3. Run PlexConnect
4. Configure and test your AppleTV

---

Guide

1. Extract the PlexConnect archive you [downloaded earlier] (https://github.com/iBaa/PlexConnect/archive/master.zip). We recommend extracting the folder, then dragging the extracted folder to "Applications".

2. Generate the SSL Certificates by following the [Mac Certificate Guide] (https://github.com/iBaa/PlexConnect/wiki/Install-Guide-Mac-Certificates).

3. Run PlexConnect by first opening a terminal window (Applications -> Utilities -> Terminal), then type the following:

sudo "/Applications/PlexConnect-master/PlexConnect.py"

Provide your Administrator password to complete PlexConnect startup.

You should now see messages like these in the terminal window: Write down the IP_Self: ###.###.###.### address as you will need it for the next step.

You can now minimize the Terminal window.

For manual configuration and advanced features see the [Advanced Settings page.] (https://github.com/iBaa/PlexConnect/wiki/Settings-for-advanced-use-and-troubleshooting)

4. Configure the AppleTV for PlexConnect

   

   -[AppleTV Ethernet Guide] (https://github.com/iBaa/PlexConnect/wiki/Install-Guide-AppleTV-Ethernet)

   -[AppleTV Wi-Fi Guide] (https://github.com/iBaa/PlexConnect/wiki/Install-Guide-AppleTV-Wifi)

This assumes you copied the PlexConnect-master folder to the /Applications folder when you installed PlexConnect. Any other directory is just as fine...

---

Optional: Run PlexConnect as launchctl daemon

On OSX you can run PlexConnect as a daemon, which will automatically start on boot and run as a background process.

1. First, stop the running instance of PlexConnect if you have one open (CTRL-C)
2. Open a terminal window (Applications -> Utilities -> Terminal), then type the following:

cd "/Applications/PlexConnect-master/support/OSX"
sudo ./install.bash

Provide your Administrator password to complete PlexConnect startup. A PlexConnect plist will be installed to /Library/LaunchDaemons (for the forthcoming boots) and the PlexConnect daemon will be started.

Again, this assumes you copied the PlexConnect-master folder to the /Applications...

####Additional Commands

• sudo ./uninstall.bash will shut down the daemon and uninstall it - (removes the plist).
• sudo launchctl unload /Library/LaunchDaemons/com.plex.plexconnect.bash.plist will unload or stop the service for this boot.
• sudo launchctl load /Library/LaunchDaemons/com.plex.plexconnect.bash.plist will restart the process.
• sudo launchctl list | grep plexconnect indicates whether the process is running (first number - PID) and (if neccessary) an error number.

---

[Return to Install Guide] (https://github.com/iBaa/PlexConnect/wiki/Install-Guide)

© 2013 PlexConnect Team