The compiled version of EEGLAB

EEGLAB exists as a compiled binary for Mac, Windows, and Ubuntu and may be downloaded on the EEGLAB download page. The video below shows how to install the compiled version of EEGLAB.

Installation

Below are the instructions to install the MAC version. The Windows version follows the same procedure (although it is somewhat less complex towards the end, which is why we focus on the MAC version). Uncompress the archive and run the installer.

• Download the ZIP file for the EEGLAB compiled version on the download page and uncompress it
• Uncompress the zip file and run the installation file.
• If, for some reason, the installation process fails, you may need to run it as an administrator

The following screen will pop up.

Simply press next. Press next as well on the next three screens. Do not change the default paths.

MAC only. When the installation is completed, the following message shows up. YOU CAN IGNORE THE MESSAGE

Instead, go to the installed EEGLAB version and select the file eeglab_run_this_one_on_osx_or_linux or eeglab_run_this_one_on_windows as shown below. Do not click on EEGLAB because you will either not have the command prompt (on Windows) or EEGLAB will not start (on MAC) unless you set the path above (the part we mention you should ignore). Setting the path is possible, but it is not straightforward. Alternatively, on MAC, use the command “./run_EEGLAB.sh /Applications/MATLAB/MATLAB_Runtime/R2022b/” (the MATLAB runtime version must match the one used to compile EEGLAB and should be automatically installed with EEGLAB; if not it can be found here).

It should take about 1 minute for EEGLAB to start.

Troubleshooting

On both MAC and Windows, you might need to run EEGLAB as an administrator to be able to access some folders.

On MAC OSX, you might get a message that your operating system is too old, so you should try an older version of the compiled EEGLAB version.

Let us know if you encounter problems and how you solve them. See also below how

Similarity between the compiled and the MATLAB version of EEGLAB

• Both version graphical interface are identical
• There is nothing in the EEGLAB graphic interface that you can do under MATLAB that is not possible to do in the compiled version of EEGLAB. This includes using all the plugins and all the external modules attached to EEGLAB, saving scripts, and running MATLAB scripts.

What is not possible to do using the compiled version

• It is not possible to add new plugins or download and install third-party plugins. To do so, EEGLAB needs to be recompiled with the additional plugins.
• When using scripts, it is not possible to use external custom MATLAB functions or to define new functions
• When using scripts, the range of possible MATLAB commands is limited to the MATLAB core commands, all EEGLAB commands and a few commands from the signal processing, the statistics and the optimization toolbox (commands which are included in the compiled code).
• It is not possible to modify EEGLAB source code.

Frequently asked questions

• Can I run some of my MATLAB scripts on the EEGLAB compiled version? Yes, as long as they use standard MATLAB functions or EEGLAB functions.

• Is the compiled code faster than the non compiled one? No, it is the same speed as the MATLAB runtime engine still interprets it.
• Is it legal since I do not own MATLAB? Yes, it is perfectly legal. Although it is illegal to run a pirated version of MATLAB, it is perfectly legal to distribute the MATLAB Runtime Engine and compiled MATLAB code.
• Can I use this program for commercial applications such as my private clinical practice? EEGLAB is a research software package, not a clinical software package. The program is provided as-is with no warranty of any kind. Although the EEGLAB core code is released under a BSD 2.0 license that allows for commercial use, some of the plugins included in the compiled version are not (this includes plugins handling source reconstruction, for example).
• Trouble shooting! Do not hesitate to submit bug reports on the EEGLAB GitHub issue tracker if you encounter a problem running a compiled version of EEGLAB.

How to check the integrity of the compiled version

Differences between the MATLAB and the compiled EEGLAB version mostly arise because of the way external data files are handled. This is how we check the compiled version’s integrity (since it is not possible to automate this process yet). You may run the script test_compiled_version.m in the folder functions/support_files (you might have to change the path to the data files). For testing, we use the STERN STUDY (0.9 Gb). Please download the data on your computer.

1. Start EEGLAB
2. Edit options and change them; go back to option and make sure they have changed
3. Load the continuous tutorial dataset “eeglab_data.set”. Look up electrodes, run clean raw data, Run ICA, run IClabel
4. Perform source localization of ICA components using Dipfit
5. Plot 3-D ERP after coregistering
6. Load Stern study, precompute ERPs and plot them. Try using statistics.
7. Check that the help menus are functional

If all of the above checks, then the compiled EEGLAB version is considered verified. We check the version separately on Windows and Unix/MacOS.

Can I compile EEGLAB myself?

Compiling EEGLAB usually consists of opening the “eeglab.prj” file (in the root EEGLAB folder) using the MATLAB Compiler Graphical App, and pressing the package button. However, there might be some path issues that require fixing on your system. See detailed instructions below.

Manual compilation notes

1. Clone EEGLAB with default plugins

git clone --recurse-submodules https://github.com/sccn/eeglab.git

1. Install additional plugins (already installed plugins will be skipped). Some folders from the plugins clean_rawdata and Fieldtrip should be removed to avoid compilation issues. Do not use the GIT version of Fieldtrip. as it makes the release 1.5Gb instead of 200Mb. Instead get the latest plugin. Use the following script to install plugins and remove these folders:

