...
- Create a GitHub account if you haven't already.
- While logged into your account, go to https://github.com/open-ephys/plugin-GUI and click the "Fork" button in the upper right. You now have your own copy of the GUI repository. Any changes you make will only affect this copy. (More info on forking here.)
- Make sure you have GitHub for Mac installed.
- Install Xcode if you haven't already.
- (Optional, for plugins that require these external libraries) Use MacPorts to install the HDF5 library (sudo port install hdf5-18, see below) and the ZeroMQ library (sudo port install zmq). Make sure you've run "sudo port selfupdate" recently, so you install the latest versions. (Of the plugins shipped by default, KWIKFormat requires the HDF5 library (version 1.8.12 or higher but below 1.10, see below), and NetworkEvents and EventBroadcaster require ZeroMQ.)
- Direct your browser to https://github.com/yourusername/plugin-GUI, where "yourusername" is replaced by your actual GitHub user name.
- Click the "Clone in Desktop" button.
- In Xcode, select the "OpenEphys.xcworkspace" file from the plugin-GUI/Builds/MacOSX folder.
- Select the "All" scheme.
- Hit the "Run" button to build the GUI and plugins from source.
...
- If some plugins won't compile, it's probably related to issues with the HDF5 or ZeroMQ libraries. If you used MacPorts, the libraries will be installed in /opt/local/lib, and the headers will be found in /opt/local/include. Make sure Xcode knows how to find these files. In the "Build Settings" for the Target (not the Project), add /opt/local/lib to the "Library Search Paths" and /opt/local/include to the "Header Search Paths."
- If you get error like "libsz.a file not found", then it's because of some missing dependencies for HDF5 library (HDF5 needs SZIP library). Run sudo port install szip to fix it.
- Make sure the architecture (32- vs. 64-bit) and base SDK (OS X 10.8, 10.9, or 10.10) are appropriate for your particular machine
HDF5 versions
HDF5 versions 1.10 and higher are not compatible with our code. If your MacPorts repositories are up to date, chances are that the hdf5 package includes a newer version. Fortunately there is a package called hdf5-18 which provides with the adequate libraries. Unless needed for other projects, we recommend not installing the hdf5 package.
Notes on different hardware and software
...