🎬 FFmpeg & Media Operations Copilot

A universal, privacy-aware prompt for working with video, audio, image, and metadata operations using FFmpeg, ffprobe, or shell scripts.
Built for clarity, safety, and direct usability in GPTs, copilots, or automation pipelines.

---

🧭 What It Does

• Accepts natural language or sample commands (e.g. “convert mp4 to gif” or “fix this ffmpeg error”)
• Returns safe, modern, and copy-paste ready FFmpeg/ffprobe commands or scripts
• Includes batch support, multi-step logic, error diagnosis, and OS-aware scripting
• Warns about risky operations like overwrites or deletions
• Adds usage explanations only when requested

---

🚀 How to Use the Prompt

The prompt.md file defines a reusable AI behavior prompt for handling FFmpeg/media-related requests.

You can use it in different environments:

• 🧠 Custom GPTs (ChatGPT)
  Paste it into the System Instructions at chat.openai.com/gpts

• 🤖 Other LLM platforms
  Compatible with models like Claude, Gemini, Mistral, or Groq LLaMA — paste into their system message or config

• 💻 Local assistants
  Use it as a behavior template in Open Interpreter, GPT4All, LM Studio, etc.

• 🔌 LLM-integrated apps or pipelines
  Inject as the system_prompt for any backend calling OpenAI, Anthropic, Groq, or similar APIs

Prompt includes both logic and phrasing examples.
For a beginner-friendly overview, see prompt-user-guide.md.

---

🛡️ Safety by Design

• Prompts respect privacy: no logging, no transmission
• Flags risky operations (e.g., deletes, overwrites) with # RISK
• Defaults to non-destructive behavior
• Only explains commands when asked

---

🧪 Example Requests

• “Batch convert all .movs in a folder to mp4, 720p, best for mobile”
• “Extract frames every 10s, output as PNGs with timestamp naming”
• “Fix this command and explain what’s wrong: ffmpeg -i video.mp4 -c copy output”
• “Make a looping GIF from video: start at 20s, duration 5s, best quality”

See prompt-user-guide.md for more advanced phrasing and clarification requests.

---

📂 Files Included

File	Purpose
prompt.md	Full universal version: logic, flow, request handling
prompt-system-core.md	Slim AI-facing version (rules + logic only)
prompt-user-guide.md	Human-facing guide with usage tips and phrasing
LICENSE.md	Open MIT license
README.md	This project overview and usage guide

---

📦 Files Explained

File	Purpose
prompt.md	Full prompt: rules, phrasing, session handling, and examples
prompt-user-guide.md	Human-readable usage tips and advanced request examples
prompt-system-core.md	Clean system-only version (for embedding inside AI copilot logic)
LICENSE.md	MIT License for public reuse and remixing
README.md	This overview and integration guide

---

👤 Author

Luis Alberto Martinez Riancho
@arenagroove
Technical Director – Less Rain GmbH

---

🔖 License

Licensed under the MIT License.
Use it freely, remix, embed in your own GPTs, or adapt into CLI tooling.

---

📁 Metadata

• Title: FFmpeg & Media Operations Copilot
• Version: 1.0
• Last Updated: 26-07-2025
• Author: Luis Alberto Martinez Riancho (@arenagroove)
• Affiliation: This project is independent but reflects R&D culture at Less Rain GmbH
• Tags: ffmpeg, media-processing, prompt-engineering, shell-scripting, ai-copilot, batch-automation, privacy-aware
• License: MIT