Downloading Data with the CLI – Flywheel.io

Introduction

Sessions, acquisitions, and files can be downloaded using the download command in the Flywheel CLI.

Tip: Additional download options:

Usage

fw download [source path to files in Flywheel] [optional flags]

Example

Here's the an example of how to download a particular subject.

Download the Flywheel CLI, and sign in using your API key. Once you are signed in, you should get the following message:

C02W39YBHTD6:~ AvaAnderson$ fw login staging2.dev.flywheel.io:Ja0ib***********pf
You are now logged in as Ava Anderson!

Now you can navigate to the files you wish to download. In this example, we're navigating to the subjects in the AnxietyStudy project:
```
C02W39YBHTD6:~ AvaAnderson$ fw ls Psychology/AnxietyStudy
admin s13
admin s3
admin s5
admin s11
admin s14
admin s15
admin s12
admin Dec5 17:49files/license.txt 
```
Tip - If a project or subject's name includes spaces, use quotes around the name. For example: Psychology/"An example study"

To download one of those subjects:

C02W39YBHTD6:~ AvaAnderson$ fw download Psychology/AnxietyStudy/s3

This download will be about 218 MB comprising 39 files.

Continue? (yes/no): yes
Wrote 218 MB to s3.tar

Reference

Required Flags

Required Argument	Description
source-path	The location of the file on your Flywheel instance. For example [fw://group/project/subject/acquisition/attachments]

Optional Flags

Optional Flag	Description
-e, --exclude file type	Download everything but these file types. Learn more about file types in Flywheel.
-f, --force	Force download, without prompting
-h, --help	Displays help for download
-i --include file type	Download only these file types. Learn more about file types in Flywheel.
-o --output file name	Name of the folder where the data is downloaded.
-p PREFIX, --prefix PREFIX	Prefix for downloaded directory structure
-i INCLUDE, --include INCLUDE	Download only these file types. For example dicom or nifti
-e EXCLUDE, --exclude EXCLUDE	Download everything but these file types. For example dicom or nifti

{[{category.name}]}