labvanced logoLabVanced
  • Research
    • Publications
    • Researcher Interviews
    • Use Cases
      • Behavioral Psychology
      • Personality & Social Psychology
      • Cognitive & Neuro Psychology
      • Developmental & Educational Psychology
      • Clinical & Health Psychology
      • Sports & Movement Psychology
      • Marketing & Consumer Psychology
    • Labvanced Blog
  • Technology
    • Feature Overview
    • Desktop App
    • Phone App
    • Precise Timing
    • Experimental Control
    • Eye Tracking
    • Multi User Studies
    • More ...
      • Questionnaires
      • Artificial Intelligence (AI) Integration
      • Mouse Tracking
      • Data Privacy & Security
  • Learn
    • Guide
    • Videos
    • Walkthroughs
    • FAQ
    • Release Notes
    • Documents
    • Classroom
  • Experiments
    • Public Experiment Library
    • Labvanced Sample Studies
  • Pricing
    • Pricing Overview
    • License Configurator
    • Single License
    • Research Group
    • Departments & Consortia
  • About
    • About Us
    • Contact
    • Downloads
    • Careers
    • Impressum
    • Disclaimer
    • Privacy & Security
    • Terms & Conditions
  • Appgo to app icon
  • Logingo to app icon
Learn
Guide
Videos
Walkthroughs
FAQ
Release Notes
Classroom
  • 中國人
  • Deutsch
  • Français
  • Español
  • English
Guide
Videos
Walkthroughs
FAQ
Release Notes
Classroom
  • 中國人
  • Deutsch
  • Français
  • Español
  • English
  • Guide
    • GETTING STARTED

      • Objects
      • Events
      • Variables
      • Task Wizard
      • Trial System
      • Study Design
        • Tasks
        • Blocks
        • Sessions
        • Groups
    • FEATURED TOPICS

      • Randomization & Balance
      • Eye Tracking
      • Desktop App
      • Sample Studies
      • Participant Recruitment
      • API Access
        • REST API
        • Webhook API
        • WebSocket API
      • Other Topics

        • Precise Stimulus Timings
        • Multi User Studies
        • Head Tracking in Labvanced | Guide
    • MAIN APP TABS

      • Overview: Main Tabs
      • Dashboard
      • My Studies
      • Shared Studies
      • My Files
      • Experiment Library
      • My Account
      • My License
    • STUDY TABS

      • Overview: Study-Specific Tabs
      • Study Design
        • Tasks
        • Blocks
        • Sessions
        • Groups
      • Task Editor
        • Main Functions and Settings
        • The Trial System
        • Canvas and Page Frames
        • Objects
        • Object Property Tables
        • Variables
        • System Variables Tables
        • The Event System
        • Trial Randomization
        • Text Editor Functions
        • Eyetracking in a Task
        • Head Tracking in a Task
        • Multi-User Studies
      • Study Settings
        • Start Up and Main Settings
        • Browsers & Devices Settings
        • Experiment Features Settings
      • Description
        • More Details about Description Information
        • Images, Links, and References in Descriptions
      • Variables
      • Media
      • Translate
      • Run
      • Publish and Record
        • Requirements for Publishing a Study in Labvanced
        • Recruiting Participants and Crowdsourcing
        • License Selection and Confirmation
        • After Publishing Your Labvanced Study
      • Sharing
      • Participants
      • Dataview and Export
        • Dataview and Variable & Task Selection (OLD Version)
        • Accessing Recordings (OLD Version)
  • Videos
    • Video Overview
    • Getting Started in Labvanced
    • Creating Tasks
    • Element Videos
    • Events & Variables
    • Advanced Topics
  • Walkthroughs
    • Introduction
    • Stroop Task
    • Lexical Decision Task
    • Posner Gaze Cueing Task
    • Change Blindness Flicker Paradigm
    • Eye-tracking Sample Study
    • Infant Eye-tracking Study
    • Attentional Capture Study with Mouse Tracking
    • Rapid Serial Visual Presentation
    • ChatGPT Study
    • Eye Tracking Demo: SVGs as AOIs
    • Multi-User Demo: Show Subjects' Cursors
    • Gamepad / Joystick Controller- Basic Set Up
    • Desktop App Study with EEG Integration
  • FAQ
    • Features
    • Security & Data Privacy
    • Licensing
    • Precision of Labvanced
    • Programmatic Use & API
    • Using Labvanced Offline
    • Troubleshooting
    • Study Creation Questions
  • Release Notes
  • Classroom

Desktop App Guide

Contents:

  1. Overview
  2. Installation Process
  3. App Walkthrough
  4. LSL Integration: Connecting External Devices like EEG

Overview

With the desktop app, you can sync your studies locally to your lab’s computer. This allows you to focus on data collection while being in an offline mode, as well as integrate external devices like EEGs, all with a single app. For more information, refer to the desktop app technology page.

Note: Please note that the desktop app is available only for group license and departmental license holders.

Installation Process

Below is an overview of the installation process.

Operating Systems Compatible with the Labvanced Desktop App

The desktop app is compatible with the following operating systems:

  • Windows
  • MacOS
  • Linux Ubuntu

Download and Installation Process

  1. By accessing the following page, you can select which option you want to download to your local computer: https://www.labvanced.com/page/desktop
  2. When downloading is complete, extract the .zip folder
  3. Scroll through the files and double click on the Labvanced executable (ie. the Labvanced.exe file)
  4. After a few seconds, you can select the directory or location of where you want the app files to be saved
  5. Click ‘Install’
  6. It will take about 10-20 seconds to install
  7. Upon completion, you will be asked whether you want to download FFmpeg license

