https://github.com/nagrands/thunder-load-app
Thunder Load
https://github.com/nagrands/thunder-load-app
downloader macos windows yt-dlp-gui
Last synced: about 1 month ago
JSON representation
Thunder Load
- Host: GitHub
- URL: https://github.com/nagrands/thunder-load-app
- Owner: Nagrands
- Created: 2024-09-23T20:38:52.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2026-05-31T17:33:27.000Z (about 1 month ago)
- Last Synced: 2026-05-31T19:20:08.648Z (about 1 month ago)
- Topics: downloader, macos, windows, yt-dlp-gui
- Language: JavaScript
- Homepage:
- Size: 93.6 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
Thunder Load
Your fast, simple, and reliable video, audio, and file downloader
---
## Downloads
- macOS (Apple/Intel), Windows, Linux builds are published on the [Releases](https://github.com/Nagrands/thunder-load-app/releases) page.
- Choose installer or portable (where available); macOS builds are **not notarized** (see Installation notes).
---
## Features
- 🚀 Fast video & audio downloads via yt-dlp
- 🎯 Multiple formats: MP4, WebM, MKV, MP3, AAC, etc.
- 📥 Clipboard watcher and quick paste
- ⚙️ Quality/resolution selection before download
- 📜 Download history with filters, pagination, CSV/JSON export
- 💾 Backup tab with reusable profiles (source → destination), filtering, and bulk actions
- 🔄 Automatic in-app updates and dependency bootstrap (yt-dlp, ffmpeg, Deno)
- 🖥️ Clean UI with tooltips and keyboard shortcuts
## 📸 Screenshots
---
## Tech Stack & Tooling
- **Electron** — Cross-platform desktop application framework
- **Node.js** — JavaScript runtime
- **npm** — Package manager
- **yt-dlp**, **ffmpeg**, **Deno** — auto-managed binaries stored under `userData/tools`
### Scripts
| Command | Purpose |
| ------------------------------------------- | -------------------------------------------------- |
| `npm start` | Run the Electron app (builds templates beforehand) |
| `npm run dev` | Run in dev mode with `--dev` flag |
| `npm run dev:watch` | Dev mode + rebuild `whats-new` on edits |
| `npm run build` | Package the app for your platform |
| `npm run build-mac` / `npm run build-linux` | Platform-specific builds |
| `npm test` | Run Jest tests |
| `npm run check` | Lint + tests |
| `npm run css:build` | Build CSS from SCSS |
| `npm run css:watch` | Watch & rebuild SCSS |
| `npm run templates:build` | Rebuild HTML from Nunjucks templates |
| `npm run templates:watch` | Watch & rebuild templates on change |
| `npm run whats-new:build` | Build release notes from `whats-new*.md` |
| `npm run whats-new:watch` | Watch & rebuild release notes |
| `npm run format` | Format sources with Prettier |
---
## Development
Clone the repository and install dependencies:
```bash
git clone https://github.com/Nagrands/thunder-load-app.git
cd thunder-load-app
npm install
```
Run the app in development mode:
```bash
npm run dev
```
If you edit templates, styles, or release notes, run the matching build scripts
or use the `*:watch` commands.
## Installation
macOS Notice
ThunderLoad for macOS is **not notarized**. When running the app, you may see a warning that it is damaged or cannot be opened.
To run the app:
1. Move the `.app` to `/Applications`.
2. Open Terminal and run:
```
sudo xattr -dr com.apple.quarantine /Applications/Thunder\ Load.app
```
3. Then open the app normally.
---
## Configuration
- Change downloads folder or tools directory in **Settings**.
- Default data locations: macOS `~/Library/Application Support/Thunder Load`, Windows `%APPDATA%/Thunder Load`, Linux `~/.config/Thunder Load`.
- To reset tools if they break, delete `userData/tools` and relaunch (will re-download).
## Contributing
Contributions are welcome! Please open issues and submit pull requests on the [GitHub repository](https://github.com/Nagrands/thunder-load-app).