update readme

This commit is contained in:
Emi
2025-07-07 17:45:28 -03:00
parent 35af328224
commit d16d80f04b

104
README.md
View File

@@ -2,6 +2,8 @@
This script automates the process of deleting videos from your YouTube "Watch Later" playlist using PyAutoGUI. This script automates the process of deleting videos from your YouTube "Watch Later" playlist using PyAutoGUI.
---
## Requirements 📦 ## Requirements 📦
- Python **3.11.10** 🐍 - Python **3.11.10** 🐍
@@ -10,17 +12,21 @@ This script automates the process of deleting videos from your YouTube "Watch La
## Setup & Usage (English) 🇬🇧 ## Setup & Usage (English) 🇬🇧
### ⚙️ Requirements
- Python **3.11.10** 🐍
### 1⃣ Create a Virtual Environment ### 1⃣ Create a Virtual Environment
**With `venv`:** **With `venv`:**
```bash ```bash
python -m venv venv python3.11 -m venv venv
``` ```
**With `virtualenv`:** **With `virtualenv`:**
```bash ```bash
python -m pip install virtualenv python3.11 -m pip install virtualenv
python -m virtualenv venv python3.11 -m virtualenv venv
``` ```
### 2⃣ Activate the Virtual Environment ### 2⃣ Activate the Virtual Environment
@@ -48,17 +54,41 @@ python script.py
--- ---
## Instructions (English) 🇬🇧 ## Features & Customization 🛠️
### 🖼️ Browser Image ### Features
Replace the browser icon image in the `img` folder with a screenshot of your browser's icon. Make sure the filename matches the value of the `browser_img` variable in `script.py` (e.g., `brave.png` for Brave browser).
### ⏱️ Adjust Timing - 🖼️ **Image Recognition:**
The script uses `sleep` and `duration` values to wait for your PC to respond. You may need to increase or decrease these values depending on your computer's speed and internet connection. Uses screenshots in the `img` folder to locate and interact with UI elements (browser icon, YouTube buttons, etc).
### ▶️ Run the Script - 🔍 **Region-based Search:**
For the script to work, it is essential that you have your browser pinned to your taskbar, otherwise you will not be able to find the icon. The script splits the screen into left and right halves to speed up image searches.
Execute the script and follow the on-screen instructions. Press `q` at any time to stop the script.
- 🗂️ **Automatic Tab Handling:**
Automatically opens/closes tabs and navigates to your "Watch Later" playlist.
- ⏱️ **Timing Controls:**
You can adjust `sleep` and `duration` values in the code to match your PC's speed.
- 🛑 **Hotkey Listener:**
Press `q` at any time to safely stop the script.
- 🖱️ **Easy Customization:**
Change the images in the `img` folder or tweak the logic in functions like `locate_img` and `change_to_not_available` to adapt to UI changes or other platforms.
### Customization
- 🖼️ **Browser Image:**
Replace the browser icon image in the `img` folder with a screenshot of your browser's icon. Make sure the filename matches the value of the `browser_img` variable in `script.py` (e.g., `brave.png` for Brave browser).
- 🔗 **Playlist URL:**
You can change the playlist URL by editing the value of the `playlist_url` variable at the top of the `script.py` file.
- ⏱️ **Adjust Timing:**
The script uses `sleep` and `duration` values to wait for your PC to respond. You may need to increase or decrease these values depending on your computer's speed and internet connection.
- 📌 **Pin Your Browser:**
For the script to work, your browser must be pinned to your taskbar.
--- ---
@@ -66,6 +96,8 @@ Execute the script and follow the on-screen instructions. Press `q` at any time
Este script automatiza el proceso de eliminar videos de tu lista de "Ver más tarde" en YouTube usando PyAutoGUI. Este script automatiza el proceso de eliminar videos de tu lista de "Ver más tarde" en YouTube usando PyAutoGUI.
---
## Requisitos 📦 ## Requisitos 📦
- Python **3.11.10** 🐍 - Python **3.11.10** 🐍
@@ -74,17 +106,21 @@ Este script automatiza el proceso de eliminar videos de tu lista de "Ver más ta
## Configuración y Uso (Español) 🇪🇸 ## Configuración y Uso (Español) 🇪🇸
### ⚙️ Requisitos
- Python **3.11.10** 🐍
### 1⃣ Crear un Entorno Virtual ### 1⃣ Crear un Entorno Virtual
**Con `venv`:** **Con `venv`:**
```bash ```bash
python -m venv venv python3.11 -m venv venv
``` ```
**Con `virtualenv`:** **Con `virtualenv`:**
```bash ```bash
python -m pip install virtualenv python3.11 -m pip install virtualenv
python -m virtualenv venv python3.11 -m virtualenv venv
``` ```
### 2⃣ Activar el Entorno Virtual ### 2⃣ Activar el Entorno Virtual
@@ -112,14 +148,38 @@ python script.py
--- ---
## Instrucciones (Español) 🇪🇸 ## Funcionalidades y Personalización 🛠️
### 🖼️ Imagen del Navegador ### Funcionalidades
Reemplaza la imagen del icono de tu navegador en la carpeta `img` con una captura de pantalla del icono de tu navegador. Asegúrate de que el nombre del archivo coincida con el valor de la variable `browser_img` en `script.py` (por ejemplo, `brave.png` para el navegador Brave).
### ⏱️ Ajusta los Tiempos - 🖼️ **Reconocimiento de Imágenes:**
El script utiliza valores de `sleep` y `duration` para esperar la respuesta de tu PC. Puede que necesites aumentar o disminuir estos valores dependiendo de la velocidad de tu computadora y conexión a internet. Usa capturas en la carpeta `img` para localizar e interactuar con elementos de la interfaz (icono del navegador, botones de YouTube, etc).
### ▶️ Ejecuta el Script - 🔍 **Búsqueda por Regiones:**
Para que el script funcione, es indispensable que tengas tu navegador anclado a tu barra de tareas, sino no podrá encontrar el icono. El script divide la pantalla en mitades izquierda y derecha para acelerar la búsqueda de imágenes.
Ejecuta el script y sigue las instrucciones en pantalla. Presiona `q` en cualquier momento si quieres detenerlo.
- 🗂️ **Manejo Automático de Pestañas:**
Abre/cierra pestañas y navega automáticamente a tu lista de "Ver más tarde".
- ⏱️ **Control de Tiempos:**
Puedes ajustar los valores de `sleep` y `duration` en el código según la velocidad de tu PC.
- 🛑 **Escucha de Teclas:**
Presiona `q` en cualquier momento para detener el script de forma segura.
- 🖱️ **Fácil Personalización:**
Cambia las imágenes en la carpeta `img` o ajusta la lógica en funciones como `locate_img` y `change_to_not_available` para adaptarlo a cambios en la interfaz o a otras plataformas.
### Personalización
- 🖼️ **Imagen del Navegador:**
Reemplaza la imagen del icono de tu navegador en la carpeta `img` con una captura de pantalla del icono de tu navegador. Asegúrate de que el nombre del archivo coincida con el valor de la variable `browser_img` en `script.py` (por ejemplo, `brave.png` para el navegador Brave).
- 🔗 **URL de la Playlist:**
Puedes cambiar la URL de la playlist que se usa modificando el valor de la variable `playlist_url` al inicio del archivo `script.py`.
- ⏱️ **Ajusta los Tiempos:**
El script utiliza valores de `sleep` y `duration` para esperar la respuesta de tu PC. Puede que necesites aumentar o disminuir estos valores dependiendo de la velocidad de tu computadora y conexión a internet.
- 📌 **Ancla tu Navegador:**
Para que el script funcione, es indispensable que tengas tu navegador anclado a tu barra de tareas.