Updated README.md

Updated README.md with description of first public and completed version of this project, v1.2

Author: D4vRAM369

README.md

@@ -2,63 +2,145 @@
 
 ![NowPlayingExporterPy (1)](https://github.com/user-attachments/assets/162df03c-33f2-4275-89f1-eebd064d7c77)
 
+Exporta el historial de **Now Playing / Está sonando** (Android System Intelligence, ASI) de dispositivos Google Pixel a **CSV**, e incorpora una función para **descargar las canciones** listadas en ese historial (vía `yt-dlp`) al almacenamiento de la app. Pensada y construida como proyecto de **Aprendizaje Basado en Proyectos (PBL)**. 
 
-Exporta el historial de **Now Playing / Está sonando** (Android System Intelligence) de los dispositivos Google Pixel a **CSV** directamente desde Android.  
-Incluye **deduplicación opcional** (por intervalos de tiempo) para eliminar líneas repetidas y un botón para **compartir** el CSV generado.
-
-> **Requiere root.** La base de datos de ASI es privada del sistema y no es accesible sin privilegios elevados (root). Por tanto asegurate de concederle permisos de superusuario en Magisk, KSU o aPatch a la aplicación antes de usarla, y reinicia el móvil, de lo contrario te dará error.
+> **⚠️ Requiere root.** La base de datos de ASI es privada del sistema. Concede permisos de superusuario (Magisk / KernelSU / aPatch) antes de usarla. Para explorar los ficheros resultantes puede hacer falta un gestor con root.
 
 ---
 
 ## Características
-- ✅ Exportación a **CSV** en `Descargas` (vía MediaStore).
-- ✅ **Deduplicación** por ventanas de tiempo (p. ej., 10 min).
-- ✅ **Compartir** el CSV desde la app.
-- ✅ UI Material minimalista, modo oscuro.
-- ✅ Reutiliza scripts Python (Chaquopy) para la lógica de export/dedupe.
+
+* ✅ Exportación a **CSV** del historial “Está Sonando”.
+* ✅ **Deduplicación** inteligente (ventanas de tiempo) para limpiar duplicados y “falsos repetidos”.
+* ✅ **Descarga de canciones** desde el CSV con `yt-dlp` al directorio privado de la app (no necesita permisos de almacenamiento).
+* ✅ UI minimalista con feedback de progreso en tiempo real. 
+
+---
+
+## Rutas y formatos
+
+* **DB de ASI** (ejemplos habituales):
+
+  ```
+  /data/data/com.google.android.as/databases/history_db
+  /data/user_de/0/com.google.android.as/databases/history_db
+  /data/data/com.google.android.as.oss/databases/history_db
+  ```
+* **Salida CSV**: en `Descargas` (MediaStore) con nombre `now_playing_export_YYYYMMDD_HHMMSS[_dedup].csv`.
+* **Descargas de audio** (con `yt-dlp`):
+
+  ```
+  /Android/data/com.d4vram.nowplayingexporterpy/files/Music/NPEpy_download_songs/
+  ```
+
+  Formato típico: `.webm` (sin post-procesado FFmpeg). Para escucharlas en tu reproductor, **mueve/copialas** a `/sdcard/Music/`. 
 
 ---
 
 ## Cómo funciona (resumen técnico)
-1. **Root** (libsu) copia la base de datos privada de ASI (`history_db`) a la sandbox de la app.
-   - Rutas candidatas (ejemplos):  
-     ```
-     /data/data/com.google.android.as/databases/history_db
-     /data/user_de/0/com.google.android.as/databases/history_db
-     /data/data/com.google.android.as.oss/databases/history_db
-     ...
-     ```
-2. **Chaquopy** ejecuta `np_export.py` para leer SQLite y generar el **CSV** temporal.
-3. (Opcional) `np_dedupe.py` aplica **deduplicación** por tiempo (**recomendada** para evitar múltiples líneas repetidas que salen incluso sin corresponderse a las veces que fueron reproducidas, por el momento desconozco cual es el error por el que ocurre esto).
-4. La app mueve el CSV final a **Descargas** con nombre `now_playing_export_YYYYMMDD_HHMMSS[_dedup].csv`.
-5. Botón/acción para **compartir** el CSV (intent estándar).
+
+1. **Root (libsu)** copia `history_db` de ASI a la sandbox de la app.
+2. **Chaquopy (Python)** ejecuta `np_export.py` para leer SQLite y generar el **CSV** temporal.
+3. (Opcional) `np_dedupe.py` aplica **deduplicación** por ventana temporal.
+4. La app guarda el CSV final en **Descargas** y ofrece **compartir** por intent estándar.
+5. Con el CSV listo, **`yt-dlp`** busca y descarga los audios a la carpeta privada de la app. 
 
 ---
 
 ## Requisitos
-- Probado en Andorid 16 en Pixel usando KernelSU Next con ASI → ✅ funciona.
-- Esperado (no verificado): Android 12–15 en Pixel con ASI debería funcionar (las rutas de la DB suelen ser alguna de estas, previamente mencionadas en el punto 1:
 
-    /data/data/com.google.android.as/databases/history_db,
-    /data/user_de/0/com.google.android.as/databases/history_db,
-    /data/data/com.google.android.as.oss/databases/history_db),
+* **Root** (Magisk / KernelSU Next / aPatch).
+* **ASI** instalado (Android System Intelligence).
+* Probado en **Android 16** (Pixel con KernelSU Next). Se espera compatibilidad Android **12–15** en Pixel (no garantizada). 
+
+---
+
+## Lecciones aprendidas (problemas → soluciones)
+
+1. **FFmpeg & `yt-dlp`**: Chaquopy no aporta FFmpeg vía pip. `yt-dlp` puede bajar audio nativo (`.webm`) **sin FFmpeg**, así que se eliminó la falsa dependencia y se configuró “best audio”.
+2. **Progreso en tiempo real**: se añadió una interfaz `PythonCallback` desde Kotlin para recibir logs/estado del script Python y mostrarlos en la UI.
+3. **DNS / red intermitente**: además de declarar `android.permission.INTERNET`, se implementaron **reintentos** con pausas y “pausa larga” tras N descargas.
+4. **Scoped Storage (API 29+)**: escribir en `Music` público da `Operation not permitted`. Solución: **usar almacenamiento privado de la app** en `/Android/data/.../files/` (no requiere permisos en Android 10+). 
+
+---
+
+## Uso
+
+1. **Instala** el APK.
+2. **Concede root** cuando te lo pida.
+3. Pulsa **Exportar** para generar el CSV del historial.
+4. (Opcional, recomendado) Activa **Deduplicar**.
+5. Pulsa **Descargar canciones** para poblar `NPEpy_download_songs/`. 
+
+> **Tip importante para buena legibilidad**: abrir el CSV en hojas de cálculo sin romper columnas
+
+
+    >   Para que no te “trocee” los títulos por espacios, toca exactamente esto:
+    
+    En Opciones de separador
+
+    ✅ Coma
 
-   pero no garantizado. 
+    ⛔ Espacio → DESMARCA
+    
+    ⛔ Punto y coma → DESMARCA
 
-- **Root** (Magisk, KernelSU/KSU Next, aPatch) y permisos a la apk.
-- Android System Intelligence (o equivalente) instalado.
+    ⛔ Tabulador → DESMARCA (déjalo solo si tu archivo lleva tabs)
 
+    En Delimitador de cadena → elige " (comillas dobles).
+
+    Conjunto de caracteres → Unicode (UTF-8) (como ya tienes).
+
+    (Recomendado) En la vista previa, haz clic en el encabezado de la columna timestamp_iso (y cualquier otra de tiempo) y en Tipo de columna pon Texto para que no te lo reinterprete como fecha rara.
+
+    Luego pulsa Aceptar.
+    Con eso la vista previa debe pasar de palabras sueltas en mil columnas a columnas limpias: artist | title | timestamp_iso | ...
+
+    👉 Si aun así ves todo roto, abre el archivo en un editor y mira el separador real:
+
+    Si ves ; entre campos, importa marcando Punto y coma (y desmarcando lo demás).
+
+    Si ves ,, usa Coma como arriba.
+
+---
+
+## Arquitectura y tecnologías
+
+* **Kotlin (Android)**: UI + lógica principal.
+* **Chaquopy (Python)**: ejecución de scripts (`np_export.py`, `np_dedupe.py`, `np_download.py`).
+* **`yt-dlp`**: búsqueda/descarga de audio.
+* **`libsu`**: operaciones root.
+* **SQLite**: base de datos de ASI.
+* **Scoped Storage**: políticas de acceso en Android 10+. 
 
 ---
 
 ## Compilación
-### Opción Android Studio
-- Abrir el proyecto.
-- **Build > Make Project** o **Run**.
 
-### Opción CLI
+### Android Studio
+
+* Abre el proyecto y **Sync**.
+* **Build > Make Project** o **Run**.
+
+### CLI
+
 ```bash
+git clone <URL_DEL_REPOSITORIO>
+cd NowPlayingExporterPy
 ./gradlew :app:assembleDebug
-# o
-./gradlew :app:assembleRelease
+# APK en: app/build/outputs/apk/debug/app-debug.apk
+```
+
+
+
+---
 
+## Contribuciones
+
+¡Bienvenidas! Abre un *issue* o un *pull request* con tu propuesta.&#x20;
+
+## Licencia
+
+**GPL-3.0**. Consulta el archivo `LICENSE` para más detalles.&#x20;
+
+---