‼️ Project Deprecated ‼️

This project is deprecated in favor of a more robust version written in Go. For an improved experience, please visit the ItslearningDL Go repository.

The original Readme is available here.

Itslearning-DL Tool

The Itslearning-DL Tool is a Python-based utility for downloading resources from the Itslearning platform.

Overview

This tool allows users to:

• Download Itslearning Resources: Fetch various resources from Itslearning, such as documents or media files.
• Customize Download Options: Specify download paths, provide credentials, and fetch specific resources.

Features

• Download resources from Itslearning by providing your credentials.
• Customize the output path for downloaded resources.
• Fetch new resources or update all including existing ones.

Installation

1. Clone the repository:

   git clone https://github.com/unterdrueckt/itslearning-dl.git

2. Navigate to the project directory:

   cd itslearning-dl

3. Install itslearning-dl:

   python install.py

How to Use the Tool

1. Initial Run: On the first run, the tool will set up all necessary folders and automatically open the configuration file. You can also manually open the configuration file using the -conf or --config parameter.

2. Configuration: In the configuration file, you can enter your username, password, and instance for the initial setup.

3. Running the Tool: You can run the tool using either of the following commands:

   itslearning-dl

   or

   ildl

Running without Installation:
If you prefer not to install the tool globally, you can use the Itslearning-DL Tool without installation. This method allows you to run the tool directly from the cloned repository.

Help Command

For additional information on available commands and options, use the -h or --help command:

itslearning-dl -h

This will display a help message with a list of available options and their descriptions.

Configuration

• Credentials: You can provide your Itslearning username and password as command-line arguments or set environment variables: ITSLEARNING_USERNAME and ITSLEARNING_PASSWORD.
• Output Path: By default, the tool saves downloaded resources to the /out directory. You can specify a custom path using the --path argument.