From 67f4cad5f3bc390e87758f174633b5bae1618533 Mon Sep 17 00:00:00 2001
From: Marco Gallegos <marco.gallegos@outlook.com>
Date: Fri, 21 Nov 2025 08:31:53 -0600
Subject: [PATCH] refactor: rename yt-dlp download directories and update
 associated scripts and help messages.

---
 .zshrc.example  | 41 ++++++++++++++++++++++++-----------------
 readme.md       |  2 +-
 vanity_setup.sh |  5 +++--
 3 files changed, 28 insertions(+), 20 deletions(-)

diff --git a/.zshrc.example b/.zshrc.example
index 7e2e4c6..4eb9f4c 100644
--- a/.zshrc.example
+++ b/.zshrc.example
@@ -184,22 +184,24 @@ killport() {
 serve() { python -m http.server "${1:-8000}"; }
 
 # --- yt-dlp ---------------------------------------------------------------
-export YTDLP_DIR="$HOME/videos/youtube"
-mkdir -p "$YTDLP_DIR"/{audio,video} >/dev/null 2>&1
+export YTDLP_VIDEO_DIR="$HOME/Movies/Youtube"
+export YTDLP_AUDIO_DIR="$HOME/Music/Youtube"
+mkdir -p "$YTDLP_VIDEO_DIR" "$YTDLP_AUDIO_DIR" >/dev/null 2>&1
 
 ytm() {
   if [[ -z "$1" || "$1" == "-h" || "$1" == "--help" ]]; then
-    echo "Uso: ytm <url|busqueda> - Descarga audio MP3 en $YTDLP_DIR/audio"
+    echo "Uso: ytm <url|busqueda> - Descarga audio MP3 en $YTDLP_AUDIO_DIR (calidad maxima)."
     return 0
   fi
   yt-dlp -f bestaudio --extract-audio --audio-format mp3 --audio-quality 0 \
     --embed-metadata --embed-thumbnail \
-    -o "$YTDLP_DIR/audio/%(title).180s.%(ext)s" "$1"
+    -o "$YTDLP_AUDIO_DIR/%(title).180s.%(ext)s" "$1"
 }
 
 ytv() {
   if [[ -z "$1" ]]; then
-    echo "Uso: ytv <url|busqueda> [1080|720|480]" && return 1
+    echo "Uso: ytv <url|busqueda> [1080|720|480|best] - Descarga video MP4 en $YTDLP_VIDEO_DIR."
+    return 1
   fi
   local quality="${2:-best}"
   local fmt
@@ -210,14 +212,14 @@ ytv() {
     *) fmt='bv*[ext=mp4]+ba/b[ext=mp4]/b' ;;
   esac
   yt-dlp -f "$fmt" --embed-subs --embed-metadata --embed-thumbnail \
-    -o "$YTDLP_DIR/video/%(title).180s.%(ext)s" "$1"
+    -o "$YTDLP_VIDEO_DIR/%(title).180s.%(ext)s" "$1"
 }
 
 ytls() {
-  echo "Audios recientes:"
-  ls -1t "$YTDLP_DIR/audio" 2>/dev/null | head -5 | sed 's/^/  /' || echo "  (vacio)"
-  echo "Videos recientes:"
-  ls -1t "$YTDLP_DIR/video" 2>/dev/null | head -5 | sed 's/^/  /' || echo "  (vacio)"
+  echo "Audios recientes ($YTDLP_AUDIO_DIR):"
+  ls -1t "$YTDLP_AUDIO_DIR" 2>/dev/null | head -5 | sed 's/^/  /' || echo "  (vacio)"
+  echo "Videos recientes ($YTDLP_VIDEO_DIR):"
+  ls -1t "$YTDLP_VIDEO_DIR" 2>/dev/null | head -5 | sed 's/^/  /' || echo "  (vacio)"
 }
 
 # --- SSH Agent ------------------------------------------------------------
@@ -266,14 +268,19 @@ fi
 
 # --- Ayuda rapida ---------------------------------------------------------
 vanity_help() {
-  cat <<EOF
-Comandos claves:
-  ytv / ytm / ytls - Descargas con yt-dlp
-  venv create/on/off - Manejo rapido de entornos Python
-  mkcd / extract / killport / serve - Utilidades basicas
-  reload          - Recarga este archivo
+  cat <<'EOF'
+Vanity CLI — comandos principales:
+  ytv <url> [calidad]    Descarga videos en ~/Movies/Youtube (calidad: best/1080/720/480).
+  ytm <url>              Extrae audio MP3 a ~/Music/Youtube con metadatos y caratula.
+  ytls                   Lista los ultimos archivos descargados por ytv/ytm.
+  venv create|on|off     Simplifica la creacion y activacion de entornos Python (.venv).
+  mkcd <ruta>            Crea un directorio y cambia a el en un paso.
+  extract <archivo>      Descomprime en el formato correcto automaticamente.
+  killport <puerto>      Mata cualquier proceso que use el puerto indicado.
+  serve [puerto]         Sirve la carpeta actual via HTTP (por defecto 8000).
+  reload                 Recarga la configuracion actual (~/.zshrc).
 EOF
 }
 alias help='vanity_help'
 
-echo "[Vanity Shell] Ejecuta 'help' para ver los comandos principales."
+echo "Vanity CLI | 'help' sirve para ver los comandos."
diff --git a/readme.md b/readme.md
index 34b67d9..2e069b6 100644
--- a/readme.md
+++ b/readme.md
@@ -54,7 +54,7 @@ Cada ejecución genera un registro detallado en `.logs/vanity-YYYYmmdd-HHMMSS.lo
 - Instala los plugins necesarios y refresca sus repositorios si ya existen.
 - Coloca el tema Catppuccin en `~/.poshthemes` y activa Oh My Posh automáticamente.
 - Copia `source ~/.zshrc` al portapapeles para que puedas recargar la shell al finalizar.
-- Genera los directorios `~/videos/youtube` y `~/musica/youtube` y define alias listos para descargar con `ytv <url>` (video completo) y `ytm <url>` (solo audio MP3).
+- Genera los directorios `~/Movies/Youtube` y `~/Music/Youtube` y define alias listos para descargar con `ytv <url>` (video completo) y `ytm <url>` (solo audio MP3).
 - Añade un comando `help` dentro de Zsh que describe el uso de estos alias.
 - Cambia la fuente predeterminada de la app Terminal a *MesloLGS Nerd Font* (tamaño 14) para que los iconos de Oh My Posh se vean bien desde el primer arranque.
 
diff --git a/vanity_setup.sh b/vanity_setup.sh
index f03a9c3..b4013a9 100644
--- a/vanity_setup.sh
+++ b/vanity_setup.sh
@@ -117,7 +117,7 @@ install_cli_dependencies() {
 }
 
 setup_media_dirs() {
-  mkdir -p "$HOME/videos/youtube" "$HOME/musica/youtube"
+  mkdir -p "$HOME/Movies/Youtube" "$HOME/Music/Youtube"
 }
 
 configure_terminal_font() {
@@ -339,7 +339,7 @@ main_menu() {
   echo " Q) Salir"
   echo ""
   local choice=""
-  if read_menu_choice "Opción [A/C/D/Q]: "; then
+  if read_menu_choice "Opción [A/C/D/U/Q]: "; then
     choice="$REPLY"
   else
     echo "No se detecta una entrada interactiva; se seleccionará la opción 'A' por defecto."
@@ -396,3 +396,4 @@ echo "source ~/.zshrc"
 echo ""
 wait_for_enter "Presiona Enter una vez hayas ejecutado el comando anterior en tu terminal… "
 echo "Reinicia tu Mac para asegurarte de que todas las herramientas queden listas para el próximo arranque."
+echo "Vanity CLI | 'help' sirve para ver los comandos."