Install Guide Mac
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".
Generate the SSL Certificates by following the [Mac Certificate Guide] (https://github.com/iBaa/PlexConnect/wiki/Install-Guide-Mac-Certificates).
Run PlexConnect by first opening a terminal window (Applications -> Utilities -> Terminal), then type the following:
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 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.
- First, stop the running instance of PlexConnect if you have one open (CTRL-C)
- 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...
sudo ./uninstall.bashwill shut down the daemon and uninstall it - (removes the plist).
sudo launchctl unload /Library/LaunchDaemons/com.plex.plexconnect.bash.plistwill unload or stop the service for this boot.
sudo launchctl load /Library/LaunchDaemons/com.plex.plexconnect.bash.plistwill restart the process.
sudo launchctl list | grep plexconnectindicates 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
pip, ...) change the Magic Line to link to your moved python framework: just adding the leading
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)