HD MEDIA - app-youtube-auto

File excel mau:
https://docs.google.com/spreadsheets/d/1OKfnIeRQHtf-mwJP7G5IXjUDrx_6TM9T/edit?gid=1183377579#gid=1183377579

**youtube_auto** giúp bạn nuôi và vận hành nhiều kênh YouTube cùng lúc trên GPM Login mà không cần thao tác tay. Bạn chuẩn bị 1 file Excel (mỗi dòng là 1 profile/kênh), bật các chức năng cần dùng trên giao diện, rồi cho chạy hàng loạt.

Điểm mạnh:

- **Giống người thật (chống phát hiện):** trước khi bấm luôn đưa chuột tới đúng vị trí; xem video theo **% thời lượng ngẫu nhiên**; cuộn trang, dừng xem, rê chuột tới video bên cạnh / bình luận, thỉnh thoảng tua đi tua lại; video **LIVE** tự giới hạn xem 5–10 phút (không xem vô tận).

- **An toàn:** chỉ chạy khi profile đã đăng nhập (chưa đăng nhập thì bỏ qua, không làm gì); chỉ di chuột tới phần tử thật sự thấy được; các bước phụ thuộc trạng thái đều có kiểm tra "có thì làm, không thì bỏ qua" nên ít gãy.

- **Linh hoạt:** mỗi chức năng lớn có công tắc riêng + thông số riêng (số video, %, ngưỡng like…). Chế độ upload chọn bằng combobox (riêng tư / hẹn giờ / công khai / nháp).

- **Đa dạng nguồn tìm kiếm:** tìm video qua **ô tìm kiếm YouTube** hoặc qua **Google.com** (2 cột từ khoá riêng).

- **Quản lý kênh:** đăng bài Cộng đồng, **bình luận + ghim** vào video công khai gần nhất, **công khai** các video đang hẹn giờ/nháp, và **lướt YouTube Studio** (xem mục, số liệu phân tích, bình luận, bài đăng) như chủ kênh.

> Lưu ý: cần máy Windows có cài **GPM Login**. Mỗi profile nên có proxy riêng và **đã đăng nhập YouTube** sẵn.

---

## 📊 FILE EXCEL — CÁC CỘT

Mỗi **dòng = 1 profile**. Dòng 1 là tiêu đề, dữ liệu từ dòng 2. Cột **A → M** bạn nhập; cột **N, O, P** tool tự ghi kết quả.

| Cột | Tên | Bắt buộc? | Nội dung / Ví dụ |

|----|-----|-----------|------------------|

| **A** | profile_name | ✅ (khoá map) | Tên profile trong GPM (phải trùng). Vd `profile_01` |

| **B** | video_path | Khi upload | Đường dẫn video trên máy chạy. Vd `C:\videos\clip01.mp4` |

| **C** | thumbnail_path | Tuỳ chọn | Ảnh thumbnail. Vd `C:\videos\thumb01.jpg` |

| **D** | title | Khi upload | Tiêu đề video |

| **E** | description | Khi upload | Mô tả video |

| **F** | tags | Tuỳ chọn | Thẻ tag, cách nhau dấu phẩy. Vd `nhac, lofi, chill` |

| **G** | post_content | Khi đăng post | Nội dung bài Cộng đồng |

| **H** | country | Tuỳ chọn | Quốc gia khi đặt vị trí video. Vd `Vietnam` |

| **I** | public_date | Khi hẹn giờ | Ngày công khai `MM/DD/YYYY`. Để định dạng **Text** hoặc Date đều được (tool tự xử lý). Vd `06/20/2026` |

| **J** | public_time | Khi hẹn giờ | Giờ công khai. Vd `8:00 PM` |

| **K** | youtube_keyword | Khi tìm trên YouTube | Từ khoá tìm; nhiều từ cách nhau bởi `\|`. Vd `nhạc chill \| lofi` |

| **L** | google_keyword | Khi tìm qua Google | Từ khoá tìm trên Google; cách nhau `\|`. Vd `review phim hay \| top phim` |

| **M** | pin_comment | Khi bình luận/ghim | Nội dung bình luận sẽ đăng/ghim. Vd `Cảm ơn mọi người đã xem!` |

| **N** | (kết quả) Draft | — | Tool tự ghi khi lưu nháp |

| **O** | (kết quả) PUBLISHED_OK | — | Tool tự ghi khi công khai xong |

| **P** | (kết quả) link | — | Tool tự ghi link video vừa public |

> File mẫu kèm theo: `youtube_auto.xlsx` (có sẵn dòng ví dụ).

---

## 🎛️ CÁC CHỨC NĂNG & CÔNG TẮC (màn “Input from application”)

Mặc định **tất cả đều BẬT**. Bỏ tick những gì không cần. Combobox/ô số giữ nguyên hoặc chỉnh theo ý.

### ⚙️ Cài đặt xem chung

| Ô | Ý nghĩa | Mặc định |

|---|---------|----------|

| `watch_percent_min` / `watch_percent_max` | Xem mỗi video theo **% thời lượng ngẫu nhiên** trong khoảng này | 2 → 30 (%) |

### ▶️ Xem video trang chủ

| Ô | Ý nghĩa | Mặc định |

|---|---------|----------|

| `do_watch_home` | Bật xem video ở trang chủ | BẬT |

| `home_watch_min` / `home_watch_max` | Số video trang chủ sẽ xem (ngẫu nhiên trong khoảng) | 1 → 3 |

### 🔎 Xem video tìm kiếm

| Ô | Ý nghĩa | Mặc định |

