vhs-maker-gui
v1.0.3
Published
Local Web GUI for VHS Maker video converter
Readme
VHS Maker GUI
A local web GUI for the VHS Maker video converter. The application runs on your machine and requires FFmpeg to be installed.
Features
- Batch conversion of an entire folder or single‑file conversion.
- Retro‑styled UI with glass‑morphism and a scrollable terminal log.
- Live progress via Server‑Sent Events.
- Easy installation via
npm(ornpx).
Prerequisites
- Node.js (v18 or newer recommended).
- FFmpeg must be available in the system
PATH.- macOS –
brew install ffmpeg - Windows – Download the static build from the FFmpeg website and add the
bindirectory to yourPATH. - Linux –
sudo apt‑get install ffmpeg(Ubuntu/Debian) or your distro package manager.
- macOS –
Installation
# Install globally via npm (makes the `vhs-maker` command available)
npm install -g vhs-maker-guiOr run it directly without installing:
npx vhs-maker-guiUsage
# Start the web UI (defaults to http://localhost:3000)
vhs-makerOpen the URL in your browser, then:
- Choose a file or a folder.
- Optionally specify an output path.
- Click Convert.
- Watch the real‑time log in the terminal pane.
Command‑Line Options (via the UI)
- Input – Path to a video file or a directory.
- Output – Destination file or folder (optional).
- If omitted for a folder,
vhs_outputwill be created inside the input directory.
- If omitted for a folder,
Publishing to NPM (for maintainers)
- Ensure you are logged in:
npm login. - Bump the version in
package.json(npm version patch). - Publish:
npm publish.
License
MIT © 2024‑2026 Justin Wierbonski
