media-workflow

Automate WhatsApp media processing with audio transcription and image OCR.

Updated Oct 27, 2025
One-click install
npx skills add https://github.com/asapMaki/vozzy-whatsapp --skill media-workflow
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: media-workflow
Source: https://github.com/asapMaki/vozzy-whatsapp/tree/main/.claude/skills/media-workflow
Command: npx skills add https://github.com/asapMaki/vozzy-whatsapp --skill media-workflow

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires insanely-fast-whisper, and includes scripts (resource) components.

What problem does it solve?

Managing WhatsApp media involves multiple, disconnected steps: transcribing audio, OCRing images, and then integrating them into chat logs. This skill streamlines the entire process into a single, automated workflow, eliminating manual coordination and ensuring all media is processed and logged efficiently.

Core Features & Use Cases

  • End-to-End Automation: Combines gastrohem-media-processor (audio transcription, image OCR) and chat-integrator (merging into chat.md) into one seamless command.
  • Daily Processing: Designed for daily use to keep chat logs updated with all processed media, ensuring real-time documentation.
  • Use Case: At the end of each day, simply ask to "Process and integrate media" to automatically handle all new voice notes and images, updating your chat.md files and providing a comprehensive report, all in one go.

Quick Start

To run the complete media workflow for today, simply ask: Process and integrate media. To run the workflow for a specific date (e.g., 24.10), ask: Process and integrate media for 24.10.

Frequently Asked Questions about media-workflow

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate WhatsApp media processing with transcription and OCR?

Media workflow automates end-to-end WhatsApp processing by transcribing audio files and performing OCR on images in a single command, then integrating results into chat logs. It handles daily batch processing across departments with date-based or folder-based scopes, outputting transcriptions, image summaries, and updated chat.md files.

Can I process WhatsApp media for a specific date or folder?

Yes, media workflow supports CLI options including --scan-date for specific dates and --folder to target particular directories. You can also use --dry-run to preview changes, --no-backup to skip backups, and --output-json to export results as JSON before updating chat records.

What does media workflow actually do with voice notes and images?

Media workflow transcribes voice notes using Whisper and extracts text from images via OCR, then automatically merges these results into your chat.md documentation. It produces JSON transcriptions and Markdown image summaries alongside updated chat records and backups.

How often should I run media processing to keep chat logs current?

Media workflow is designed for daily use to keep chat logs updated with newly processed media. Running it at the end of each day ensures all voice notes and images from that day are transcribed, OCR'd, and integrated into your chat.md files automatically.

What's required before using media workflow for WhatsApp processing?

Media workflow depends on insanely-fast-whisper for audio transcription. You need WhatsApp media files (audio and images) organized by date or folder, and existing chat.md files to merge processed content into.

Can media workflow handle batch processing across multiple departments?

Yes, media workflow supports daily batch processing across departments with configurable date-based or folder-based scopes. It orchestrates transcription and OCR across multiple media files and outputs comprehensive reports with transcriptions, summaries, and updated chat records in one execution.