|---|---------|----------|

| `do_watch_search` | Bật xem video theo từ khoá | BẬT |

| `enable_youtube_keyword_search` | Tìm bằng **ô tìm kiếm YouTube** (từ khoá **cột K**) | BẬT |

| `enable_google_keyword_search` | Tìm qua **Google.com** rồi mở video YouTube (từ khoá **cột L**) | BẬT |

| `search_watch_min` / `search_watch_max` | Số video tìm kiếm sẽ xem | 1 → 3 |

### 👍 Tương tác video (chạy ngẫu nhiên trong lúc xem)

| Ô | Ý nghĩa | Mặc định |

|---|---------|----------|

| `do_like` | Thích video | BẬT |

| `do_subscribe` | Đăng ký kênh | BẬT |

| `do_save_playlist` | Lưu video vào playlist (xem sau) | BẬT |

| `do_share_copy` | Chia sẻ / sao chép link video | BẬT |

### 💬 Bình luận

| Ô | Ý nghĩa | Mặc định |

|---|---------|----------|

| `do_comment_read` | Đọc bình luận (di chuột tới, dừng, cuộn) | BẬT |

| `do_comment_like` | Like bình luận — **chỉ like comment có > X like** | BẬT |

| `comment_like_min_likes` | Ngưỡng **X** like | 100 |

### ⬆️ Upload video

| Ô | Ý nghĩa | Mặc định |

|---|---------|----------|

| `do_upload` | Bật upload video (đọc B,C,D,E,F,H…) | BẬT |

| `upload_mode` | **Combobox** chế độ: `private` (riêng tư) / `scheduled` (hẹn giờ — đọc cột I,J) / `public` (công khai) / `draft` (lưu nháp) | private |

### 🌐 Công khai video (cho video upload TRƯỚC đó)

| Ô | Ý nghĩa | Mặc định |

|---|---------|----------|

| `do_make_public` | Vào kênh **công khai video đang HẸN GIỜ (ưu tiên)**, nếu không có thì video **nháp**. Dùng cho video bạn đã upload riêng tư/hẹn giờ ở lần trước | BẬT |

> ⚠️ Vì mặc định BẬT, mỗi lần chạy nó sẽ công khai 1 video. Nếu chỉ dùng khi cần, hãy **tắt** ô này. *(Hiện chưa xử lý video Riêng tư/Không công khai — nếu cần báo người làm tool.)*

### 📝 Đăng bài & Bình luận-Ghim

| Ô | Ý nghĩa | Mặc định |

|---|---------|----------|

| `do_post` | Đăng bài lên trang **Cộng đồng** (nội dung **cột G**, tự gắn link video mới nhất nếu có) | BẬT |

| `do_pin_comment` | **Bình luận + ghim ĐỘC LẬP**: vào **video CÔNG KHAI gần nhất** của kênh → đăng bình luận (**cột M**) → ghim nếu được | BẬT |

### 📈 Lướt YouTube Studio (như chủ kênh)

| Ô | Ý nghĩa | Mặc định |

|---|---------|----------|

| `do_studio_browse` | Mở Studio, lướt qua các mục | BẬT |

| `studio_view_analytics` | Xem **Số liệu phân tích** (+ tab Nội dung/Đối tượng) | BẬT |

| `studio_view_comments` | Xem **Bình luận** (rê đọc 1 bình luận) | BẬT |

| `studio_view_posts` | Xem tab **Bài đăng của người xem** | BẬT |

---

## ▶️ CÁCH CHẠY (máy Windows có GPM Login)

1. **Import app** vào GPM Automate: chọn thư mục `youtube_auto/` (gồm `src.gscript`, `src.gpmconfig`, `info.gpmsln`, `logo.ico`).

2. **Chuẩn bị Excel** theo bảng cột ở trên. Lưu ý cột **A** (profile_name) phải trùng tên profile trong GPM.

3. Trong app → tab **“Input from application”**: tích/bỏ tích chức năng, nhập % / số video / ngưỡng like, chọn `upload_mode`.

4. Trong **Run Configuration**: chọn số luồng, **bật “Use virtual mouse”** (xem chuột chạy), và **“Do not close profile on error”** (để xem lỗi nếu có).

5. **Test trước 1 profile + 1–2 dòng**, bật **từng chức năng một** (chỉ home → chỉ search → chỉ upload từng chế độ → post → bình luận…) rồi mới chạy hàng loạt.

---

## ⚠️ LƯU Ý QUAN TRỌNG

- **Profile phải đăng nhập YouTube sẵn.** Chưa đăng nhập → tool bỏ qua, không làm gì (an toàn).

- **Bình luận bị tắt:** nếu video/kênh **tắt tính năng bình luận** thì không đăng được bình luận (YouTube chặn) — tool tự bỏ qua, không lỗi. Muốn bình luận chạy: vào **Studio → Cài đặt → Cộng đồng → Mặc định → “Bình luận trên video mới” = Cho phép tất cả**, và đảm bảo video **không** bị gắn “Dành cho trẻ em”.

- **Mỗi profile = 1 dòng Excel**, khớp bằng cột A.

- **upload_mode = scheduled** mới dùng cột I (ngày) + J (giờ).

- **`do_make_public` đang mặc định BẬT** → công khai 1 video mỗi lần chạy; tắt nếu không cần.

- Video **đặt private** mà gắn link vào bài Post sẽ hiện “video riêng tư” với người xem — muốn xem được thì để chế độ **public/scheduled**.

- Mac **không chạy** GPM — chỉ chạy trên Windows có GPM Login.