SWK Download Script

This Python script allows you to download episodes of "Świat Według Kiepskich" with resume support. It handles downloading episodes by season or globally numbered episodes, and includes features like partial download removal and progress tracking.

Important Notice

Disclaimer: I am not the author or creator of the .txt file, its contents, or any of the links within it. I have no affiliation with the owners or creators of "Świat Według Kiepskich" or any related content. "Świat Według Kiepskich" is the property of Polsat and all rights to the show belong to them. I take no responsibility for the content of the .txt file or how it is used. This script is purely a tool written in Python to assist with downloading the episodes listed in the provided .txt file.

Available Languages

• Polski (Polish)
• English (This file)

Easy Setup Guide

If you're not familiar with programming or installing software, follow these steps to get everything set up. This guide will help you install the necessary tools and run the script easily.

Step 1: Install Git

Git is a version control system that will help you download the script from GitHub.

1. Open the Command Prompt (cmd). You can do this by typing cmd in the Start Menu and pressing Enter.

2. Type the following command and press Enter:

   winget install --id Git.Git -e --source winget

3. Wait for the installation to complete.

Step 2: Install Python

Python is the programming language used to run this script.

1. In the same Command Prompt window, type the following command and press Enter:

   winget install --id Python.Python.3.12 -e --source winget

2. Wait for the installation to complete.

Step 3: Download the Script

1. After installing Git, type the following command to download the script from GitHub:

   git clone https://github.com/dam2452/SWK-PY

2. Navigate to the script's directory:

   cd SWK_download

Step 4: Install Required Python Libraries

1. Before running the script, you need to install a couple of Python libraries. In the same Command Prompt window, type:

   pip install requests tqdm

2. Wait for the installation to complete.

Step 5: Run the Script

Now you're ready to download the episodes!

• To download all episodes using the default settings, simply type:

  python SWK_download.py

• To download a specific episode (e.g., episode 166), type:

  python SWK_download.py --episode 166

• To download all episodes from a specific season (e.g., season 3), type:

  python SWK_download.py --season 3

The episodes will be downloaded to a folder called SWK_downloaded in the same directory where the script is located.

Features

• Resume Support: Automatically resumes downloads from where they left off.
• Progress Bars: Provides real-time progress bars for both individual episodes and total download progress.
• Partial File Cleanup: Removes incomplete files before starting a new download session.
• Flexible Numbering Modes: Supports both season-based and global episode numbering.
• Selective Downloading: Allows downloading a specific episode or all episodes from a particular season.

Requirements

• Python 3.6 or higher
• requests library
• tqdm library

These requirements are automatically installed if you follow the Easy Setup Guide above.

Usage

Default Usage

If you want to use the default input (kiepscy.txt in the script's directory) and output (SWK_downloaded in the script's directory), simply run:

python SWK_download.py

Custom Usage

You can customize the input file and output directory paths using the --input and --output options:

python SWK_download.py --input /path/to/your/kiepscy.txt --output /path/to/output/directory

Downloading Specific Episode

To download a specific episode by its global number:

python SWK_download.py --episode 166

Downloading a Full Season

To download all episodes from a specific season:

python SWK_download.py --season 3

Input File Format

The input file (kiepscy.txt) should list the seasons and episode URLs in the following format:

SEZON 1
http://example.com/episode1.mp4
Episode Name 1
http://example.com/episode2.mp4
Episode Name 2

SEZON 2
http://example.com/episode3.mp4
Episode Name 3

Example

Here's an example of running the script to download all episodes from season 3:

python SWK_download.py --season 3

Contribution

Contributions, issues, and feature requests are welcome! Feel free to check the issues page.

License

This project is licensed under an open license, allowing anyone to use, modify, and distribute the code without restriction.