Ffmpeg

Skill PIXARTSeu/Synapse/packages/codegraph/data/skill/ffmpeg

Self-improving AI brain for Claude Code & Desktop — 28 MCP tools, 253 skills, collective memory, project tracking, work logs. One server, all your sessions share the same knowledge. Deploy on Coolify in 2 minutes.

Install

npx -y skills add PIXARTSeu/Synapse --skill ffmpeg

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
8 stars8 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

FFmpeg integration for server-side video processing - transcoding, filters, thumbnails. Use when processing video server-side, generating thumbnails, transcoding formats, or applying video filters.

SKILL.md

4.3 KB, ~1.1k tokens by cl100k_base, as published. Nobody here has run it

FFmpeg Knowledge Base

Integrazione Server-Side (Next.js + Docker)

Per processare, convertire e migliorare video esistenti, la soluzione migliore è eseguire FFmpeg nativo lato server (via Docker) controllato da Node.js.

1. Installazione (System)

Aggiungi FFmpeg al tuo Dockerfile (Debian-based):

# Dockerfile
FROM node:22-bookworm-slim

# Install ffmpeg
RUN apt-get update && apt-get install -y ffmpeg && rm -rf /var/lib/apt/lists/*

WORKDIR /app
# ... resto del Dockerfile

2. Installazione (Node.js)

Usa fluent-ffmpeg per controllare FFmpeg da codice TypeScript.

pnpm add fluent-ffmpeg
pnpm add -D @types/fluent-ffmpeg

Setup Core

Crea un'utility per gestire i path e la configurazione.

// src/lib/ffmpeg.ts
import ffmpeg from 'fluent-ffmpeg';

// Opzionale: se il path non è nel PATH di sistema
// ffmpeg.setFfmpegPath('/usr/bin/ffmpeg');

export const processVideo = (inputPath: string, outputPath: string) => {
  return new Promise((resolve, reject) => {
    ffmpeg(inputPath)
      .output(outputPath)
      .on('end', () => resolve(true))
      .on('error', (err) => reject(err))
      .run();
  });
};

Pattern Comuni

Conversione & Ottimizzazione (Web-Ready)

Converte in MP4 (H.264/AAC) ottimizzato per il web (Fast Start).

export async function optimizeVideo(input: string, output: string) {
  return new Promise((resolve, reject) => {
    ffmpeg(input)
      .videoCodec('libx264')
      .audioCodec('aac')
      .outputOptions([
        '-crf 23',           // Qualità bilanciata (18-28)
        '-preset fast',      // Speed vs Compression
        '-movflags +faststart' // Streaming immediato
      ])
      .save(output)
      .on('end', resolve)
      .on('error', reject);
  });
}

Estrazione Thumbnail

export async function generateThumbnail(input: string, outputFolder: string) {
  return new Promise((resolve, reject) => {
    ffmpeg(input)
      .screenshots({
        count: 1,
        folder: outputFolder,
        filename: 'thumbnail-%b.png',
        size: '1280x720'
      })
      .on('end', resolve)
      .on('error', reject);
  });
}

"Miglioramento" Video (Filtri Base)

Miglioramento base senza AI (denoise, sharpening, color correction).

export async function enhanceVideo(input: string, output: string) {
  return new Promise((resolve, reject) => {
    ffmpeg(input)
      .videoFilters([
        'hqdn3d=1.5:1.5:6:6',  // High Quality Denoise (leggero)
        'unsharp=5:5:1.0:5:5:0.0', // Sharpening
        'eq=saturation=1.1:contrast=1.05' // Color correction leggera
      ])
      .save(output)
      .on('end', resolve)
      .on('error', reject);
  });
}

Estrazione Audio

ffmpeg(input)
  .noVideo()
  .audioCodec('libmp3lame')
  .save('audio.mp3');

Gestione File Temporanei

Quando lavori con Server Actions o API Routes, usa directory temporanee.

import { join } from 'path';
import { tmpdir } from 'os';
import { writeFile, unlink } from 'fs/promises';

export async function handleUpload(file: File) {
  const bytes = await file.arrayBuffer();
  const buffer = Buffer.from(bytes);
  
  const tempInput = join(tmpdir(), `input-${Date.now()}.mp4`);
  const tempOutput = join(tmpdir(), `output-${Date.now()}.mp4`);
  
  try {
    await writeFile(tempInput, buffer);
    await optimizeVideo(tempInput, tempOutput);
    // ... upload tempOutput to S3/Blob ...
  } finally {
    // Cleanup fondamentale
    await Promise.all([
      unlink(tempInput).catch(() => {}),
      unlink(tempOutput).catch(() => {})
    ]);
  }
}

Best Practices

Non bloccare il main thread: FFmpeg è pesante. Usa code (es. BullMQ) o background jobs per video lunghi.
Timeout: Le Serverless Functions (Vercel) hanno timeout brevi. Per video lunghi serve un server persistente (VPS/Coolify).
Security: Non passare mai stringhe utente direttamente a complexFilter o comandi shell.
Hardware Acceleration: Se il server ha GPU (es. NVIDIA), usa flag come -c:v h264_nvenc per performance 10x.