https://github.com/phenomen/vttc
CLI file converter and optimizer for popular VTT formats
https://github.com/phenomen/vttc
cli converter ffmpeg foundryvtt roll20 tool vtt
Last synced: 11 months ago
JSON representation
CLI file converter and optimizer for popular VTT formats
- Host: GitHub
- URL: https://github.com/phenomen/vttc
- Owner: phenomen
- License: mit
- Created: 2023-04-11T01:27:45.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2024-12-01T08:03:04.000Z (over 1 year ago)
- Last Synced: 2025-07-11T21:59:03.575Z (12 months ago)
- Topics: cli, converter, ffmpeg, foundryvtt, roll20, tool, vtt
- Language: JavaScript
- Homepage:
- Size: 62.5 KB
- Stars: 4
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# VTTC - Virtual Tabletop Converter
**VTTC** is a command line tool (CLI) that quickly converts various image and video formats into optimized formats compatible with popular VTTs (e.g. Foundry VTT, Roll20, Fantasy Grounds).
## Supported Formats
- **Image conversion:** any image into WEBP, PNG, JPEG, AVIF.
- **Video conversion:** any video into WEBM, MP4, OGG, MP3.
- **Audio conversion:** any audio into OGG, MP3.
## Prerequisites
Install [Node.js 20+](https://nodejs.org/en/download) if you don't have it installed.
## Usage
1. Open a command prompt in the directory with files you want to convert.
- **Windows**: Right Click -> Open in Terminal.
- **Mac**: [see instruction](https://support.apple.com/guide/terminal/open-new-terminal-windows-and-tabs-trmlb20c7888/mac).
- **Linux**: you already should know that.
2. Run:
```
npx vttc
```
## TODO
- [x] Recursive directory processing
- [x] FFmpeg V6
- [ ] Launch with arguments bypassing prompts
- [ ] More options (remove audio track, remove transparency, custom framerate, etc.)
## Credits
- [@clack/prompts](https://github.com/natemoo-re/clack) - CLI prompts
- [@ffmpegwasm/ffmpeg.wasm](https://github.com/ffmpegwasm/ffmpeg.wasm) - FFmpeg WASM