SSTube is a powerful, open-source YouTube downloader application that supports multiple download modes—including single videos, playlists, channels (videos and shorts), and even MP3 extractions.
-
Multiple download modes:
- Single Video / MP3 Only
- Playlist Video / Playlist MP3
- Channel Videos / Channel Videos MP3
- Channel Shorts / Channel Shorts MP3
- Integrated ffmpeg updater: Automatically downloads and installs the latest ffmpeg build.
- Activity log: Displays real-time progress and status messages.
- History management: Options to delete download history.
- Bug reporting: A built-in "Report a Bug" button to help improve the software.
This project is designed with a clean, modern GUI using Tkinter with ttkthemes and is intended for personal use with potential for further development and contributions from the community.
Simply run the SSTube executable (or run the script with Python). The main window has three sections:
- Download: For entering URLs and selecting download modes.
- Activity: Displays a log of download progress and status messages.
- Settings: For updating ffmpeg, deleting history, and reporting bugs.
- Input: Paste the URL of a single YouTube video.
- Note: If the URL looks like a playlist or channel, you will be prompted to select the appropriate mode.
- Quality: Choose video quality (for video) or audio quality (for MP3).
- Input: Paste the URL of a YouTube playlist.
- Selection: A new window will list all videos from the playlist. Check the ones you wish to download.
- Quality: Select video or audio quality accordingly.
- Input: Paste the URL of a YouTube channel.
- Note: If the URL does not include
/videos, it will be automatically appended. - Selection: A window will list all videos (excluding shorts) for selection.
- Quality: Choose the desired quality.
- Input: Paste the URL of a YouTube channel.
- Note: If the URL does not include
/shorts, it will be automatically appended. - Selection: A window will list only the shorts for selection.
- Quality: Choose the desired quality.
In the Settings panel, click Update ffmpeg. A dialog will appear with a progress bar showing the download and extraction progress. This will automatically replace the existing ffmpeg.exe in the bin folder with the latest version.
If you want to clear your download history, click the Delete History button in the Settings panel.
A: ffmpeg is a tool used to merge video and audio streams. SSTube uses it to produce a single output file.
A: Use the Update ffmpeg button in the Settings panel. This downloads the latest build automatically.
A: Ensure you are using the correct download mode. For example, use Playlist Video for a playlist URL, or Channel Videos for a channel URL.
A: Yes! Please see the Contributing section below for details.
We welcome contributions to SSTube! To get started:
Click the Fork button on GitHub to create your own copy.
git clone https://github.com/UKR-PROJETCS/SSTube.git cd SSTube
git checkout -b feature/YourFeature
Follow best practices and ensure your code is well-documented.
Push your branch and open a pull request. Please include a detailed description of your changes and any related issues.
Use GitHub Issues to report bugs or suggest features.
SSTube is released under the MIT License. You can view the full license text in the LICENSE file in this repository.
This license allows you to use, modify, and distribute the software with minimal restrictions.
If you encounter an issue, click Report a Bug in the Settings panel. This will open your default email client, pre-addressed to the support email (or bug reporting URL), so you can describe the issue.
