BrainVoyager 21.2 for macOS

BrainVoyager is our flagship product that provides a comprehensive, fast and elegant way to perform advanced neuroimaging data analysis and to create stunning visualizations. For more information, read the BrainVoyager release blog posts.

Installation and licensing
. BrainVoyager uses a software-based licensing system and will not run without a valid single computer or floating network license. In order to install BrainVoyager for evaluation or to update a licensed version to the latest release, please use the link below:
BrainVoyager_Installer_v21.2_Mac64.pkg (385 MB)

If you do not yet have a license, you can ask for a time-limited trial license to evaluate BrainVoyager with your own data. A trial license unlocks most features of a full license lacking only optional components (no scripting and plugins). You need to accept the license agreement during installation.
In case you have installed an older version of BrainVoyager or BrainVoyager QX, close any running instance prior to installation. We recommend to deinstall the older version of BrainVoyager by simply moving the "BrainVoyager" folder located in the "/Applications" folder to the Trash; it is also advised to remove the BrainVoyager icon by dragging it out of the dock area (otherwise there might be two icons after the new install). The installer might still detect that an older version of BrainVoyager was installed before; in this case, the installer may show an "Upgrade" button instead of an "Install" button, but in both cases the same files will be installed.

Double-click the downloaded installation package file (“BrainVoyager_Installer_v21.2_Mac64.pkg”) to start the BrainVoyager installer. The package and the BrainVoyager executable have been signed and should start directly. In case that "Gatekeeper" prevents opening the package (.pkg) file, option-click (or right-click with a two-button mouse) the package icon and click "Open" in the context menu followed by a click on "Open" in the appearing Gatekeeper dialog. If you do not see the BrainVoyager Installer, click the Installer icon in the Dock to show the Installer in front of other windows. Then simply follow the instructions of the package installer (see image sequence on the right).

If you have already a valid software license, you can continue to use BrainVoyager as before after installation and enjoy its new features. If you do not have a license, you will see a licensing screen after starting the software. To activate (unlock) a time-limited trial version, you need to send an email to “licensing [at] brainvoyager [dot] com” containing the displayed “Hardware-ID” and additional information for registration (name, institute/lab, mail address). Such an email is prepared automatically by clicking the “Prepare Email” button in the displayed "License Activation" dialog. Usually within 1-3 days you will receive a license key and a license name/ID (e.g. TSKF307BC88-PETER-SUGAR). After entering the license name and key in the licensing dialog, click the "Activate" button to activate the (trial) license and BrainVoyager is ready to be used for 30 days. More details about the licensing and activation process can be found on the page BrainVoyager Software Licensing.
In order to get the full version of BrainVoyager (after evaluating the trial version), please send an email to “sales [at] brainvoyager [dot] com” to purchase a license. The full version unlocks the program permanently (or for a certain duration) and enables some features that are disabled in the trial version, including scripting and plugins. If you purchase the full version of BrainVoyager, you will get a key that unlocks all licensed features and the software can be used as long as requested in the purchased license. There is also a floating network license available allowing to use a licensed maximum number of computers concurrently from computers in a local (e.g. lab) network. For details send an email to licensing [at] brainvoyager [dot] com.
BrainVoyager will be installed in the "/Applications/BrainVoyager" folder. Scripts and plugins will be installed in the user's “Documents/BVExtenstions/Scripts” and "Documents/BVExtenstions/Plugins" directories.

System requirements
BrainVoyager 21.2 is compatible with macOS 10.13 (High Sierra, recommended) and macOS 10.12 (Sierra). It should also work on macOS 10.11 (El Capitan) but this and earlier versions are not explicitly supported. It is also running well on macOS 10.14 but this version will be explicitly reported with version 21.4.
While many operations of BrainVoyager run with modest working memory demands, a minimum of 4 GB is required and 8+ GB recommended.
OpenGL / OpenCL. BrainVoyager is a graphics-intensive program requiring OpenGL 3.3 or higher for its operation as well as (optionally but highly recommended) OpenCL for acceleration of compute-intensive calculations. Make sure that the latest graphics drivers are installed, which should be the case if the operating system is regularly updated. In case you have multiple graphics cards, make sure that the better performing one is used for BrainVoyager. Some Apple laptops have a lower-performing integrated Intel graphics card, and a high-performance (discrete, stand-alone) graphics card from AMD or NVIDIA. While BrainVoyager runs fine with recent integrated Intel graphics cards, it is advised to use the high-performance graphics card to run BrainVoyager in such constellations, which should be done automatically by macOS. To check this, BrainVoyager reports which graphics card is chosen as well as which version of OpenGL is available in the program's "Log pane". In case the GUI is not starting for some reason, you can also consult the "bv_ogl.txt" file that BrainVoyager stores in the "Documents" folder of the current user.
Note. BrainVoyager supports OpenCL (GP-GPU) acceleration for several compute-intensive operations if supported by your computer system. To benefit from this, OpenCL acceleration must be turned on in the "Settings" dialog. For details how to test its performance and how to enable it, inspect topic "Exploiting the Power of GP-GPUs" in chapter "Additional Documentation" of the User's Guide.
Sample data
If you want to learn basic and advanced features of BrainVoyager, it may be useful to start with example data sets, which are also used in our BrainVoyager training courses. The installers available for download do not contain sample data. To download example data sets, click the "Sample Data Web Page" item in the "Help" menu of BrainVoyager or visit the example data sets page with your Browser. The analysis of the "Objects" data set is described in detail in the BrainVoyager Getting Started Guide.

