From d16d80f04b71feee8a177f8d7c1b0902ac1f3bb0 Mon Sep 17 00:00:00 2001 From: Emi Date: Mon, 7 Jul 2025 17:45:28 -0300 Subject: [PATCH] update readme --- README.md | 104 ++++++++++++++++++++++++++++++++++++++++++------------ 1 file changed, 82 insertions(+), 22 deletions(-) diff --git a/README.md b/README.md index b5e6ea5..091bd00 100644 --- a/README.md +++ b/README.md @@ -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. \ No newline at end of file +- 🔍 **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. \ No newline at end of file