Automated YouTube video uploads with 12h interval scheduling in JST

This workflow automates a batch upload of multiple videos to YouTube, spacing each upload 12 hours apart in Japan Standard Time (UTC+9) and automatically adding them to a playlist.

⚙️ Workflow Logic

1. Manual Trigger — Starts the workflow manually.
2. List Video Files — Uses a shell command to find all .mp4 files under the specified directory (/opt/downloads/单词卡/A1-A2).
3. Sort and Generate Items — Sorts videos by day number (dayXX) extracted from filenames and assigns a sequential order value.
4. Calculate Publish Schedule (+12h Interval) —
   • Computes the next rounded JST hour plus a configurable buffer (default 30 min).
   • Staggers each video’s scheduled time by order × 12 hours.
   • Converts JST back to UTC for YouTube’s publishAt field.
5. Split in Batches (1 per video) — Iterates over each video item.
6. Read Video File — Loads the corresponding video from disk.
7. Upload to YouTube (Scheduled) — Uploads the video privately with the computed publishAtUtc.
8. Add to Playlist — Adds the newly uploaded video to the target playlist.

🕒 Highlights

• Timezone-safe: Pure UTC ↔ JST conversion avoids double-offset errors.
• Sequential scheduling: Ensures each upload is 12 hours apart to prevent clustering.
• Customizable: Change SPAN_HOURS, BUFFER_MIN, or directory paths easily.
• Retry-ready: Each upload and playlist step has retry logic to handle transient errors.

💡 Typical Use Cases

• Multi-part educational video series (e.g., A1–A2 English learning).
• Regular content release cadence without manual scheduling.
• Automated YouTube publishing pipelines for pre-produced content.

Author: Zane
Category: Automation / YouTube / Scheduler
Timezone: JST (UTC+09:00)