Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 0 additions & 1 deletion .gitignore
Original file line number Diff line number Diff line change
@@ -1,7 +1,6 @@
<<<<<<< HEAD
build/bin
node_modules
frontend/dist
TODO.md

=======
Expand Down
98 changes: 17 additions & 81 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,65 +1,36 @@

# Predator

<p align="center">
<img src="asset/Predatorv1.png" width="200">
</p>


A simple desktop app for downloading YouTube videos and audio. Built with Go and Wails, using yt-dlp (go-ytdlp) under the hood.
A simple desktop app for grabbing videos and audio from YouTube and Instagram. Built with Go and Wails (web tech frontend), using yt-dlp under the hood to do the heavy lifting.

## What it does

- Download YouTube videos in any resolution from 144p up to 4K
- Extract just the audio in MP3, M4A, Opus, or WAV format
- Shows you file sizes before you download
- Track download progress with speed and ETA
- Cancel downloads if you change your mind
- Pick where you want files saved
- Keeps a history of what you've downloaded
- **Download videos** from YouTube in any resolution from 144p up to 4K
- **Grab audio only** in MP3, M4A, Opus, or WAV format
- **Works with Instagram too** - reels, posts, stories, TV videos
- **Playlist support** - Download entire YouTube playlists or pick specific videos
- **Shows file sizes** before you download so you know what you're getting into
- **Live progress tracking** - Watch speed, ETA, and percentage in real-time
- **Cancel anytime** - Change your mind? Hit cancel and it stops cleanly
- **Picks up where it left off** - Failed downloads auto-retry up to 3 times
- **Duplicate detection** - Warns if you already downloaded something
- **Choose where files go** - Set your download folder once, it remembers
- **Keeps history** - See what you've downloaded, filter by video/audio, open files directly
- **Dark and light themes** - Toggle with Ctrl+T

## Getting started

You'll need Go 1.24 or newer installed.
You'll need **Go 1.24 or newer** installed.

```bash
git clone https://github.com/Aswanidev-vs/Predator.git
cd Predator
go mod download
```

To run it:

```bash
cd Predator
wails dev
```

To build:

```bash
cd Predator
wails build
```

The first time you run it, it'll ask to download yt-dlp and ffmpeg automatically. Just say yes - it handles everything.



## How to use

1. Open the app
2. Click "Change Download Location" to pick where files go (or it'll use the current folder)
3. Paste a YouTube URL
4. Choose video or audio, pick your format
5. Hit download and wait

That's it. The app shows progress in real-time and you can cancel anytime.

## A few things to know

- It tries to download the exact resolution you pick. If that's not available, it falls back to the next best thing.
- Videos get merged into a single MP4 file with H.264 codec for compatibility.
- Audio gets extracted in whatever format you chose.
- Download history is saved locally so you can find your files later.
=======
# Predator - YouTube Downloader
<p align="center">
<img src="asset/Predatorv1.png">
Expand Down Expand Up @@ -172,7 +143,6 @@ Predator/
- **Debounced Input**: 600ms debounce on URL input to prevent excessive API calls
- **Atomic Operations**: Thread-safe state management for concurrent operations
- **Streaming Download**: Supports live progress updates during download
>>>>>>> 5c9da659bc26ab9faf682fb549dc7e0b599a7169

## Disclaimer

Expand Down Expand Up @@ -207,37 +177,3 @@ This application is provided "as-is" without warranty of any kind, express or im

The authors assume no responsibility for any illegal activities or misuse of this tool. By using Predator, you accept all risks and responsibilities associated with your downloads.

<<<<<<< HEAD
=======
## License

MIT License

Copyright (c) 2025 Aswanidev-vs

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

## Contributing

Contributions are welcome! Feel free to submit issues and pull requests.



**Note**: This application requires an active internet connection to download from YouTube and relies on the yt-dlp project to function.

Loading
Loading