Skip to main content

Output files and folders

This page explains where the Researcher app saves exported CSVs and Excel files.

What you will do​

  • Find the output folder on your computer
  • Understand file names from Export, Analyze, and Excel
  • Know what to share when reporting issues

Steps​

1) Find the base folder​

The app uses a local app folder:

  • macOS and Linux: ~/.datacollection_researcher
  • Windows: %USERPROFILE%\\.datacollection_researcher

2) Find the output folder​

Outputs are written under:

  • output/

So the full path is usually:

  • macOS and Linux: ~/.datacollection_researcher/output
  • Windows: %USERPROFILE%\\.datacollection_researcher\\output

3) Find the participant folder​

Each run writes files into:

  • output/<participantId>/

If participantId is blank, the folder name becomes:

  • output/unknown/

4) Understand file naming​

The app avoids overwriting files. If a file already exists, it creates:

  • name.csv
  • name (2).csv
  • name (3).csv

5) Export outputs (Step 1)​

Export creates one or more CSV files. Typical name pattern:

  • <collectionPath>_export.csv

Note: / and \\ inside a collection path can be replaced with __.

6) Analyze outputs (Step 2)​

Analyze creates:

  • <inputName>_korea_time.csv
  • collection_analysis.csv (coverage report)

7) Excel outputs (Step 3)​

Excel creates:

  • KoreaTime_ResearcherView.xlsx

Common mistakes​

  • Looking in Downloads instead of the app folder
  • Using a blank participantId and not noticing files went to output/unknown/
  • Running Excel before Analyze (no _korea_time.csv files exist)

Report issues​

When you report an issue, include:

  • Your OS version
  • App version (or git commit if running from source)
  • The participantId you used
  • A zip of the participant output folder (remove sensitive data if needed)