wavesconv
v1.7.1
Published
CLI: pobieranie YouTube (yt-dlp) i konwersja mediów (ffmpeg) — WavesConverter
Maintainers
Readme
Download anything. Convert everything.
A premium desktop app for macOS & Windows that downloads YouTube videos and playlists, converts any media file — all offline, no account needed, completely free.
✨ Features
| | Feature | Description |
|---|---|---|
| 📋 | Playlist Support | Download entire playlists or cherry-pick individual videos. Override format & quality per item. |
| ⚡ | Concurrent Queue | Run multiple downloads simultaneously. Pause, resume, retry — full control. |
| 🔢 | Batch Paste | Paste multiple YouTube URLs at once. Batch panel appears with shared format settings. |
| 📊 | ETA & Speed | Live download speed (e.g. 3.2 MiB/s) and time remaining (ETA 00:42) on every active item. |
| 🎛️ | Quality Control | 360p → 4K for video, 96 → 320 kbps for audio. Apply globally or per video. |
| 🔄 | Local File Converter | Convert any media file — change container, resolution, bitrate. No internet needed. |
| 📖 | Download History | Every completed download logged with file path, format, and date. |
| ⌨️ | Keyboard Shortcuts | ⌘V paste & fetch, ⌘D queue, ⌘1–5 tabs, Space start/pause. |
| 🔔 | Native Notifications | System notification when a download finishes — even if the app is in the background. |
| 🔒 | 100% Offline | No servers, no accounts, no analytics. Powered by yt-dlp + ffmpeg bundled inside. |
| ✨ | Auto Updates | Silent background updates via GitHub Releases. One click to install. |
📥 Download
| Platform | Link | |---|---| | 🍎 macOS Apple Silicon (M1/M2/M3/M4) | WavesConverter-arm64.dmg | | 🍎 macOS Intel (x64) | WavesConverter.dmg | | 🪟 Windows 10+ (x64) | WavesConverter-Setup.exe |
Windows users: SmartScreen may show a warning since the app isn't signed with a paid certificate. Click "More info" → "Run anyway" to proceed. The source code is fully open and auditable here.
🚀 Quick Start
Download a video
- Paste any YouTube URL into the input field (or press
⌘Vto auto-paste) - Click Fetch — video metadata loads instantly
- Pick your format (
MP4,MP3,WAV…) and quality (1080p,4K,320kbps…) - Click Add to Queue, switch to the Queue tab, hit Start
Batch download
Paste multiple YouTube URLs (newline or space separated) — WavesConverter detects them automatically and switches to batch mode. Set format once, add all to queue.
Convert a local file
Drag any media file onto the Convert tab, pick the output format and settings, click Convert.
⌨️ Keyboard Shortcuts
| Shortcut | Action |
|---|---|
| ⌘V | Paste URL & auto-fetch (from anywhere in the app) |
| ⌘↵ | Fetch the current URL |
| ⌘D | Add fetched video to queue |
| ⌘K | Focus the URL input |
| ⌘1 – ⌘5 | Switch between tabs |
| Space | Start / pause queue (in Queue tab) |
| ⌘⇧C | Clear completed items from queue |
🛠️ Tech Stack
- Electron — cross-platform desktop shell
- yt-dlp — YouTube downloading engine
- ffmpeg — media conversion & processing
- @ffmpeg-installer/ffmpeg — bundled ffmpeg binary
- electron-updater — automatic updates via GitHub Releases
🏗️ Build from Source
# Clone the repository
git clone https://github.com/idunnowhytf/wavesconvsite.git
cd wavesconvsite
# Install dependencies
npm install
# Run in development
npx electron .
# Build for macOS
npx electron-builder --mac --publish never
# Build for Windows (works from macOS via Wine)
npx electron-builder --win --x64 --publish neverRequirements: Node.js 18+, npm
📁 Project Structure
wavesconvsite/
├── main.js # Electron main process — IPC, yt-dlp spawning, ffmpeg
├── preload.js # Context bridge — exposes safe APIs to renderer
├── renderer.js # UI logic — queue, history, batch paste, ETA
├── index.html # App shell — tabs, layout
├── style.css # App styles — glassmorphism dark purple theme
├── assets/
│ ├── icon.icns # macOS app icon
│ ├── icon.ico # Windows app icon
│ └── icon.png # Generic icon
└── docs/ # GitHub Pages website
├── index.html # Landing page
├── changelog.html
└── docs.html📋 Changelog
See Releases → for full version history.
🤝 Contributing
Found a bug or have a feature idea? Open an issue — all feedback welcome.
⚖️ Legal
WavesConverter uses yt-dlp and ffmpeg under their respective open-source licenses.
Downloading copyrighted content without permission may violate YouTube's Terms of Service and local laws.
This tool is intended for downloading content you own or have permission to download.
Website · Releases · Docs · Changelog
Made with ❤️ using Electron, yt-dlp & ffmpeg · Free & Open Source