eeglab  % restart the fleshly installed eeglab

% Installing plugins
plugin_askinstall('ANTeepimport', 'eegplugin_eepimport', true);
plugin_askinstall('Fieldtrip-lite', 'ft_defaults', true);
plugin_askinstall('Fileio', 'ft_read_data', true);
plugin_askinstall('IClabel', 'eegplugin_iclabel', true);
plugin_askinstall('PICARD', 'picard', true);
plugin_askinstall('vised', 'vised', true);
plugin_askinstall('bids-matlab-tools', 'bids_export', true);
plugin_askinstall('bids-validator', 'pop_validatebids', true);
plugin_askinstall('bva-io', 'eegplugin_bva_io', true);
plugin_askinstall('clean_rawdata', 'eegplugin_clean_rawdata', true);
plugin_askinstall('dipfit', 'eegplugin_dipfit', true);
plugin_askinstall('egilegacy', 'eegplugin_egilegacy', true);
plugin_askinstall('firfilt', 'eegplugin_firfilt', true);
plugin_askinstall('iirfilt', 'eegplugin_iirfilt', true);
plugin_askinstall('musedirect', 'eegplugin_musedirect', true);
plugin_askinstall('musemonitor', 'eegplugin_musemonitor', true);
plugin_askinstall('neuroscanio', 'eegplugin_neuroscanio', true);
plugin_askinstall('xdfimport', 'eegplugin_xdfimport', true);
plugin_askinstall('mffmatlabio', 'pop_mffimport', true);
plugin_askinstall('scd', 'eegplugin_scd', true);
plugin_askinstall('snapmaster', 'eegplugin_snapmaster', true);

% Removing clean_rawdata files
% For clean_rawdata, remove folder manopt/reference/m2html.
CleanRawData_folder = fileparts(which('clean_rawdata.m'));
rmdir(fullfile(CleanRawData_folder,'manopt','reference','m2html'), 's');
rmdir(fullfile(CleanRawData_folder,'manopt','tests'), 's');

% Removing ICLabel files
iclabel_folder = fileparts(which('iclabel.m'));
% rmdir(fullfile(iclabel_folder,'matconvnet','examples'), 's'); % not there any more?

% Removing FieldTrip files
% For Fieldtrip remove folders compat, external/afni, external/spm8, external/spm12, external/gifti, external/eeglab, external/bemcp and external/npmk
FieldTrip_folder = fileparts(which('ft_defaults.m'));
rmdir(fullfile(FieldTrip_folder,'compat'), 's');
rmdir(fullfile(FieldTrip_folder,'test'), 's');
rmdir(fullfile(FieldTrip_folder,'external','afni'), 's');
rmdir(fullfile(FieldTrip_folder,'external','spm8'), 's');
rmdir(fullfile(FieldTrip_folder,'external','spm12'), 's');
rmdir(fullfile(FieldTrip_folder,'external','gifti'), 's');
rmdir(fullfile(FieldTrip_folder,'external','eeglab'), 's');
rmdir(fullfile(FieldTrip_folder,'external','bemcp'), 's');
rmdir(fullfile(FieldTrip_folder,'external','npmk'), 's');
rmdir(fullfile(FieldTrip_folder,'external','signal'), 's');
rmdir(fullfile(FieldTrip_folder,'external','mffmatlabio'), 's');
rmdir(fullfile(FieldTrip_folder,'external','egi_mff_v2'), 's');

1. Optional: Edit the eeglab.m file and add new plugins to the compiled version of EEGLAB (line 900). Change the version of EEGLAB in the prj file.

2. Open the “eeglab.prj” file in the Matlab editor. Check the path for plugins. If a new version is available, rename the version in the eeglab.prj file.

3. Change the EEGLAB version in the eeg_getversion.m and in the eeglab.prj files.

4. Open the Application compiler (Matlab tab “Apps” and button “Application compiler”) and open the “eeglab.prj” file. DO NOT RESAVE THE PROJECT IN THE APPLICATION COMPILER AS IT TENDS TO MESS UP PATHS FOR CROSS PLATFORM COMPILATION.

5. If there are class errors (and there usuly are), use the command below. There will still be class errors when checking dependencies, but the EEGLAB will compile anyway. On the command line, type

setenv('MCC_USE_DEPFUN','1')

1. If not using 2022b to compile, edit the file run_this_one_on_osx_and_linux and change the version number

2. Press “Package” and wait (usually 30 minutes or so)

3. If successful, 3 folders are created. You may test the compiled EEGLAB version by running the program in the “for_testing” folder.

4. Test the compiled version for potential runtime errors (see notes on testing here). On Mac and OSX use ./run_eeglab.sh MATLAB_PATH.

Known problem: check documentation in compiled version

Known error: mex files not included for ANT plugin (ASR test file present)

Plugins selected for future inclusion

Selected for future inclusion but requires testing. If you have a plugin you want to include, please try compiling with the plugin and testing the plugin in the compiled EEGLAB version. If all is functional, email us at eeglab_at_sccn.ucsd.edu, and your plugin will be included in the next release.

Adding new plugins

• Download or clone plugin
• Add to eeglab.m
• Compile
• Update this page (create a pull request)