Merge branch 'docs-update-help-and-readme'

Author: MPZ-00

README.md

@@ -1,46 +1,131 @@
+
 # voe-dl
-A Python downloader for voe.sx videos
 
-# Warning
+A Python-based downloader for videos hosted on [voe.sx](https://voe.sx).
 
-**Please use always the newest Version, because these suckers at voe change their site from time to time
-to make it harder for us to download via script!**
-**Currently working Version is v1.2.4**
+[![Latest Release](https://img.shields.io/github/v/release/p4ul17/voe-dl)](https://github.com/p4ul17/voe-dl/releases)
 
-# Usage
-1. Download the latest Release
-2. add the executable to PATH (just search for how to do it if you don't know)
-3. use the:
+---
 
-### Single File Downloader
-```
-voe-dl [URL]
-voe-dl -u [URL]
+## ⚠️ Always Use the Latest Version
+
+> Voe frequently updates their website to break download scripts.  
+> **Make sure you are using the latest version** of `voe-dl` to ensure compatibility.
+
+---
+
+## 📥 How to Use `voe-dl`
+
+### Method 1: Using `voe-dl.exe`
+
+1. **Open Command Prompt**  
+   Press `Win + R`, type `cmd`, and press Enter.
+
+2. **Navigate to the folder with `voe-dl.exe`**  
+   Example:
+   ```cmd
+   cd "C:\Users\YourName\Downloads"
+   ```
+
+3. **Download a video**
+   ```cmd
+   voe-dl.exe -u https://voe.sx/yourvideo
+   ```
+
+> 📝 You don’t need to add `voe-dl.exe` to your system PATH. Just navigate to the folder in CMD.
+
+---
+
+### Method 2: Running from Python Source Code
+
+1. **Install Python**  
+   [Download Python](https://www.python.org/downloads) and make sure to check the box:
+   - ✅ "Add Python to PATH"
+
+2. **Clone or download the repository**
+
+3. **Install requirements**  
+   In the project folder:
+   ```cmd
+   pip install -r requirements.txt
+   ```
+
+4. **Run the script**
+   ```cmd
+   python dl.py -u https://voe.sx/yourvideo
+   ```
+
+5. **See all options**
+   ```cmd
+   python dl.py -h
+   ```
+
+---
+
+## 📄 Command Line Usage
+
+### Download Single Video
+```bash
+voe-dl -u https://voe.sx/yourvideo
 ```
-   
-  whereas [URL] is the Link to the voe site\
-  just downloads the link you specify
-   
-### Multiple File Downloader
-  Put your links in [links.txt] or any other File, one at each line\
-  example:
+
+### Download from a list (batch)
+Create a `links.txt` file:
 ```
-https://voe.sx//xxxxxxx
-https://voe.sx//yyyyyyy
-https://voe.sx//zzzzzzz
+https://voe.sx/xxxxxxx
+https://voe.sx/yyyyyyy
 ```
-  execute
+
+Run:
+```bash
+voe-dl -l links.txt
 ```
-voe-dl -l [File_Name]
+
+### Optional: Parallel Downloads
+You can add the `-w` option to set number of parallel workers:
+```bash
+voe-dl -l links.txt -w 8
 ```
-  It will download the links one after another
-  
-# Output
-The Output Video Files will be saved in the folder you execute the script
+(Default is 4)
+
+---
+
+## 📂 Output
+
+Downloaded videos will be saved in the same folder where you run the command.
+
+---
+
+## 🛠 Common Errors & Fixes
+
+### ❌ SyntaxError when pasting into Python
+Make sure you run commands in **CMD/Terminal**, not in the Python shell (`>>>` prompt).
 
-# Help
-execute
+### ❌ CMD window closes instantly
+Open CMD manually and run the tool from there to see error output.
+
+### ❌ `requests.exceptions.InvalidSchema`
+Make sure the URL is valid and doesn't contain brackets or formatting issues.
+
+✅ Correct:
+```
+https://voe.sx/fi3fqtyh7932
 ```
+
+### ❌ No connection adapter found
+Ensure the URL starts with `http://` or `https://` and doesn't contain strange characters.
+
+---
+
+## 🆘 Help
+Run:
+```bash
 voe-dl -h
 ```
-for help directly from the script
+This will print all available options, arguments, and descriptions.
+
+---
+
+## 💡 Contributing
+
+Pull requests are welcome! If you fix a bug or add a feature, please update the README accordingly.

dl.py

@@ -81,7 +81,8 @@ def main():
 
 def help():
     print("Version History:")
-    print("- Version v1.5.0 (Latest, Improved source detection and bait handling)")
+    print("- Version v1.5.1 (Documentation updates: help descriptions, README usage info)")
+    print("- Version v1.5.0 (Improved source detection and bait handling)")
     print("- Version v1.4.0 (Forked by MPZ-00)")
     print("- Version v1.3.1 (Forked by HerobrineTV, Fixed issues with finding the Download Links)")
     print("")
@@ -90,10 +91,11 @@ def help():
     print("-h shows this help")
     print("-u <URL> downloads the <URL> you specify")
     print("-l <doc> opens the <doc> you specify and downloads every URL line after line")
+    print("-w <number> sets the number of parallel workers for list downloads (default: 4)")
     print("<URL> just the URL as Argument works the same as with -u Argument")
     print("______________")
     print("")
-    print("Credits to @NikOverflow, @cuitrlal and @cybersnash on GitHub for contributing")
+    print("Credits to @NikOverflow, @cuitrlal, @cybersnash, @HerobrineTV and @MPZ-00 on GitHub for contributing")
 
 def list_dl(doc, workers=4):
     """