Import & Export Features

Roc Solution supports importing and exporting tabs in a simple text format. This allows you to backup your tabs, share them with others, and transfer between devices.

Understanding the File Format

Tab File Structure

Tabs are stored as plain text (.txt) files with this format:

Song Title / Lyrics
E|--------------------------------------------------|
B|--------------------------------------------------|
G|--------------------------------------------------|
D|--------------------------------------------------|
A|--------------------------------------------------|
E|--------------------------------------------------|

Format Details

• First line: Song title or description
• Next 6 lines: One per string (E high to E low)
• Pipe (|): Separator at end of each string
• Numbers: Fret numbers (0-13)
• Dashes (-): Timing/spacing between notes
• Vertical alignment: Chords (same column = played together)

Example Tab File

A Major Chord
E|--0--|
B|--2--|
G|--2--|
D|--2--|
A|--0--|
E|-----|

Exporting Tabs

Export Single Tab

1. Click Load button in Tab Display2. Expand the folder containing your tab3. Hover over the tab4. Click the download icon (down arrow)5. .txt file downloads to your computer

File Name: Tab name + ".txt"

Export Entire Folder

1. Click Load button2. Find the folder you want to export3. Hover over folder name4. Click the download icon next to folder5. All tabs in folder export as single file

File Format: Multiple tabs separated by blank lines

Export All Folders

1. Click Load button2. Click Download All button at top3. Complete backup of all folders and tabs4. Single file with everything

Use Case: Complete backup before clearing browser data

Importing Tabs

Step 1: Prepare Your File

Your .txt file should follow the format:

• First line: Title
• Next 6 lines: String notation
• Multiple tabs separated by blank lines (for multi-tab import)

Step 2: Open Import Dialog

1. Click Import button in Tab Display2. Import dialog opens

Step 3: Select File

1. Click Choose .txt file button2. Browse and select your .txt file3. File name appears in dialog4. Preview shows: "X tab(s) will be imported"

Step 4: Select Destination Folder

Option A: Existing Folder

• Select folder from dropdown
• Tabs import into that folder

Option B: Create New Folder

• Select "+ Create New Folder..."
• Enter folder name
• Click Create
• New folder selected automatically

Step 5: Confirm Import

1. Review preview information2. Check tab count3. Click Import button4. Success message appears5. Tabs now in selected folder

Import Scenarios

Importing Single Tab

File Content:

My Song
E|--0--2--3--|
B|--2--3--5--|
G|--2--2--0--|
D|--2--0-----|
A|--0--------|
E|-----------|

Result: One tab imported with title "My Song"

Importing Multiple Tabs

File Content:

Song 1
E|--0--|
B|--2--|
G|--2--|
D|--2--|
A|--0--|
E|-----|

Song 2
E|--2--|
B|--3--|
G|--2--|
D|--0--|
A|-----|
E|-----|

Result: Two tabs imported: "Song 1" and "Song 2"

Importing Example Chords

Roc Solution includes example chord files:

• Location: public/example-chords.json
• Contains: A, D, G major chords and progression
• Format: JSON (needs conversion or use import HTML)

File Format Best Practices

Valid Tab Format

✅ Correct:

Song Title
E|--0--2--|
B|--2--3--|
G|--2--2--|
D|--2--0--|
A|--0-----|
E|--------|

Common Mistakes

❌ Missing title line❌ Wrong number of strings (must be exactly 6)❌ Missing pipe (|) at end❌ Invalid fret numbers (must be 0-13)❌ Incorrect string order (E high to E low)

Sharing Tabs

Method 1: Export and Share File

1. Export tab as .txt file2. Share file via:

• Email attachment
• Cloud storage (Google Drive, Dropbox)
• Messaging apps
• Social media

3. Recipient imports file

Method 2: Copy-Paste Text

1. Open exported .txt file2. Copy all content3. Share text (email, message, etc.)4. Recipient creates .txt file5. Paste content and import

Method 3: Online Sharing

1. Upload .txt to:

• GitHub Gist
• Pastebin
• Google Docs

2. Share link3. Recipient downloads and imports

Backup Strategy

Regular Backups

1. Weekly: Export important folders2. Monthly: Export all folders ("Download All")3. Before Major Changes: Backup before clearing data4. After Important Recordings: Export immediately

Backup Storage

• Local: Save to Documents folder
• Cloud: Upload to Google Drive, Dropbox, iCloud
• Multiple Locations: Don't rely on single backup
• Version Control: Date your backup files

Restoring from Backup

1. Import .txt file2. Select destination folder3. Tabs restore with all data4. Verify imported tabs

Advanced Import/Export

Bulk Operations

Export Multiple Folders:

• Export each folder individually, OR
• Use "Download All" for complete backup

Import Multiple Files:

• Import each file separately
• Each import can go to different folder
• System handles multiple imports

File Conversion

From Other Formats:

• Convert to Roc Solution format manually
• Follow the 6-string, pipe-separated format
• Ensure valid fret numbers (0-13)

To Other Formats:

• Export as .txt
• Convert using text processing tools
• Maintain format structure

Troubleshooting

Q: Import failed?A: Check file format. Ensure exactly 6 strings, valid fret numbers, and proper structure.

Q: Tabs not importing correctly?A: Verify string order (E high to E low) and that each line ends with pipe (|).

Q: Can't export?A: Make sure you have tabs saved. Export works from Load dialog, not current tab.

Q: File too large?A: Browser may limit file size. Try exporting folders separately instead of "Download All".

Q: Imported tabs missing notes?A: Check original file format. Ensure fret numbers are valid (0-13) and properly formatted.

Best Practices

1. Regular Exports: Backup important tabs frequently2. Clear Naming: Use descriptive file names3. Test Imports: Verify imports work before deleting originals4. Format Validation: Check file format before importing5. Multiple Backups: Don't rely on single backup location

Next Steps

Combine Import/Export with other features:

• Recording: Record → Export → Share
• Saving: Save → Export → Backup
• Learning: Import → Learn Mode → Progress
• Collaboration: Share tabs with other users

Import and Export make Roc Solution a collaborative and portable tool. Use them to build your tab library and share with the community!