chore:✏️ Update README for improved usage instructions

Enhances the README by restructuring usage instructions for the `voe-dl` downloader.
Clarifies steps for both command-line and Python source code usage, ensuring users understand the importance of using the latest version due to frequent website changes.
Improves formatting and adds common error troubleshooting for better user experience.

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.