vite-plugin-optimize-videos


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

🇧🇷 Português | 🇺🇸 English

---

English

$3

- 🎬 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.

$3

``bash
pnpm add -D vite-plugin-optimize-videos


or npm / yarn


`

$3

Basic (Defaults: quality 18, medium preset)

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

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

Advanced

`ts
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 },
});
`

$3

$3

| 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']). |
| . | object | - | Format overrides (.mp4, .webm, .mov, .avi). |

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

---

Português (Brasil)

$3

- 🎬 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.

$3

`bash
pnpm add -D vite-plugin-optimize-videos


ou npm / yarn


`

$3

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

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

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

Avançado

`ts
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 },
});
`

$3

| 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']). |
| . | object | - | Ajustes por formato (.mp4, .webm, .mov, .avi). |

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

---

$3

MIT