Install Guide Mac

Basic Setup

1. Extract the latest PlexConnect archive from (https://github.com/iBaa/PlexConnect/releases). We recommend extracting the PlexConnect folder from the tar.gz file, 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:

export PYTHONHTTPSVERIFY=0
sudo "/Applications/PlexConnect/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.

To shut PlexConnect down cleanly use CTRL-C (do not just close 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)

This guide assumes that you've copied the PlexConnect 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/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 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) or the return value (error, second number).

Sidenote: Need to update Python?

I had a good experience following this manual by Wolf Paulus: [Installing / Updating Python on OSX] (http://wolfpaulus.com/jounal/mac/installing_python_osx/) (steps 1 to 5)

Plus an additional step to allow the OSX firewall rule to stick: code sign Python.app - otherwise you might be asked over and over for permission to accept incoming calls. (Source: [Stackoverflow / OSX firewall to permanently remember Python] (http://stackoverflow.com/questions/15936801/how-can-i-permanently-accept-osx-firewall-allow-deny-confirmation-when-running-p))

sudo codesign -f -s - /System/Library/Frameworks/Python.framework/Versions/2.7/Resources/Python.app

Also, for all the scripts located in /System/Library/Frameworks/Python.framework/Versions/2.7/bin (like easy_install, pip, ...) change the Magic Line to link to your moved python framework: just adding the leading /System:

#!/System/Library/Frameworks/Python.framework/Versions/2.7/Resources/Python.app/Contents/MacOS/Python

This helps those tools to correctly identify and call the new python interpreter.

---

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