Tarjetero virtual de cobros para Android (Móvil, TV y Modo Kiosko)
100% local, centrado en la privacidad y potenciado por IA en el dispositivo.
Tarjetero virtual de cobros para Android (y Android TV). 100% local, centrado en la privacidad y potenciado por IA en el dispositivo.
PayBio guarda tus métodos de cobro (bancos, billeteras virtuales y direcciones cripto) y los muestra como tarjetas con su código QR listo para compartir — sin conexión a internet y sin servidores. La app ni siquiera solicita el permiso de Internet.
| Módulo | Descripción |
|---|---|
| 1. Ingesta Inteligente (IA local) | Sube una captura de tu app bancaria o pega texto: ML Kit (reconocimiento de texto + escaneo de QR) extrae las cadenas y un clasificador por reglas detecta el formato (Ethereum 0x..., CLABE, Yape, Pix, Nequi, etc.) para crear la tarjeta automáticamente. Puedes buscar la imagen con una app externa o con el explorador interno. |
| 2. Catálogo por País | assets/payment_catalog.json precargado con bancos, billeteras y redes blockchain (BTC, ETH, BSC, Solana, Tron) y sus patrones de validación. Además puedes crear países y plataformas personalizados y ponerle un nombre/alias, logo y QR propio a cada tarjeta. |
| 3. Modo Kiosco | Para mostradores: bloquea ediciones con un PIN de 4–6 dígitos, mantiene la pantalla encendida (anti-reposo) y fija la app en primer plano (startLockTask). Adaptable: en teléfonos muestra un menú "Medios de pago"; en TV / pantallas grandes muestra todas las tarjetas a la vez en una grilla que divide cada recuadro en info + QR grande y escala el texto automáticamente. |
| 4. Respaldo Cero-Nube | Empaqueta la base cifrada, las imágenes (QR/logos), la clave y, opcionalmente, el PIN del kiosco en un .zip. Exporta compartiéndolo (ACTION_SEND) o guardándolo en una carpeta con el explorador interno, e importa desde el selector del sistema o el explorador interno. PayBio nunca toca credenciales de nube. |
Extras: Fast-Share (comparte el QR — el personalizado si lo tiene — + datos formateados con un toque), widget de pantalla de inicio, explorador de archivos integrado (para TV sin gestor de archivos), realce de foco para navegar con control remoto y un botón de apoyo en Ko-fi.
PayBio funciona en Android TV: navegación con control remoto (D-pad) con realce de foco, Modo Kiosco en grilla que aprovecha la pantalla, y un explorador de archivos integrado para importar/exportar respaldos cuando el dispositivo no trae un gestor de archivos.
- Kotlin + Jetpack Compose (Material 3, tema oscuro AMOLED obligatorio)
- Room + SQLCipher (cifrado en reposo de datos bancarios y cripto)
- Google ML Kit (Text Recognition + Barcode Scanning) — on-device
- ZXing (generación de QR) · Coil (imágenes) · java.util.zip (respaldos)
minSdk 26·targetSdk 35·compileSdk 35
- Ve a la pestaña Releases.
- Descarga
PayBio-vX.Y.Z.apk. - En tu Android, habilita "Instalar apps de orígenes desconocidos" para tu navegador/gestor de archivos.
- Abre el
.apke instala.
El APK de Releases se firma con la clave de depuración estándar de Android para permitir la distribución abierta desde GitHub.
Requisitos: JDK 17 y Android SDK (platform 35, build-tools 35.0.0).
# APK de depuración
./gradlew :app:assembleDebug
# APK de release (instalable)
./gradlew :app:assembleRelease -PappVersionName=1.7.1 -PappVersionCode=1El APK queda en app/build/outputs/apk/.
- El versionado sigue SemVer mediante etiquetas git
vX.Y.Z. - Al hacer push de un tag
v*, el workflowrelease.ymlcompila el APK de release, lo nombraPayBio-vX.Y.Z.apky publica una GitHub Release con el APK adjunto y notas autogeneradas. - Cada push a
mainejecutaandroid-ci.yml, que compila el APK de depuración y lo sube como artifact.
# Publicar una nueva versión
git tag v1.7.1
git push origin v1.7.1 # -> Actions construye el APK y crea la ReleaseSin permiso de Internet · sin analítica · sin cuentas · sin servidores. Todo vive cifrado en tu dispositivo y solo sale de él si tú decides compartirlo.
El único permiso adicional es opcional: acceso a almacenamiento para el explorador de archivos integrado (importar/exportar respaldos en dispositivos sin gestor de archivos, como algunas TV). No se usa a menos que abras ese explorador.
PayBio es gratuito y de código abierto. Si te resulta útil, puedes apoyar el proyecto o hacer una donación:
