Documentazione

AloxBook è pensato per offrirti una visione chiara delle finanze quotidiane attraverso una struttura semplice. I dati vengono conservati in file SQLite crittografati sotto il tuo controllo e l'interfaccia rende intuitiva la partita doppia anche a chi non la conosce.

Panoramica

AloxBook utilizza la contabilità in partita doppia: ogni transazione trasferisce un importo da un conto di origine a uno di destinazione. Questa semplice regola offre una visione affidabile della provenienza del denaro, della sua destinazione e dei motivi per cui cambiano i saldi.

Installazione

Requisiti di sistema

• Windows 10 o successivo (64 bit)
• ~35 MB di spazio su disco

Installazione

1. Scarica il programma di installazione dalla sezione Download
2. Esegui AloxBook-Setup.exe
3. L'app viene installata per utente (non sono necessari diritti di amministratore)
4. AloxBook associa l'estensione .aloxbook all'app per consentire l'apertura dei file con un doppio clic

In alternativa, installa AloxBook dalla riga di comando: winget install --id AloxBook.AloxBook -e

Se winget non riesce perché una fonte non è aggiornata, esegui winget source update e riprova. Se la fonte Store continua a non funzionare, usa --source winget per escluderla.

Aggiornamenti

AloxBook supporta gli aggiornamenti automatici. Quando è disponibile una nuova versione, l'app ti avviserà e si aggiornerà in background.

Per aggiornare dalla riga di comando: winget upgrade --id AloxBook.AloxBook -e

Primi passi

1. Crea un nuovo file — scegli File → Nuovo e salvalo in una posizione che renda semplici i backup
2. Imposta una password — proteggi il file se altre persone possono accedere allo stesso dispositivo (facoltativo, ma consigliato)
3. Scegli un piano dei conti — parti da una struttura che potrai rinominare e adattare in seguito, anziché da un elenco vuoto
4. Aggiungi le prime transazioni — comincia da stipendio, affitto, spesa, trasferimenti o altri movimenti ricorrenti

Conti

In AloxBook i conti sono organizzati in un albero gerarchico che parte da tre conti principali:

• Attività e debiti — conti correnti, contanti, risparmi, immobili e debiti come prestiti o carte di credito (saldi negativi)
• Entrate — stipendio, interessi, dividendi, rimborsi e altro
• Uscite — affitto, spesa alimentare, utenze, tempo libero e altro

Puoi creare sottoconti a qualsiasi livello. Ad esempio, sotto Uscite potresti avere Abitazione → Affitto e Abitazione → Utenze. I saldi vengono sommati lungo l'albero.

Creazione di un conto

Apri la scheda Conti, fai clic con il pulsante destro del mouse sul conto padre (oppure usa la barra degli strumenti), seleziona Aggiungi conto e assegnagli un nome.

Transazioni

Una transazione in AloxBook coinvolge sempre due conti: il denaro passa da un conto a un altro. È il principio fondamentale della contabilità in partita doppia.

Esempi:

• Entrate: Stipendio → Attività e debiti: Conto corrente — ricevi lo stipendio
• Attività e debiti: Conto corrente → Uscite: Spesa alimentare — fai la spesa
• Attività e debiti: Conto corrente → Attività e debiti: Risparmi — trasferisci denaro sul conto di risparmio
• Entrate: Stipendio → Uscite: Spesa alimentare — paghi il pasto in mensa direttamente dalla busta paga

Creazione di una transazione

Nella scheda Transazioni, fai clic sul pulsante +. Inserisci la data, il conto di origine, il conto di destinazione, l'importo e il testo della descrizione.

Modelli

I modelli permettono di salvare le transazioni usate più spesso e riutilizzarle rapidamente. Un modello memorizza il conto di origine, quello di destinazione, l'importo e il testo descrittivo (tutti facoltativi).

Per creare un modello, apri la scheda Modelli e fai clic sul pulsante +. Per applicarlo, selezionalo dall'elenco nella finestra "Crea nuova transazione": i valori del modello verranno inseriti automaticamente.

Importazione CSV

AloxBook può importare estratti conto bancari da file CSV. Il sistema di importazione è altamente configurabile:

• I profili di importazione vengono creati e salvati automaticamente dopo l'assegnazione a un conto
• Le regole di importazione associano automaticamente le transazioni a un modello in base a pattern di testo e importi
• Ogni transazione viene mostrata in anteprima e può essere modificata singolarmente prima del salvataggio
• Il rilevamento dei duplicati impedisce di importare due volte le stesse transazioni

Configurazione dell'importazione CSV

1. Apri la scheda Transazioni
2. Fai clic sul pulsante Importa CSV nella barra degli strumenti
3. Seleziona il tuo file CSV
4. La mappatura delle colonne viene rilevata automaticamente; è possibile regolare i dettagli manualmente
5. Controlla l'anteprima e fai clic su Importa

Rilevamento automatico del formato

