From 5955967a594a1498e85da2d627d1f41b27af50f8 Mon Sep 17 00:00:00 2001
From: FrondEnt <sixhotcats@gmail.com>
Date: Fri, 30 Jan 2026 00:25:30 +0200
Subject: [PATCH] README: proxy auth guide

---
 README.md | 35 +++++++++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)

diff --git a/README.md b/README.md
index 0a89792..8106da0 100644
--- a/README.md
+++ b/README.md
@@ -135,6 +135,41 @@ REM or
 set ALL_PROXY=socks5://127.0.0.1:1080
 ```
 
+#### Proxy with username + password (simple guide)
+
+1) Take your proxy host and port (example: `1.2.3.4:8080`).
+
+2) Add your login and password in the URL:
+
+- HTTP/HTTPS proxy:
+  - `http://USERNAME:PASSWORD@HOST:PORT`
+- SOCKS5 proxy:
+  - `socks5://USERNAME:PASSWORD@HOST:PORT`
+
+3) Set it in the terminal and run the bot.
+
+PowerShell:
+
+```powershell
+$env:HTTPS_PROXY = "http://USERNAME:PASSWORD@HOST:PORT"
+npm start
+```
+
+CMD:
+
+```cmd
+set HTTPS_PROXY=http://USERNAME:PASSWORD@HOST:PORT
+npm start
+```
+
+Important: if your password contains special characters like `@` or `:` you must URL-encode it.
+
+Example:
+
+- password: `p@ss:word`
+- encoded: `p%40ss%3Aword`
+- proxy URL: `http://user:p%40ss%3Aword@1.2.3.4:8080`
+
 ## Run
 
 ```bash