Toniebox Curator

If the user has run this before, check for prior download directories to avoid re-downloading the same tracks.

Step 2: Select Content by Age Band

Map the child's age to a content band. See references/age-bands.md for full detail.

Duration targets:

• Under 3yr: 1-5 min per track
• 3yr+: 3-10 min per track
• Total playlist: 45-75 min (90 min max, leave buffer)

Step 3: Research Content

Search YouTube for age-appropriate individual tracks. Use web_search or direct YouTube search.

Search strategy:

1. Start with verified channels for the age band (see references/age-bands.md)
2. Search: "{channel name}" {content type} for {age group} (e.g., "Super Simple Songs" lullaby)
3. Filter for individual tracks, not compilations (under 5-6 min)
4. For multilingual content, search channel names from the multilingual table in references/age-bands.md
5. Target 15-25 tracks per refresh

Prioritize these channels:

• Super Simple Songs, Cocomelon, Pinkfong, Dave and Ava, Little Baby Bum (0-3yr)
• Storybots, Barefoot Books, The Kiboomers (2-5yr)
• Storynory, Story Pirates, Brains On! (5-7yr)

Track selection criteria:

• Individual track (not a compilation/mix)
• Duration 1-5 min (under 3yr) or 3-10 min (3yr+)
• From a channel with >100K subscribers (exceptions for niche languages)
• Official upload (not a re-upload or content farm)

Build a track list with: title, YouTube URL, channel, estimated duration.

Step 4: Download Audio

Use scripts/download.sh for each track.

Usage:

bash scripts/download.sh <youtube_url> <output_dir> <filename>

Example:

bash scripts/download.sh "https://youtube.com/watch?v=abc123" ./downloads/emma-2026-04 "Baby Shark"
# Creates: ./downloads/emma-2026-04/baby-shark.mp3

How it works:

• Downloads via yt-dlp, converts to MP3 at 192kbps
• Sanitizes filename (lowercase, hyphens, no special chars)
• Embeds thumbnail and metadata
• Skips videos longer than 10 minutes (likely compilations). Use --force to override.
• Validates output file size (rejects files under 10KB as failed downloads)
• Reports duration via ffprobe if available

Batch process: Loop through the track list. Run downloads sequentially (not parallel) to avoid rate limiting. For each track:

bash scripts/download.sh "$url" "$output_dir" "$title"

Track failures and report at the end. Target 15-25 successful downloads per refresh.

After all downloads, verify the collection:

# Count files
ls -la "$output_dir"/*.mp3 | wc -l

# Total duration (requires ffprobe)
total=0
for f in "$output_dir"/*.mp3; do
    d=$(ffprobe -v quiet -show_entries format=duration -of csv=p=0 "$f" 2>/dev/null | cut -d. -f1)
    total=$((total + ${d:-0}))
done
echo "Total: $((total / 60)) min $((total % 60)) sec"

Ensure total duration is under 90 minutes.

Step 5: Upload to Storage

Run scripts/upload.sh to push files to the configured storage provider.

Default (local):

bash scripts/upload.sh ./downloads/child-2026-04 "ChildName" "2026-04 - Nursery Rhymes"
# Files copied to ~/toniebox-content/ChildName/2026-04 - Nursery Rhymes/

Google Drive:

export TONIEBOX_STORAGE=gdrive
export [email protected]
bash scripts/upload.sh ./downloads/child-2026-04 "ChildName" "2026-04 - Nursery Rhymes"

The folder structure at the destination:

Toniebox Content/
└── ChildName/
    └── 2026-04 - Nursery Rhymes/
        ├── baby-shark.mp3
        ├── wheels-on-the-bus.mp3
        └── ...

See references/storage-providers.md for all supported providers: local, gdrive, dropbox, onedrive, s3, syncthing, nas, nextcloud.

Step 6: Generate Summary

Present the user with a summary:

## Toniebox Content: {Child Name} — {Month} {Year}

**Theme:** {theme}
**Age band:** {age band}
**Tracks:** {count}
**Total duration:** {X} min {Y} sec (of 90 min max)
**Storage:** {provider} → {path/url}

### Track List
1. {Title} — {duration} ({channel})
2. {Title} — {duration} ({channel})
...

### Next Steps
1. Open mytonies app (iOS/Android) or my.tonies.com
2. Select the Creative Tonie to update
3. Upload the MP3 files from {storage location}
4. Place the Tonie on the Toniebox (Wi-Fi required) to sync

Step 7: Monthly Scheduling (Optional)

Set up a recurring cron job to prompt for a monthly refresh:

openclaw cron create \
  --schedule "0 10 1 * *" \
  --prompt "Time for a monthly Toniebox content refresh. Run the toniebox-curator workflow: ask for any changes to the child profile, research new content, download, and upload." \
  --label "toniebox-monthly-refresh"

This runs on the 1st of each month at 10:00 AM. The agent receives the prompt and walks through the full workflow, asking the user for confirmation at each step.

Content Safety Rules

Apply these rules when selecting content. Reject any track that fails:

1. Verified channels only. The uploading channel must be the original creator or an official partner. No re-uploads.
2. Subscriber threshold. Prefer channels with >100K subscribers. Exceptions allowed for niche language content or established educational creators with smaller audiences.
3. No Elsagate content. Reject videos featuring familiar characters in inappropriate situations, "wrong" or "bad" in titles combined with kids characters, or injection of fear/violence.
4. No AI-generated narration. If the voice sounds synthetic or robotic, skip it. Listen to a 30-second sample when unsure.
5. No content farms. Channels uploading 5+ videos/day with recycled animations and keyword-stuffed titles are not sources.
6. No compilation-only channels. Channels that only re-upload and stitch others' content together are not sources.
7. Duration sanity check. Individual tracks over 10 min are likely compilations and are auto-skipped by download.sh. Override with --force only after manual review.
8. Spot-check content. For channels not in the verified list (references/age-bands.md), listen to or watch 30 seconds before downloading.