vite-plugin-optimize-videos

A Vite plugin to optimize videos during build, maintaining input formats (mp4, webm, mov, avi).

🇧🇷 Português | 🇺🇸 English

English

Features

• 🎬 Format Preservation: Keeps original container (mp4, webm, mov, avi).
• 📦 Zero Config: Works out of the box with embedded ffmpeg.
• ⚙️ Granular Control: Configure quality/presets globally or per-format.
• 📁 Auto-Discovery: Automatically finds and optimizes videos in dist.

Installation

pnpm add -D vite-plugin-optimize-videos
# or npm / yarn

Usage

Basic (Defaults: quality 18, medium preset)

// vite.config.ts
import { optimizeVideos } from "vite-plugin-optimize-videos";

export default defineConfig({
  plugins: [optimizeVideos()],
});

Advanced

optimizeVideos({
  quality: 20, // Global default
  exclude: ["intro.mp4"], // Skip files
  ".mp4": {
    quality: 18, // Override for mp4
    preset: "slow", // Slower encoding, better compression
  },
  ".webm": { quality: 25 },
});

Configuration

Configuration

| Option | Type | Default | Description | | ------------- | ---------- | ---------- | ------------------------------------------------------------- | | quality | number | 18 | CRF value. Lower = better quality/larger file. Rec: 18-23. | | preset | string | 'medium' | Encoding speed: fast, medium, slow. | | mute | boolean | false | Set to true to remove audio. Defaults to keeping audio. | | concurrency | number | 4 | Number of videos to process in parallel. | | exclude | string[] | [] | Patterns/Extensions to skip (e.g. ['intro', 'test']). | | .<ext> | object | - | Format overrides (.mp4, .webm, .mov, .avi). |

Note: Audio is PRESERVED by default. Use mute: true to remove it.

Português (Brasil)

Recursos

• 🎬 Preservação de Formato: Mantém o container original (mp4, webm, mov, avi).
• 📦 Zero Configuração: Funciona direto com ffmpeg embutido.
• ⚙️ Controle Granular: Ajuste qualidade/presets globalmente ou por formato.
• ⚡ Processamento Paralelo: Otimiza vários vídeos simultaneamente.
• 📁 Auto-Descoberta: Encontra e otimiza vídeos na pasta dist automaticamente.

Instalação

pnpm add -D vite-plugin-optimize-videos
# ou npm / yarn

Como Usar

Básico (Padrões: qualidade 18, preset medium)

// vite.config.ts
import { optimizeVideos } from "vite-plugin-optimize-videos";

export default defineConfig({
  plugins: [optimizeVideos()],
});

Avançado

optimizeVideos({
  quality: 20, // Padrão global
  mute: true, // Remover áudio (padrão é false/manter)
  concurrency: 2, // Processar 2 vídeos por vez
  exclude: ["intro.mp4"], // Ignorar arquivos
  ".mp4": {
    quality: 18, // Sobrescrever para mp4
    preset: "slow", // Codificação mais lenta, melhor compressão
  },
  ".webm": { quality: 25 },
});

Configuração

| Opção | Tipo | Padrão | Descrição | | ------------- | ---------- | ---------- | -------------------------------------------------------------- | | quality | number | 18 | Valor CRF. Menor = melhor qualidade/arquivo maior. Rec: 18-23. | | preset | string | 'medium' | Velocidade: fast, medium, slow. | | mute | boolean | false | Defina como true para remover o áudio. Padrão: manter. | | concurrency | number | 4 | Número de vídeos para processar em paralelo. | | exclude | string[] | [] | Padrões/Extensões para pular (ex: ['intro', 'teste']). | | .<ext> | object | - | Ajustes por formato (.mp4, .webm, .mov, .avi). |

Nota: O áudio é MANTIDO por padrão. Use mute: true para removê-lo.

License

MIT