This skill should be used when the user asks to "create boomwhacker video", "generate boomwhacker playalong", "make falling notes video", "process with boomwhackers", mentions "boomwhacker visualization", or discusses creating play-along videos from audio/video files.
Clean up temp directory periodically to save disk space
Use descriptive filenames if processing multiple videos
Activate virtual environment at the start of each session
Example Usage
Example 1: YouTube Video
cd /var/home/mzibrick/Projects/personal/mzibrick-tooling/boomwhackers
source venv_boomwhacker/bin/activate
python3 song_add_boomwhackers_playalong.py --preview "https://www.youtube.com/watch?v=VIDEO_ID"
# Review Preview_Boomwhacker_Video.mp4, then decide whether to generate full video
Example 2: Local Audio File
cd /var/home/mzibrick/Projects/personal/mzibrick-tooling/boomwhackers
source venv_boomwhacker/bin/activate
python3 song_add_boomwhackers_playalong.py "mysong.mp3"
# Output: Final_Boomwhacker_Video.mp4 with notes on black background
Example 3: Local Video File
cd /var/home/mzibrick/Projects/personal/mzibrick-tooling/boomwhackers
source venv_boomwhacker/bin/activate
python3 song_add_boomwhackers_playalong.py "myvideo.webm"
# Output: Final_Boomwhacker_Video.mp4 with notes overlaid on original video
Implementation Details
When helping users with this skill:
Always check if in correct directory before running commands
Always activate virtual environment first
Use preview mode unless user specifically asks for full video
Provide full paths or explain relative paths clearly
Mention output filename so user knows what to look for
Suggest cleanup of temp files after successful generation
If first time use, recommend applying the patch for better visibility