Install Guide Mac

iBaa edited this page Feb 10, 2015 · 33 revisions

Mac

Basic Setup

  1. Extract the PlexConnect archive you downloaded earlier. We recommend extracting the folder, then dragging the extracted folder to "Applications".

  2. Generate the SSL Certificates by following the Mac Certificate Guide.

  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: PlexConnect Terminal 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.

This guide 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) 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 (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)

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