Skip to main content

​
Overview

The Batches tab shows all your Spotify podcast show batch operations with real-time progress tracking.

​
Batch Table

ColumnDescription
Show URLSpotify show URL (truncated)
FolderS3 folder prefix for episodes
ProgressVisual progress bar with counts
StatusCurrent batch status

​
Progress Bar

The progress bar shows completion status: 
████████████░░░░░░░░  45/142 (2 failed)
  • Filled portion: Completed + Failed episodes
  • Empty portion: Remaining episodes
  • Green: All episodes completed successfully so far
  • Gradient: Some episodes have failed

​
Status Values

StatusBadge ColorMeaning
processingYellowBatch is in progress
completedGreenAll episodes finished successfully
finishedYellowAll done, but some episodes failed

​
Reading Progress

Progress: 45/142 (2 failed)
  • 45: Completed episodes
  • 142: Total episodes in the show
  • 2 failed: Episodes that encountered errors

​
Batch API

Fetch your batches programmatically: 
curl -X GET "https://tornado.velys.software/dashboard/batches" \
  -H "x-api-key: sk_your_api_key"

​
Response

{
  "batches": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440001",
      "show_url": "https://open.spotify.com/show/7iQXmUT7XGuZSzAMjoNWlX",
      "folder": "huberman-lab-2024",
      "total_episodes": 142,
      "completed_episodes": 140,
      "failed_episodes": 2,
      "status": "finished"
    },
    {
      "id": "550e8400-e29b-41d4-a716-446655440002",
      "show_url": "https://open.spotify.com/show/...",
      "folder": "another-podcast",
      "total_episodes": 50,
      "completed_episodes": 23,
      "failed_episodes": 0,
      "status": "processing"
    }
  ]
}

​
Monitoring Batches

​
While Processing

  1. Watch the progress bar fill up
  2. Check for failed episode count
  3. Dashboard auto-refreshes every 10 seconds

​
After Completion

  1. Verify final status (completed vs finished)
  2. If finished with failures, check individual episode jobs
  3. Download files from your S3 folder

​
Handling Failed Episodes

When a batch has failed episodes:
1

Identify Failures

Note the number of failed episodes from the batch
2

Check Individual Jobs

Use the Jobs tab filtered by “failed” to see error messages
3

Retry if Needed

For temporary errors (rate limits, timeouts), create a new job for those specific episode URLs

​
Typical Batch Timeline

Show SizeExtractionDownloadTotal Time
10 episodes~10s2-5 min3-6 min
50 episodes~30s10-20 min15-25 min
100 episodes~60s20-40 min25-45 min
500 episodes~120s1-2 hours1-2.5 hours
Times vary based on episode length, video quality, and server load.

​
Best Practices

Name folders descriptively: show-name-year makes files easy to find later.
Use webhooks for batch completion notifications instead of polling.
For large batches, check progress periodically rather than waiting.