Note: The FFmpeg license is free and allows you to support media files like audio or video files in your experiments, so it’s important. Without it, media files won’t be able to be used.

  1. This will take a few more seconds to download
  2. At this point, in the dialogue box you can then: a.) create a shortcut to have on your desktop and b.) select to launch the app as soon as it finished downloading

Special Note: Downloading the Desktop App for MacOS

Under the ‘System Settings’ in the ‘Privacy & Security’ menu, the option for allowing applications downloaded from ‘Anywhere’ is hidden for the latest MacOS versions. So before proceeding with downloading the desktop app, this needs to be selected.

Default view of MacOS Privacy & Security does not allow for apps downloaded from ‘Anywhere’.
Default view does not allow for apps downloaded from ‘Anywhere’.

  1. To make this option visible in order to select it:
  2. Go to the search bar to search through your applications
  3. Find and open the ‘Terminal’ application (which is a part of all computers)
  4. Paste this command into the terminal sudo spctl --master-disable and press the Return or enter key
  5. Your computer will ask for your password as a confirmation
  6. Return to the ‘Privacy & Security’ menu and select ‘Anywhere’
  7. Now, you can return to the installation process described above and continue with installing the desktop app

Upon running the terminal command, the ‘Anywhere’ option is now available in the MacOS Privacy Settings.
Upon running the terminal command, the ‘Anywhere’ option is now available.

App Walkthrough

Main View

Upon launching and opening the desktop app, the login screen will show. You can sign in using your username and password. If there is an update, you can accept it if you want.

The studies will load just like in the browser version. In general, there are similarities to what you see when you open labvanced.com but there are a few differences. For instance, there is no Dashboard view and there are no navigation tabs at the top or bottom. But otherwise, this is used just like the browser version when creating and editing studies. For instance you can create a new study, and start editing right within the application.

View of the desktop app in the Online mode [top left toggle].
View of the desktop app in the Online mode [top left toggle].

Local – Online Modes

One big difference is this top toggle here between ‘local’ and ‘online’ modes. When you toggle to ‘local’ only the studies that are locally available to your computer will appear.

Making a Study Locally Available

To make a study locally available you simply select the study and then click the ‘Access Locally’ button from the left side menu. This will download the study to your computer and from this point forward you can use it without internet access and just use it completely locally in your lab.

To access a study locally, select the study and then click this button.
To access a study locally, select the study and then click this button.

In this ‘local’ or ‘offline’ view, you will now see the study. While this is similar to the other online mode, it is a much more focused and clean-cut view of the studies available and dedicated for recording data.

Sync Settings

Using the ‘Sync Settings’ options, you can specify how you want your experiment to be (or not be) updated once an internet connection is re-established upon toggling back to the ‘online’ mode. For example, you may want your study to be updated automatically if any changes were made or for data to be sent to the servers.

The sync settings appear when clicking the cloud icon.
The sync settings appear when clicking the cloud icon.

The table below explains these setting options in detail:

Sync Setting OptionDescription
Auto-downloadUpdates study design. Upon re-establishing an internet connection, any changes that were made to the experiment design will be automatically reflected in the local version. This is helpful so you don’t have to remember every time to sync it yourself.
Auto-uploadUploads participant data, backing up to the servers. Any data recorded locally will be uploaded to the Labvanced server. So if this isn’t selected in any way, then you will have the data locally and export it as you wish.
Two-ways syncBoth experiment and data are updated. The experiment design will sync automatically, if any changes were made, and also the data recordings will be sent to the servers.
No auto-syncKeeps the study entirely local. The experiment won’t be updated if any changes were made while being online and data recordings will not be sent to the servers.

Thus, you can decide using these setting options how you want your study to behave, whether it is synced and updated and in what direction, or whether you prefer to keep it entirely local.

Run Study

Upon selecting a study in the local mode, you can click the ‘Open’ option from the side menu.

Select a study and click this ‘Open’ button to access the study locally.
Select a study and click this ‘Open’ button to access the study locally.

From here, you can then proceed to do a test run or a recording session locally.

Options to do a test run or start a recording session locally.
Options to do a test run or start a recording session locally.

LSL Integration: Connecting External Devices

The Lab Streaming Layer (LSL) is used to connect external devices with Labvanced. LSL is used to establish a connection with commonly used lab equipment in order to record data using:

  • EEG systems
  • Eye trackers
  • Motion sensors
  • Wearables
  • and many more devices

Detailed walkthrough: For a detailed walkthrough and example of how to set up a study with an EEG connection, from beginning to end, see this page.

The image below is from a data recording session from an EEG study that was created and set up in Labvanced:

Preview of an EEG study done using the Labvanced desktop app. The event markers are listed vertically at the top in pink and green.
Preview of an EEG study done using the Labvanced desktop app. The event markers are listed vertically at the top in pink and green.

These are the two common scenarios for establishing a connection between Labvnanced and your external device(s):

Scenario 1Scenario 2
Connect your external devices via the Labvanced ‘Study Settings’ and the desktop app. For older devices (like EEGs with serial ports) or custom protocols, you may need to consider Scenario 2.If the default settings are not enough for you or you need to follow another protocol, then you can utilize a Websocket API to establish an LSL connection between your device(s) and Labvanced. See our Websocket API documentation for more information.
Prev
Eye Tracking
Next
Sample Studies