Python Support
Since version 20, BrainVoyager supports an embedded Python interpreter as a new programming environment for scripting and plugin development. While macOS comes with Python, it uses an older Python version (2.7) and it is thus necessary to install the supported 3.6 version of Python in order to use Python with BrainVoyager 21 (BrainVoyager 20 used the macOS system Python). It is also important that Python is installed in the expected folder ("/Library/Frameworks/Python.framework/Versions/3.6"), which can be ensured by installing the standard version of Python from from the web site. The Python installer python-3.6.5-macosx10.9.pkg can be found on this page (download the file named "macOS 64-bit installer" for macOS 10.9 or later) and can also be directly downloaded from our web site. Start the downloaded .pkg file by double-clicking it in Finder, then follow and accept all options to install Python 3.6.5 at the default location in the "/Library/Frameworks" folder. The installed Python 3.6 and macOS system 2.7 versions will not conflict. Command names for Python 3 contain a 3 in them, e.g. python3 (or python3.6) and pip3 (or pip3.6). Python 2.7 command names contain a 2 or no digit, e.g. python2 (or python2.7 or python).
When starting BrainVoyager after Python 3.6 has been installed, the Python tools (console, developer IDE) will be enabled. If this does not work, please contact our support. Some provided example Python files require basic scientific computing and visualization packages such as numpy and scipy. These packages can be installed from a Terminal window. Since changes are made in system folders, these commands require Administrator privileges which can be obtained temporarily by prefixing the commands by "sudo", which will ask for a Administrator (login) password on first use:

> sudo python3 -m pip install --upgrade pip
> sudo python3 -m pip install numpy
> sudo python3 -m pip install scipy
> sudo python3 -m pip install matplotlib
The first line updates the Python package installer "pip" and the subsequent lines install the numpy, scipy and matplotlib packages. Note that the path to Python36 ("/Library/Frameworks/Python.framework/Versions/3.6/bin") should be in the PATH variable, which should be the case after running the Python installer.

After installing Python 3.6 as described above, BrainVoyager will enable Python automatically. When clicking the Python icon on the right side of the main toolbar, BrainVoyager presents a (docked or floating) interactive python console and a python development window that can be used to load, edit and save Python files. To learn how to use Python in BrainVoyager to script processing routines or to add new functionality, consult the Python Developer Guide that is available from the "Help" menu. You will also find several example Python files in the “Documents/BVExtensions/PythonScripts” and ”Documents/BVExtensions/PythonPlugins" folders that are accessible from the "Files" panel on the left side of the Python development window.
The User's Guide (available locally as well as online) provides basic and advanced information about BrainVoyager and can be easily invoked by clicking the "User's Guide" icon in the main toolbar or by clicking the "User's Guide" item (or "User’s Guide (Web)" item) in the "Help" menu. The BrainVoyager 21.0 User's Guide is also available as an e-book.
Several PDF files introducing various topics are also placed in the "Applications/BrainVoyager" folder after installation, including the Getting Started Guide that is highly recommended for beginners. If you are upgrading BrainVoyager, you may want to check out the "News" section of the User's Guide. We highly recommend to read the release notes (see "Help" menu) to learn about new features, enhancements and bug fixes. Release notes are available for the current as well as previous releases. Documentation is also available on this web page, including the E-book version of the user's guide. If you have any questions, suggestions or bug reports, please send an email to support [at] BrainVoyager [dot] com.

We also recommend to install the Documentation Viewer 1.0 application that can be used to view the User's Guide (which is installed in the "/Applications/BrainVoyager/UsersGuide" folder) without running BrainVoyager; the tool can be used also to view other help files including the Developer Guide or help files from other software including Turbo-BrainVoyager and Brain Tutor. The program registers the ".qhc" compressed HTML format after the first launch enabling to view any ".qhc" help file by using "File Open" or by simply double-clicking it in the Finder.
DocumentationViewer_v10_Mac64.dmg (22.4 MB)