Overview
Tonnta supports importing and exporting your episode data in CSV format. This allows you to:
- Backup your data
- Share information with healthcare providers
- Migrate data between devices
- Analyze your data in other tools
Regular CSV Format
The regular CSV format contains episode data with basic tracking information. This is the standard format exported when you use the "Export Episodes" option in Settings.
CSV Columns
| Column | Required | Description | Format | Example |
|---|---|---|---|---|
| Date | Required | The date the episode started | YYYY-MM-DD | 2024-01-15 |
| Start Time | Required | Time when episode began (24-hour format) | HH:mm | 09:30 |
| End Time | Optional | Time when episode ended (leave empty if ongoing) | HH:mm | 10:45 |
| Duration (minutes) | Optional | Total duration in minutes (calculated if End Time provided) | Number | 75 |
| Intensity | Optional | Severity level of the episode | Mild, Moderate, Severe | Moderate |
| Triggers | Optional | Possible triggers that may have contributed | Text (semicolon separated) | "Caffeine; Stress" |
| Medications | Optional | Medications taken during the episode | Text (semicolon separated) | "Metoprolol; Aspirin" |
| Resolutions | Optional | Actions or interventions that helped end the episode | Text (semicolon separated) | "Rest/Sleep; Hydration" |
| Notes | Optional | Additional observations or symptoms | Text (in quotes) | "Chest tightness, irregular heartbeat" |
- Date and Time: All times are in 24-hour format (HH:mm)
- Empty Fields: For ongoing episodes, leave End Time and Duration empty
- Quoting: Fields containing commas must be enclosed in double quotes
- Escaping: Double quotes within fields should be doubled (e.g.,
""Hello"") - Semicolons: Use semicolons to separate multiple values in Triggers, Medications, and Resolutions fields
Sample CSV
Here's a sample CSV file with realistic data:
Date,Start Time,End Time,Duration (minutes),Intensity,Triggers,Medications,Resolutions,Notes
2024-01-15,09:30,10:45,75,Moderate,"Caffeine; Stress","Metoprolol; Aspirin","Rest/Sleep; Hydration","Chest tightness, irregular heartbeat"
2024-01-16,14:20,,,"Severe","Alcohol","","","Palpitations, dizziness"
2024-01-17,08:15,09:00,45,Mild,"Sleep deprivation","","Deep Breathing","Mild fluttering sensation"
2024-01-18,11:30,12:15,45,Moderate,"","Ibuprofen","Rest/Sleep","Better after rest"
2024-01-19,16:45,17:30,45,Severe,"Exercise; Dehydration","","Time/Self-Resolved","Worst episode this week"
2024-01-20,10:00,11:15,75,Mild,"","","Good sleep last night"Extended CSV Format (Timeline)
The app also supports an extended CSV format that includes both episodes and notes in a timeline view. This format includes:
- Type: "Episode" or "Note"
- Category: For notes (e.g., "Symptom", "Observation", "Concern")
- All other fields: Same as regular format for episodes
Importing CSV Data
To import your CSV data:
- Go to Settings in the app
- Tap on Import Data
- Choose your CSV file from your device
- The app will automatically detect the format and preview the data
- Review the preview and tap Import to confirm
Importing CSV data will add to your existing episodes. To start fresh, consider exporting your current data first, then use Settings → Data Management → Delete All Data.
During import, the app automatically creates custom triggers and resolutions for any values that aren't in the built-in list:
- Triggers: If your CSV contains "Cold Shower" (not a built-in trigger), it will be added to your custom triggers
- Resolutions: If your CSV contains "Vagal Maneuvers" (not a built-in resolution), it will be added to your custom resolutions
- Case-Insensitive: "caffeine" matches the built-in "Caffeine" trigger
- Duplicates: Existing custom items won't be duplicated
Built-in items include: Caffeine, Alcohol, Stress/Anxiety, Poor Sleep, Dehydration, Exercise, Large Meal, Skipped Meal, Fatigue, Illness/Fever (triggers) and Rest/Sleep, Hydration, Deep Breathing, and more (resolutions).
Tips for Best Results
- Keep it Consistent: Use the same format for all imports
- Backup First: Always export your data before importing new data
- Use Clear Notes: Write specific, descriptive notes for better pattern recognition
- Track Everything: Even small episodes can reveal important patterns
- Regular Exports: Export your data weekly as a backup
Extended CSV Format (Timeline)
The app also supports an extended CSV format that includes both episodes and notes in a timeline view. This format includes:
- Type: "Episode" or "Note"
- Category: For notes (e.g., "Symptom", "Observation", "Concern")
- All other fields: Same as regular format for episodes
Importing CSV Data
To import your CSV data:
- Go to Settings in the app
- Tap on Import Data
- Choose your CSV file from your device
- The app will automatically detect the format and preview the data
- Review the preview and tap Import to confirm
Warning
Importing CSV data will add to your existing episodes. To start fresh, consider exporting your current data first, then use Settings → Manage Data → Delete All Episodes.
Tips for Best Results
- Keep it Consistent: Use the same format for all imports
- Backup First: Always export your data before importing new data
- Use Clear Notes: Write specific, descriptive notes for better pattern recognition
- Track Everything: Even small episodes can reveal important patterns
- Regular Exports: Export your data weekly as a backup