Install Guide Mac
Clone this wiki locally
Extract the PlexConnect archive you downloaded earlier. We recommend extracting the folder, then dragging the extracted folder to "Applications".
Generate the SSL Certificates by following the Mac Certificate Guide.
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.
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 (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
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.