TwitchDownloader
TwitchDownloader copied to clipboard
Twitch video and stream downloader with GUI
Twitch Downloader
About
Twitch Downloader is a free utility made to download Twitch content (streams, videos, highlights, clips).
Current version: 1.1.0
Planned features:
Feature | v0.5 | v0.6 | v0.7 | v0.8 | v0.9 | v1.0 | v2.0 |
---|---|---|---|---|---|---|---|
GUI | ❌ | ❌ | ❌ | ❌ | ✔ | ✔ | ✔ |
Download live stream | ❌ | ❌ | ✔ | ✔ | ✔ | ✔ | ✔ |
Download VOD/Highlight | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
Download sub-only content | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
Convert files | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ✔ |
Download a clip | ❌ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
Download chat from live/clip/VOD | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ✔ |
Mass download option | ❌ | ❌ | ❌ | ✔ | ✔ | ✔ | ✔ |
User preferences | ❌ | ❌ | ❌ | ❌ | ❌ | ✔ | ✔ |
Multi language support | ❌ | ❌ | ❌ | ❌ | ❌ | ✔ | ✔ |
How to execute
GUI
npm install
npm run start
It will open a new window with the GUI. Enter the URL of the stream, video, highlight or clip you want to download. Then, select the folder, file name and click on Get Qualities button. Then, select the quality you want to download and click on Download button.
Terminal
npm install
npm run start:terminal
The terminal will ask you for the full URL of the content you want to download:
- Step 1: Enter the full URL of the content you want to download, for example:
https://www.twitch.tv/videos/365670422
- Step 1.5: If the entered URL is a live stream, it will ask you to download it when it starts or not. This means that if you press yes, it will automatically download it when it starts, with the original quality. If no, then it will ask you for the quality you want to download when it starts, but if the live ended before you set the quality, it will not download it.
- Step 2: Enter the path to download the video, it can be relative or absolute, and the file name. If no filename is passed, the default name will be the video ID.
NOTE: It will always save the file as .mp4. For example:
/home/sergio/downloads/awesomeVideo.mp4
- Step 3: Enter the quality you want to download from the selector (use the arrows). For example:
1080p60
- It will start downloading the video, and you will see the progress in the terminal.
NOTE: If you put a live stream URL, it will download from the current time, and it will keep downloading until the stream ends. For example: https://www.twitch.tv/twitch
. It may display a wrong progress because it's not possible to know the total size of the stream.
NOTE:
After entering a path to download the content, the directory structure will be created if it does not exist. Windows users: The absolute path must be for example: C:\Users\torre\Downloads\awesomeVideo.mp4
How to download massively
- Create a .txt file with the URLs of the content you want to download, one per line (line break separator).
- Enter the path of the .txt file in the first input of the program. Then, it will ask the download path and resolution.
- You can use the test/tmp/list.txt file as example.
Note: Since March 2023, Twitch has retired the old API, so it's not possible to get sub-only content. All the other features will work as expected.
Donate
If you want to support the project, you can buy me a coffee. Thanks!
Technologies used
Issues
Feel free to submit issues and enhancement requests here: Report Issue
Before posting an issue, be sure to include (if applicable):
- URL of the content to download
- Path to save the file
- Resolution of the file to download
Contributing
- Fork the repo on GitHub
- Clone the project to your own machine
- Commit changes to your own branch
- Push your work back up to your fork
- Submit a Pull request so that we can review your changes
NOTE: Be sure to merge the latest from "upstream" before making a pull request!
Any contribution to the localization of the app is welcome. You can find the localization files in the locales
folder. You can use the en.json
file as example.