Skip to content

Install Guide Mac

moodyblue edited this page Oct 23, 2018 · 34 revisions

Mac

Basic Setup

  1. Extract the PlexConnect archive you [downloaded earlier] (https://github.com/iBaa/PlexConnect/archive/V0.6.tar.gz). 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: 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.] (https://github.com/iBaa/PlexConnect/wiki/Settings-for-advanced-use-and-troubleshooting)

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] (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)

You can’t perform that action at this time.