How to Create Timestamps

[Natraj Bontha (marketscapes)]

Thank you for helping create verse-by-verse audio timestamps for all 18 chapters of the Bhagavad Gita! This guide will walk you through the process.

What You're Doing

You'll be listening to audio recordings of Bhagavad Gita chapters and marking the exact start and end times for each verse. This allows users to:

• Play individual verses on demand
• Navigate verse-by-verse through the audio
• Have a synchronized audio and text experience

Requirements

• TestFlight build of the app (the timestamp editor is only visible in TestFlight/debug builds)
• Headphones recommended for better accuracy
• 20-30 minutes per chapter (varies by chapter length)

Getting Started1. Access the Timestamp Editor

1. Open the app and navigate to Bhagavad Gita
2. Select any chapter (1-18)
3. Scroll to any verse
4. You'll see an orange debug panel below each verse (only in TestFlight builds)

2. Understanding the Debug Panel

The debug panel shows:

• Start time: When the verse begins
• End time: When the verse ends
• Duration: How long the verse lasts
• Sliders: Drag to adjust start/end times
• +/- buttons: Fine-tune by 1s or 5s increments
• Play button (blue): Listen to your selected segment
• Save button (green): Save the timestamp
• Auto-chain switch: Auto-fill next verse based on current verse

3. Chapter Header Controls

At the top of the screen (in the app bar), you'll see:

• Save icon (orange): Auto-saves all timestamps to Firebase
• Toggle icon (green/gray): Show/hide debug panels for all verses

How to Create TimestampsMethod 1: Manual (Most Accurate)

1. Play the full chapter audio using the chapter play button
2. Note when each verse starts and ends
3. For each verse:
   • Drag the Start slider to where the verse begins
   • Drag the End slider to where the verse ends
   • Click the blue Play button to verify
   • Adjust as needed using +/- buttons for precision
   • Click the green Save button when satisfied

Method 2: Auto-Chain (Faster for Sequential Work)

This is the recommended method for efficiency:

1. Turn ON the Auto-chain switch (toggle at bottom of debug panel)
2. Start with verse 1:
   • Set the start time to 00:00.00
   • Find where verse 1 ends (listen carefully for the pause before verse 2)
   • Set the end time
   • Click Save
3. Move to verse 2:
   • The start time will automatically be set to verse 1's end + 0.5 seconds
   • The end time will default to +16 seconds (you'll adjust this)
   • Find where verse 2 actually ends
   • Adjust the End slider only
   • Click Save
4. Repeat for all remaining verses

Auto-chain Benefits:

• Saves time - you only need to adjust the end time for each verse
• Ensures no gaps between verses
• Maintains consistency

Note: Auto-chain only updates verses that haven't been verified yet. Once a verse has been saved, it won't be overwritten by auto-chain.

Verification System

The app tracks how many times each verse has been verified:

• No checkmark: Verse not yet saved/verified
• Orange checkmark ✓: Verse saved 2 times (needs one more verification)
• Green checkmark ✓: Verse saved 3+ times (fully verified!)

Once a verse has 3 verifications, the debug panel will automatically hide for that verse (to reduce clutter). You can still show it using the toggle button in the chapter header if needed.

Tips for AccuracyListen Carefully

• Use headphones for better audio clarity
• Listen for natural pauses between verses
• Some verses flow together - listen for the speaker saying the verse number or a distinct pause

Speaker Identification

Each verse shows the speaker (Krishna, Arjuna, Sanjaya, etc.) with a colored badge. This helps you identify verse boundaries:

• Different speakers usually have clear transitions
• Same speaker may have subtle pauses between verses

Fine-Tuning

• Use the +1s / -1s buttons for precise adjustments
• The sliders are good for rough positioning
• Always play the segment before saving to verify accuracy
• Aim for minimal silence at the start and end of each verse

Common Timing Guidelines

• Start time: Should begin just as the verse recitation starts (not during the pause)
• End time: Should end just after the verse finishes (before the next pause)
• Gap between verses: Auto-chain adds 500ms gap automatically
• Average verse duration: 10-20 seconds (varies widely)