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.
---
## Requirements 📦
- Python **3.11.10** 🐍
@@ -10,17 +12,21 @@ This script automates the process of deleting videos from your YouTube "Watch La
## Setup & Usage (English) 🇬🇧
### ⚙️ Requirements
- Python **3.11.10** 🐍
### 1⃣ Create a Virtual Environment
**With `venv`:**
```bash
python -m venv venv
python3.11 -m venv venv
```
**With `virtualenv`:**
```bash
python -m pip install virtualenv
python -m virtualenv venv
python3.11 -m pip install virtualenv
python3.11 -m virtualenv venv
```
### 2⃣ Activate the Virtual Environment
@@ -48,17 +54,41 @@ python script.py
---
## Instructions (English) 🇬🇧
## Features & 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).
### Features
### ⏱️ 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.
- 🖼️ **Image Recognition:**
Uses screenshots in the `img` folder to locate and interact with UI elements (browser icon, YouTube buttons, etc).
### ▶️ Run the Script
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.
Execute the script and follow the on-screen instructions. Press `q` at any time to stop the script.
- 🔍 **Region-based Search:**
The script splits the screen into left and right halves to speed up image searches.
- 🗂️ **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.
---
## Requisitos 📦
- 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) 🇪🇸
### ⚙️ Requisitos
- Python **3.11.10** 🐍
### 1⃣ Crear un Entorno Virtual
**Con `venv`:**
```bash
python -m venv venv
python3.11 -m venv venv
```
**Con `virtualenv`:**
```bash
python -m pip install virtualenv
python -m virtualenv venv
python3.11 -m pip install virtualenv
python3.11 -m virtualenv venv
```
### 2⃣ Activar el Entorno Virtual
@@ -112,14 +148,38 @@ python script.py
---
## Instrucciones (Español) 🇪🇸
## Funcionalidades y 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).
### Funcionalidades
### ⏱️ 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.
- 🖼️ **Reconocimiento de Imágenes:**
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
Para que el script funcione, es indispensable que tengas tu navegador anclado a tu barra de tareas, sino no podrá encontrar el icono.
Ejecuta el script y sigue las instrucciones en pantalla. Presiona `q` en cualquier momento si quieres detenerlo.
- 🔍 **Búsqueda por Regiones:**
El script divide la pantalla en mitades izquierda y derecha para acelerar la búsqueda de imágenes.
- 🗂️ **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.