RecallR Backup File Format

Overview

RecallR backup files are stored in CSV (Comma-Separated Values) format, making them easily readable and compatible with spreadsheet applications. Each backup file contains a complete snapshot of your folders and their contents.

File Structure

Header Row

The first line of the file contains the column headers:

id,title,url,contentType,folderId,dateAdded,notes,thumbnailURL,isDescriptionEdited,folderName,categoryIds,isNoteCompleted,completionDate

Data Rows

Each subsequent row represents one item in your folders, with the following fields:

1. id - Unique identifier for the item (UUID format)
2. title - Item title or description
3. url - Full URL of the item
4. contentType - Type of content (e.g., text, url, pdf, image)
5. folderId - Unique identifier of the containing folder (UUID format)
6. dateAdded - Creation date in ISO 8601 format
7. notes - Any notes associated with the item
8. thumbnailURL - URL of the item's thumbnail (if available)
9. isDescriptionEdited - Whether the description has been manually edited (true/false)
10. folderName - Name of the containing folder
11. categoryIds - Comma-separated list of category UUIDs (if folder belongs to categories)
12. isNoteCompleted - Whether the note is marked as completed (true/false)
13. completionDate - Date when the note was marked as completed, in ISO 8601 format (optional)

Categories Section

The backup file includes a special section for categories after the items data:

#CATEGORIES#
id,name,colorHex,iconName,folderIds

Each category row contains:

1. id - Unique identifier for the category (UUID format)
2. name - Category name
3. colorHex - Color in hexadecimal format
4. iconName - SF Symbol name for the category icon
5. folderIds - Comma-separated list of folder UUIDs in this category

Field Formatting

• Text fields containing commas or quotes are properly escaped:
  • Fields are enclosed in double quotes
  • Internal double quotes are doubled ("" instead of ")
• Dates are in ISO 8601 format (e.g., 2024-01-10T15:30:45Z)
• Boolean values are represented as "true" or "false"
• Empty fields are preserved but contain no data

Example

id,title,url,contentType,folderId,dateAdded,notes,thumbnailURL,isDescriptionEdited,folderName,categoryIds,isNoteCompleted,completionDate
"550e8400-e29b-41d4-a716-446655440000","My First Note","http://example.com","public.text","a123b456-c789-4def-a123-456789abcdef","2024-01-10T12:30:45Z","Some notes about this item","","false","Important Tasks","","false",""

Usage

• The backup file can be used to restore your data in case of data loss
• You can view the contents in any spreadsheet application
• The format allows for easy data migration and analysis
• Each backup contains all necessary information to fully reconstruct your folders and items

Important Notes

• Do not modify the backup file manually unless you understand the format
• Always keep multiple backups in different locations
• The backup includes all folder structures and relationships
• Thumbnails are stored as URLs and may need internet access to restore
• All dates are in UTC timezone for consistency