Documentación

AloxBook está pensado para darte una visión clara de las finanzas cotidianas con una estructura sencilla. Tus datos financieros se guardan en archivos SQLite cifrados que controlas, y la interfaz hace comprensible la partida doble incluso si estás empezando.

Resumen

AloxBook usa contabilidad por partida doble: cada transacción se mueve desde una cuenta origen hacia una cuenta destino. Esa regla sencilla te da una vista fiable de dónde vino el dinero, adónde fue y por qué cambiaron los saldos.

Instalación

Requisitos del sistema

• Windows 10 o posterior (64 bits)
• ~35 MB de espacio en disco

Instalar

1. Descarga el instalador desde la sección de descargas
2. Ejecuta AloxBook-Setup.exe
3. La app se instala para el usuario actual (sin permisos de administrador)
4. AloxBook registra la extensión .aloxbook para abrir archivos con doble clic

Alternativa por línea de comandos: winget install --id AloxBook.AloxBook -e

Si winget falla porque una fuente está desactualizada, ejecuta winget source update e inténtalo de nuevo. Si la fuente Store sigue rota, --source winget puede servir como alternativa.

Actualizaciones

AloxBook admite actualizaciones automáticas. Cuando haya una nueva versión, la app te avisará y se actualizará en segundo plano.

Actualización por línea de comandos: winget upgrade --id AloxBook.AloxBook -e

Primeros pasos

1. Crea un libro nuevo: usa Archivo → Nuevo y elige dónde vivirá tu archivo .aloxbook para que las copias de seguridad sean sencillas
2. Establece una contraseña: protege el libro cuando otras personas puedan acceder al mismo dispositivo (opcional, pero recomendable)
3. Elige una plantilla de cuentas: empieza con una estructura que puedas renombrar y adaptar después, en lugar de una lista vacía
4. Añade tus primeras transacciones: empieza con salario, alquiler, compras, transferencias u otros movimientos recurrentes

Cuentas

Las cuentas en AloxBook se organizan en un árbol jerárquico con tres categorías raíz:

• Activos: cuentas bancarias, efectivo, ahorros, préstamos, inmuebles, ...
• Ingresos: salario, intereses, dividendos, devoluciones, ...
• Gastos: alquiler, alimentación, suministros, ocio, ...

Puedes crear subcuentas en cualquier nivel. Por ejemplo, bajo Gastos podrías tener Vivienda → Alquiler, Vivienda → Suministros, etc. Los saldos se agregan hacia arriba en el árbol.

Crear una cuenta

Cambia a la pestaña Cuentas, haz clic derecho sobre una cuenta superior (o usa la barra de herramientas) y selecciona Insertar cuenta. Dale un nombre.

Transacciones

Una transacción en AloxBook siempre implica dos cuentas: el dinero fluye desde una cuenta hacia otra. Este es el principio central de la partida doble.

Ejemplos:

• Ingresos: Salario → Activos: Cuenta bancaria: recibes la nómina
• Activos: Cuenta bancaria → Gastos: Alimentación: compras comida
• Activos: Cuenta bancaria → Activos: Ahorros: transfieres a ahorros
• Ingresos: Salario → Gastos: Alimentación: pagas la comida de la cantina mediante nómina

Crear una transacción

En la pestaña Transacciones, haz clic en el icono de suma. Rellena la fecha, cuenta origen, cuenta destino, importe y texto descriptivo.

Plantillas

Las plantillas permiten guardar transacciones frecuentes para reutilizarlas rápido. Una plantilla guarda la cuenta origen, la cuenta destino, el importe y el texto descriptivo (todos opcionales).

Para crear una plantilla, ve a la pestaña Plantillas y haz clic en el icono de suma. Para aplicar una plantilla, selecciónala en la lista del diálogo "Crear nueva transacción": sus valores se rellenan automáticamente en la nueva transacción.

Importación CSV

AloxBook puede importar extractos bancarios desde archivos CSV. El sistema de importación es muy configurable:

• Los perfiles de importación se crean y guardan automáticamente después de asignarles una cuenta
• Las reglas de importación asignan automáticamente transacciones importadas a una plantilla según patrones de texto e importes
• Cada transacción importada se ve en una vista previa y puede editarse individualmente antes de guardarla
• La detección de duplicados evita importar dos veces las mismas transacciones

Configurar la importación CSV

1. Cambia a la pestaña Transacciones
2. Haz clic en el botón Importar CSV de la barra de herramientas
3. Selecciona tu archivo CSV
4. La asignación de columnas se detecta automáticamente; puedes ajustar los detalles manualmente
5. Revisa la vista previa y haz clic en Importar

