Skip to content

NeuroDesk/neurodesk-app

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Neurodesk App

Neurodesk App is the cross-platform desktop application for Neurodesk. It is the quickest and easiest way to get started with Neurodesk on your personal computer, with the flexibility for advanced use cases.

Neurodesk App

Installing Docker

Neurodesk App requires Docker to be installed on your computer. If you already have Docker installed, you can skip this step.

After installation, open a terminal (Linux/macOS) or command prompt (Windows) and run the following command to verify that Docker is working correctly: docker --version

Installing Neurodesk App

If you have an existing Neurodesk App installation, please uninstall it first by following the uninstall instructions.

⚠️ On Microsoft edge, follow these steps to download the executable file: Microsoft Edge

Launching Neurodesk App

Neurodesk App can be launched from the GUI of your operating system by clicking the application's icon or by using neurodeskapp command from the command line.

Neurodesk App sets File Browser's root directory based on the launch method.

  • If launched from the application icon on GUI or by using neurodeskapp command without any arguments, then the default working directory is set as the root directory. The default working directory is user home directory but it can be customized from the Settings dialog.

  • If neurodeskapp command is used with a directory path as the argument or with the --working-dir argument the directory in the argument is set as the root directory.

Sessions and Projects

Sessions represent local project launches and connections to existing Neurodesk servers. Each Neurodesk UI window in the app is associated with a separate session and sessions can be restored with the same configuration later on.

Each launch of Neurodesk in a different working directory is a separate project and projects can have their own configuration such as Python environment and UI layout.

Session start options

You can start a new session by using the links at the Start section of the Welcome Page.

Start session

  • Open Local Neurodesk.. creates a new session in the default working directory.
  • Connect... creates a session by connecting to a remote Neurodesk server.

Previously opened sessions are stored as part of application data and they are listed on Welcome Page. Clicking an item in the Recent sessions list restores the selected session.

Start session

Add Custom Data Directory

Neurodesk App stores its data in the following locations:

  • By default, /home/jovyan/neurodesktop-storage in the app (which is binded with local directory ~/neurodesktop-storage in Unix or C:/neurodesktop-storage in Windows)

  • By choice, in the setting window below, select Additional Directory on the left side bar, click Change button to select the local directory, then click Apply & restart. The next time you start the app, the data from the local directory can be found in /home/jovyan/data.

Add data

See user guide for configuration options

See troubleshooting guide for troubleshooting issues

For contributing, see developer documentation

About

Neurodesktop application, based on Electron.

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Languages

  • TypeScript 86.6%
  • JavaScript 6.0%
  • NSIS 3.0%
  • HTML 2.7%
  • Python 0.9%
  • Shell 0.8%