# Audio To Ogg

> Converts audio files to OGG Vorbis using FFmpeg for Godot-ready compressed assets. Use when the user wants to convert audio to OGG, transcode WAV/MP3/FLAC/AAC to OGG, batch-export game SFX/BGM, or mentions Vorbis, libvorbis, or Godot audio import.

- **Type:** Skill
- **Install:** `agentstack add skill-godot-fun-godot-framework-audio-to-ogg`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [godot-fun](https://agentstack.voostack.com/s/godot-fun)
- **Installs:** 0
- **Category:** [Content & Media](https://agentstack.voostack.com/c/content-and-media)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [godot-fun](https://github.com/godot-fun)
- **Source:** https://github.com/godot-fun/godot-framework/tree/main/.cursor/skills/audio-to-ogg

## Install

```sh
agentstack add skill-godot-fun-godot-framework-audio-to-ogg
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Audio to OGG

Convert supported audio formats to **OGG Vorbis** via FFmpeg. **Defaults preserve source sample rate** and encode at **Vorbis quality 6** — a balanced preset for game SFX and BGM.

## Rules

When this skill applies, read and follow [skill-dependency-manager](../../rules/skill-dependency-manager.md) — run scripts as documented, install missing tools into `.dependency/`.

## Quick Start

Convert a file or folder, output to `ogg/`:

```bash
.dependency/python/python .cursor/skills/audio-to-ogg/scripts/convert.py path/to/audio_or_folder
```

Example: `audio/sfx/tank/tank_move.wav` → `audio/sfx/tank/ogg/tank_move.ogg`

Batch with subfolders:

```bash
.dependency/python/python .cursor/skills/audio-to-ogg/scripts/convert.py Audio/SFX -r
```

## Format Defaults

| Setting | Default | Notes |
|---------|---------|-------|
| Codec | OGG Vorbis (`libvorbis`) | Godot-native compressed format |
| Sample rate | Preserve source | No resampling unless `-s` or `--standardize` |
| Quality | `6` (`-q 6`) | ~192 kbps VBR; use `-q` to adjust |
| Channels | Preserve source | Use `--mono` or `--stereo` to force |
| Existing Vorbis OGG | Stream copy | Bit-perfect when no overrides |

## Quality Guide

| `-q` | Approx. bitrate | Typical use |
|------|-----------------|-------------|
| 3–4 | ~96–128 kbps | Short UI clicks, ambient loops |
| 5–6 | ~160–192 kbps | Gameplay SFX, BGM (default) |
| 7–8 | ~224–256 kbps | Music masters, voice dialogue |
| 9–10 | ~320–500 kbps | Archival; rarely needed in games |

## Common Flags

`-r` · `-o` / `--output-dir` · `-s` / `--sample-rate` · `-q` / `--quality` · `--standardize` · `--mono` · `--stereo` · `--dry-run` · `--overwrite`

Project batch preset (48 kHz Vorbis):

```bash
.dependency/python/python .cursor/skills/audio-to-ogg/scripts/convert.py Audio/SFX -r --standardize
```

Lower quality for UI sounds:

```bash
.dependency/python/python .cursor/skills/audio-to-ogg/scripts/convert.py Audio/UI -q 4 --dry-run
```

**Never overwrite source files.** The script writes only to `ogg/` (or `-o`). Supported inputs: `.mp3`, `.ogg`, `.flac`, `.aac`, `.m4a`, `.wma`, `.wav`.

## Agent Notes

1. Use the bundled script, not hand-written `ffmpeg -i …` commands.
2. **Do not resample** unless the user explicitly asks — omit `-s` and `--standardize`.
3. **Already Vorbis OGG?** Stream-copied by default (no generation loss).
4. Missing Python/FFmpeg → populate `.dependency/` per skill-dependency-manager, retry same command.
5. **Do not copy, move, or replace the source with converted output** — tell the user where `ogg/` files are; they swap assets manually when ready.
6. Need **48 kHz project batch** → pass `--standardize`.
7. FFmpeg codec and quality details: [reference.md](reference.md)

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [godot-fun](https://github.com/godot-fun)
- **Source:** [godot-fun/godot-framework](https://github.com/godot-fun/godot-framework)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-godot-fun-godot-framework-audio-to-ogg
- Seller: https://agentstack.voostack.com/s/godot-fun
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.