Detección automática de formato

La importación CSV es intencionadamente genérica. Detecta automáticamente separador, codificación de texto, formato de fecha, separador decimal, filas de cabecera y roles de columnas, por lo que la mayoría de exportaciones de bancos y tarjetas se importan sin configuración manual. Si algo se detecta mal, puedes ajustarlo en los detalles de importación.

Formatos bancarios verificados

Los formatos siguientes se comprueban automáticamente en cada release con archivos de ejemplo reales, por lo que se sabe que se detectan directamente. Es solo una selección de lo que funciona, no una lista completa, y muchos otros bancos usan formatos muy parecidos que también se importan bien.

Exportación CSV

AloxBook puede exportar a CSV la vista de transacciones visible actualmente. La exportación sigue las mismas filas y el mismo orden que ves en la tabla, incluidos filtros y ordenación activos.

• Las primeras filas del CSV describen el filtro y la ordenación activos, para conservar el contexto
• Las fechas y los importes se formatean según la configuración regional actual
• El separador sigue la región: punto y coma para culturas con coma decimal, coma en los demás casos
• El archivo se escribe como CSV UTF-8 con marca de orden de bytes para mejorar la compatibilidad con hojas de cálculo

Exportar transacciones

1. Cambia a la pestaña Transacciones
2. Aplica el filtro u ordenación que quieras exportar
3. Haz clic en el botón Exportar CSV de la barra de herramientas
4. Elige el nombre y la ubicación del archivo de destino

Cerrar y traspasar

Si prefieres mantener un archivo por periodo financiero (por ejemplo, uno por año), la función Cerrar y traspasar lo hace sencillo:

1. Ve a Archivo → Cerrar y traspasar
2. AloxBook crea un archivo nuevo con toda tu estructura de cuentas
3. Todos los saldos de cuentas de activo se traspasan como saldos iniciales
4. Todas las plantillas se copian
5. Las cuentas de ingresos y gastos empiezan de cero
6. El archivo antiguo queda intacto y se marca como protegido contra escritura

Así tienes un inicio limpio para el nuevo periodo y conservas el historial completo en el archivo anterior.

Cifrado

Los archivos de AloxBook (.aloxbook) son bases de datos SQLite cifradas con SQLCipher. Al crear o abrir un archivo puedes establecer una contraseña; entonces toda la base de datos queda cifrada en reposo con AES-256.

Idioma y región

AloxBook está disponible en español, inglés, alemán y francés. Puedes cambiar el idioma en cualquier momento desde Ajustes; toda la interfaz se actualiza al instante sin reiniciar.

Los números y las fechas se formatean siempre según la configuración regional del sistema (por ejemplo, 1.234,56 en español o alemán frente a 1,234.56 en inglés).

Formato de archivo

AloxBook usa archivos .aloxbook: son bases de datos SQLite estándar (opcionalmente cifradas con SQLCipher). Esto significa:

• Tus datos están en un único archivo, fácil de copiar, mover o respaldar
• No hace falta ningún servicio en la nube ni base de datos externa
• SQLite mantiene los datos accesibles con otras herramientas, incluidas herramientas compatibles con SQLCipher si el archivo está cifrado y conoces la contraseña
• El formato es abierto y puede inspeccionarse con cualquier herramienta SQLite (si no está cifrado)

Solución de problemas

La app no arranca

AloxBook se compila como ejecutable nativo de Windows y debería funcionar en cualquier sistema Windows 10+ de 64 bits sin dependencias adicionales. Si la app no arranca, prueba a ejecutarla desde la línea de comandos para ver mensajes de error:

AloxBook.exe

El archivo no se abre

Si aparece un error al abrir un archivo, comprueba:

• ¿Es un archivo .aloxbook válido?
• ¿Estás introduciendo la contraseña correcta?
• ¿El archivo está protegido contra escritura? AloxBook puede abrir archivos protegidos en modo solo lectura.

Problemas al importar CSV

Si el CSV de tu banco no se importa correctamente, revisa los ajustes del perfil de importación: delimitador (coma, punto y coma, tabulador), formato de fecha, separador decimal y asignación de columnas. Puedes previsualizar los datos analizados antes de importarlos para comprobar que los ajustes son correctos.

La exportación CSV se ve distinta en una hoja de cálculo

La exportación CSV usa tu región actual para fechas, separadores decimales y delimitador CSV. Las dos primeras filas registran intencionadamente el filtro y la ordenación activos para que el archivo pueda entenderse más adelante.