SaldoSube for Alexa

Conoce el saldo de tu SUBE a través de tu dispositivo Amazon Alexa.

¿Cómo Funciona?

El programa hace uso del navegador de Playwright para automatizar el inicio de sesión en la página de SUBE. Una vez logra iniciar sesión, retorna el valor de tu saldo y se lo envía a Alexa usando alexa-remote-control, el cual es un programa que permite manejar a Alexa desde una terminal CLI.

¿Cómo usar?

Requisitos

• Python
• Setup - Alexa remote control
• Opcional - Alexa triggerCMD skill

⚠ Importante

Para que el programa funcione, tienen que haber configurado previamente Alexa remote control, siguiendo las instrucciones. Pero, básicamente, tienen que descargar el binario de Alexa Cookie CLI.

1. Ejecutar alexa-cookie-cli
2. En el navegador, ingresar a http://127.0.0.1:8080/
3. Iniciar sesión en Amazon
4. Si todo salió bien, el programa mostrará en la terminal su refresh_token (empieza con Atnr|...)

Una vez tengan el refresh_token, lo copian y pegan dentro del archivo .env.

FAQs

¿Cómo uso el script?

1. Primero tenes que clonar el repo.

git clone git@github:matefernandezcc/SaldoSube-for-Alexa.git
cd SaldoSube-for-Alexa

2. Te recomiendo que crees un venv con Python (Virtual Enviroment)

# Crear venv
python -m venv venv

# Iniciar venv
source venv/bin/activate

# Instalar dependecias
pip install -r requirements.txt

3. Ya casi esta, solo falta crear el archivo .env

# Esto dentro de la carpeta SaldoSube-for-Alexa
touch .env

Vas a ver que se creo un archivo .env ahora lo abris y le escribis lo siguiente

TOKEN='tu_token'
DNI='tu_dni'
PIN='tu_contraseña_de_sube'
GENERO='tu_genero' # reemplaza por MASCULINO FEMENINO o X (en mayuscula)

• reemplaza el Token por el que obtuviste (Leer Sección "⚠ Importante")
• reemplaza DNI y PIN por los datos que usar para iniciar sesión en la Página de sube

¿Qué es triggerCMD?

Es una skill oficial de Alexa que permite ejecutar comandos por cmd en tu PC usando comandos de voz a través de tu Alexa. Es útil para ejecutar el script directamente usando tu voz sin tener que correrlo desde la PC.

¿Cómo se configura triggerCMD?

Primero asegúrate de activar la skill conversacional de triggerCMD llamada "Ejecuta Comando". Una vez hecho eso, tienes que descargar la aplicación de escritorio para tu PC.

Ya con eso solo falta configurar qué comando quieres que se ejecute en tu compu cuando uses la skill desde Alexa.

Por ejemplo, si tu configuración en triggerCMD es así:

{
  "trigger": "saldo",
  "command": "python C:\\alexaSube\\src\\main.py",
  "offCommand": "",
  "ground": "foreground",
  "voice": "saldo",
  "voiceReply": "",
  "allowParams": "false"
}

Esto significa que al decirle a Alexa "Ejecuta comando saldo", va a ejecutar -> "python C:\alexaSube\src\main.py" en tu pc