L'importazione CSV è progettata per adattarsi a formati diversi. Rileva automaticamente il separatore, la codifica del testo, il formato della data, il separatore decimale, le righe di intestazione e il contenuto delle colonne. In questo modo, i file esportati dalla maggior parte delle banche e delle carte di credito possono essere importati senza configurazione manuale. Se un'impostazione non viene riconosciuta correttamente, puoi modificarla nei dettagli dell'importazione.

Formati bancari verificati

A ogni versione, i formati di esportazione elencati di seguito vengono verificati automaticamente usando file di esempio reali, per assicurarsi che siano riconosciuti senza configurazione. Si tratta soltanto di una selezione, non di un elenco completo: molte altre banche usano formati simili che vengono importati altrettanto bene.

Esportazione CSV

AloxBook può esportare in un file CSV la vista delle transazioni attualmente visualizzata. Il file contiene le stesse righe, nello stesso ordine della tabella, e rispetta i filtri e l'ordinamento attivi.

• Le prime righe CSV descrivono il filtro e l'ordinamento attivi, quindi i file esportati mantengono il loro contesto
• Le date e gli importi vengono formattati in base alle impostazioni regionali correnti
• Il separatore dipende dal formato regionale: punto e virgola quando la virgola è usata come separatore decimale, virgola negli altri casi
• Il file usa la codifica UTF-8 con BOM, per una migliore compatibilità con i fogli di calcolo

Esportazione di transazioni

1. Apri la scheda Transazioni
2. Applica qualsiasi filtro o ordinamento che desideri esportare
3. Fai clic sul pulsante Esporta CSV nella barra degli strumenti
4. Scegli il nome e il percorso del file di destinazione

Chiusura e riporto

Se preferisci conservare un file per ogni periodo contabile, ad esempio uno per anno, la funzione Chiudi e riporta il file semplifica l'operazione:

1. Scegli File → Chiudi e riporta il file
2. AloxBook crea un nuovo file con l'intera struttura dei conti
3. I saldi dei conti Attività vengono riportati come saldi iniziali
4. I modelli vengono copiati nel nuovo file
5. I conti delle entrate e delle uscite ricominciano da zero
6. Il tuo vecchio file rimane intatto ed è contrassegnato come protetto da scrittura

In questo modo inizi il nuovo periodo con ordine e conservi l'intera cronologia nel file precedente.

Crittografia

I file AloxBook (.aloxbook) sono database SQLite crittografati con SQLCipher. Quando crei o apri un file, puoi impostare una password: l'intero database verrà protetto con crittografia AES-256 quando è archiviato sul disco.

Lingua e formati regionali

AloxBook supporta inglese, tedesco, francese, spagnolo e italiano. Puoi cambiare lingua in qualsiasi momento nelle Impostazioni: l'intera interfaccia si aggiorna immediatamente, senza riavviare l'app.

Il formato di numeri e date può essere scelto separatamente nelle Impostazioni. Sistema usa il formato del sistema operativo, mentre Come la lingua dell'app segue la lingua dell'interfaccia.

Formato file

AloxBook utilizza file .aloxbook: sono normali database SQLite, con crittografia SQLCipher facoltativa. Ciò significa che:

• Tutti i dati sono raccolti in un unico file, facile da copiare, spostare o includere nei backup
• Non sono necessari servizi cloud né database esterni
• I dati sono accessibili anche con altri strumenti SQLite o, per i file crittografati, con strumenti compatibili con SQLCipher e la password corretta
• Il formato è aperto e, se il file non è crittografato, può essere esaminato con qualsiasi strumento SQLite

Risoluzione dei problemi

L'applicazione non si avvia

AloxBook è distribuito come eseguibile nativo per Windows e funziona su qualsiasi sistema Windows 10 o successivo a 64 bit, senza dipendenze aggiuntive. Se l'app non si avvia, prova a eseguirla dalla riga di comando per visualizzare eventuali messaggi di errore:

AloxBook.exe

Il file non si apre

Se ricevi un errore durante l'apertura di un file, controlla:

• Il file è un file .aloxbook valido?
• Stai inserendo la password corretta?
• Il file è protetto da scrittura? AloxBook può aprire file protetti da scrittura in modalità di sola lettura.

Problemi di importazione CSV

Se il CSV della tua banca non viene importato correttamente, controlla le impostazioni del profilo di importazione: delimitatore (virgola, punto e virgola, tabulazione), formato della data, separatore decimale e mappatura delle colonne. È possibile visualizzare in anteprima i dati analizzati prima dell'importazione per verificare che le impostazioni siano corrette.

L'esportazione CSV ha un aspetto diverso in un foglio di calcolo

L'esportazione CSV utilizza le impostazioni regionali correnti per date, separatori decimali e delimitatore CSV. Le prime due righe riportano intenzionalmente il filtro e l'ordinamento attivi, così da conservare il contesto del file.