This post contains a few tips to install the latest version of Syncplay on macOS. I have personally tested these instructions on macOS 10.11 El Capitan and 10.12 Sierra, but they should work also on older systems with minor corrections. A basic knowledge of how to use a bash terminal is advisable.
If you want to use Syncplay on your Mac, I encourage you to test these instructions. We need to check if our patches work so that we can validate them and proceed to further improvements. Please write in the comments if you encounter any issues following these instructions, I will try to help.
In the following, I provide two methods to install Syncplay: using homebrew or using miniconda. Both methods present advantages and drawbacks that I will not discuss here. At this moment, both methods allow to use Syncplay without any major bugs. Choose the type of installation that you prefer. Note: please do not attempt to use the two methods together, as this may cause conflicts between the two versions of python. If you have issues, ask in the comments before attempting to run the second method.
First of all, it is advisable to update your macOS system to the latest revision available (e.g. 10.11.6 for El Capitan).
Then, install the Command Line Tools for macOS, needed to compile all the packages installed hereafter. Open the Terminal app (located in /Applications/Utilities/) and run
Accept the license and proceed with the installation. Then close and re-open the Terminal app. To verify the installation of the Command Line Tools, run
The output should look like this
Configured with: --prefix=/Library/Developer/CommandLineTools/usr --with-gxx-include-dir=/usr/include/c++/4.2.1 Apple LLVM version 8.0.0 (clang-800.0.42.1) Target: x86_64-apple-darwin15.6.0 Thread model: posix InstalledDir: /Library/Developer/CommandLineTools/usr/bin
If so, proceed with your favorite installation method. Please follow only one of the two installation procedures. Go to 2a) for miniconda and to 2b) for homebrew.
2a) Instructions for miniconda
Download the miniconda installer script from the official website (macOS, Python 2.7, 64-bit bash installer). Access the download folder, usually by executing
and install miniconda by running
chmod +x Miniconda2-latest-MacOSX-x86_64.sh ./Miniconda2-latest-MacOSX-x86_64.sh
Close and re-open the Terminal app.
Create a dedicated environment for syncplay by running
conda create -n syncplay python pyside
Access this new environment by running
source activate syncplay
Your terminal prompt should now start with (syncplay) before your hostname.
Install the other dependencies inside the conda environment
pip install twisted appnope
Exit from the dedicated conda environment
source deactivate syncplay
Everything you need to run Syncplay is now installed. Go to 3) to to download Syncplay.
2b) Instructions for homebrew
Install homebrew. On Terminal, paste an run this:
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
Proceed to install Python from homebrew
brew install python
This command will install a separate version of Python 2.7 on your system. Please note that, in the latest recipes, this command installs the executable as python2 (and pip2), to avoid confusion with the included system version, which stays reachable as python instead. You can use these separate commands or edit your $PATH accordingly. In the following, I will use the separate commands.
Install the latest patched version of PySide 1.2
brew tap cartr/qt4 brew tap-pin cartr/qt4 brew install pyside
Install the other dependencies
pip2 install twisted appnope
Everything you need to run Syncplay is now installed. Go to 3) to download Syncplay.
3) Download Syncplay from GitHub
Clone the git repository of Syncplay on your Mac
cd ~ git clone https://github.com/Syncplay/syncplay.git
This will create a syncplay folder in your Home folder containing all the software code. Go to the next step to set up your preferred media player.
4) Choose your media player: VLC or mpv
If you want to use VLC as player, you need to copy a script file inside the VLC.app package. Enter in the folder in which you cloned syncplay from git by executing
cp resources/lua/intf/syncplay.lua /Applications/VLC.app/Contents/MacOS/share/lua/intf/
Now you can use VLC with syncplay.
Instead, if you want to use mpv, there is no extra command needed.
You may now proceed to the next step.
5) Run Syncplay
Enter in the folder in which you cloned Syncplay by typing
If you used miniconda (2a), run
source activate syncplay ./syncplayClient.py
If you used homebrew (2b), run
Syncplay should now open. If you encounter any error, please comment here pasting the Terminal output.
Comments and known issues
Please, report any issue you will find using Syncplay on macOS here or on the GitHub page of the project.
- menubar: File -> Open Media File: the file browser window opens and closes immediately.
This bug is caused by Qt 4.8.7 on macOS 10.11+. Since Qt4 is not supported upstream anymore, I do not see a way to solve this bug besides migrating the whole project to PySide2.
git links now point directly to the Syncplay repository after the pull request #143 was merged.