Awesome Beancount
Una guida curata all'ecosistema Beancount. Beancount è un potente sistema di contabilità open-source che utilizza un formato semplice basato su testo per gestire le tue finanze con il rigore della partita doppia. Questa pagina combina liste curate dalla comunità e panoramiche dell'ecosistema in un'unica risorsa completa.
Perché la Contabilità in Testo Semplice?
La contabilità in testo semplice (PTA) è una metodologia per gestire le finanze utilizzando semplici file di testo e potenti strumenti da riga di comando. Questo approccio ti dà la piena proprietà dei tuoi dati, garantisce longevità e offre una flessibilità senza pari per automazione e analisi.
- Hub PTA Ufficiale: Plain Text Accounting
- Un'introduzione Graduale: Accounting for the simple minds with plain text accounting
- Dalle App Web alla CLI: Command line accounting: From mint.com to Ledger
L'Ecosistema Beancount
L'ecosistema Beancount è una collezione di strumenti, plugin e risorse costruiti attorno a un motore centrale. Ogni componente gioca un ruolo specifico nella creazione di un flusso di lavoro completo per la gestione finanziaria.
1. Motore Centrale e Risorse Ufficiali
Questi sono gli elementi fondamentali di Beancount, mantenuti dal creatore e dai contributori ufficiali.
| Risorsa | Descrizione |
|---|---|
| Beancount (Core) | Il motore che legge il tuo file di registro, applica le regole della partita doppia e genera report. Fornisce utilità da riga di comando come bean-check e bean-format. Tutti gli altri strumenti si basano su questo. |
| Homepage | beancount.github.io |
| Codice Sorgente | github.com/beancount/beancount |
| Documentazione | GitHub Pages e Google Docs |
| Contributi Esterni | Elenco ufficiale dei contributi della comunità |
| Beanquery | Un potente strumento di interrogazione simile a SQL (v3) per eseguire query avanzate (es. SELECT ... FROM ... WHERE ...) sul tuo registro per generare analisi personalizzate. |
2. Interfacce Utente
Questi strumenti forniscono interfacce visive per esplorare e modificare i tuoi dati finanziari.
| Strumento | Descrizione |
|---|---|
| Fava | La dashboard web definitiva e completa per Beancount. Fornisce grafici interattivi, tabelle esplorabili, modifica nel browser e un sistema di estensioni per aggiungere funzionalità come il budget. |
| Fava-GTK | Un'applicazione nativa per GNOME Desktop che impacchetta Fava per un'esperienza desktop senza soluzione di continuità. |
| Beancount Mobile | Un'app mobile per l'inserimento dati per aggiungere transazioni in movimento. |
| Beancount Telegram Bot | Un bot Telegram per aggiungere rapidamente transazioni al tuo registro tramite chat. |
3. Importazione di Transazioni
L'importazione è il processo di conversione dei dati provenienti da istituti finanziari (come CSV bancari o PDF) in voci Beancount.
| Strumento | Descrizione |
|---|---|
| Beangulp (v3) | Il moderno framework autonomo per costruire importatori. Elabora file esterni tramite script Python (plugin) per generare direttive Beancount. |
| Smart Importer | Uno strumento che potenzia gli importatori con l'apprendimento automatico per prevedere e assegnare automaticamente le categorie. |
| Beancount Reds Ingestor | Una collezione di importatori con una libreria comune per gestire file CSV e OFX. |
| double-entry-generator | Un importatore basato su regole focalizzato su servizi cinesi come Alipay e WeChat Pay. |
Importatori della Comunità (Per Paese)
Una vasta collezione di script per banche e servizi specifici, mantenuta dalla comunità.
- Cina
- Alipay / 支付宝: deb-sig/double-entry-generator, wzyboy/importer
- China Merchants Bank (CMB): Carta di Debito, Carta di Credito
- WeChat Pay / 微信支付: deb-sig/double-entry-generator
- Francia
- Caisse d'Epargne: beancount-ce
- Boursorama, Amex: Beancount-myTools
- Germania
- Commerzbank: beancount-commerzbank
- Deutsche Kredit Bank (DKB): beancount-dkb
- ING: beancount-ing
- N26: beancount-n26
- Volksbank & GLS-Bank: beancount-importer-volksbank
- India
- SBI, BOI, Paytm, HSBC, ICICI: beancount-importers-india
- Paesi Bassi
- ABN AMRO: beancount-abnamro
- Svizzera
- Generale: tariochbctools (BCGE, Neon, Raiffeisen, ZKB, Fidelity)
- Finpension: drnuke-bean
- PostFinance: tariochbctools, drnuke-bean
- Regno Unito
- Monzo, Revolut, Wise: Evernight/beancount-importers
- Revolut, Wise: tariochbctools
- Stati Uniti
- Amex, Chase, Citi, Schwab: mterwill/gist
- Capital One: mtlynch/beancount-capitalone
- Chase: mtlynch/beancount-chase-bank, ArthurFDLR/beancount-chase
- Clipper: beancount-clipper
- Mercury: mtlynch/beancount-mercury
- Blockchain
4. Supporto Editor e Strumenti
Strumenti che integrano Beancount nel tuo ambiente di sviluppo per semplificare la modifica e la manutenzione.
- Supporto IDE: Plugin che forniscono evidenziazione della sintassi, completamento automatico e controllo del saldo in tempo reale.
- VSCode
- Emacs
- Vim
- Zed
- Sublime Text
- Atom
- Beancount Language Server (per qualsiasi editor compatibile LSP)
- Automazione e Utilità:
bean-add: Aggiungi transazioni interattivamente dalla riga di comando.beancount-black: Un formattatore di codice arbitrario per file Beancount.beancount-categorizer: Categorizza automaticamente le transazioni con regole regex.beanahead: Amministra e proietta transazioni future.
- Strumenti di Migrazione Dati: Utilità per convertire dati da altri sistemi contabili.
- Da GnuCash: henriquebastos/gc-to-bc, dtrai2/gc-to-bc
- Da Ledger/hledger: travisdahlke/gist, zacchiro/ledger2beancount
- Da YNAB: hoostus/beancount-ynab
5. Plugin (Estensioni del Registro)
Moduli Python all'interno del registro che vengono eseguiti durante l'elaborazione per applicare regole personalizzate, automatizzare transazioni o aggiungere nuove funzionalità.
- Budget:
- fava-envelope: Un'estensione Fava per il budget a buste.
- Automazione e Controlli:
- autobean.share: Suddivisione delle spese e gestione dei debiti.
- autobean.sorted: Assicura che le transazioni siano ordinate cronologicamente.
- beancount-checkclosed: Controlla automaticamente il saldo a zero sui conti chiusi.
- Manipolazione Dati:
- autobean.narration: Genera automaticamente descrizioni delle transazioni.
- beancount-lazy-plugins.filter_map: Applica operazioni a un gruppo filtrato di transazioni.
6. Fonti di Prezzo
Script che recuperano prezzi storici e correnti per materie prime, azioni e valute per tracciare il valore degli investimenti.
- beancount-exchangerates: Per valute fiat tramite API come
frankfurter.dev. - pricehist: Un recuperatore di prezzi multi-fonte.
- beancount-cryptoassets: Per il recupero dei prezzi delle criptovalute.
- tariochbctools: Include una fonte di prezzo per Interactive Brokers.
Apprendimento e Comunità
Libri e Guide Approfondite
- Tracking Personal Finances using Python: Un libro che fornisce una guida completa per costruire un sistema di finanza personale con Beancount. (Sito Web)
- Serie di Blog in Cinese (BYVoid): Parte 1: Perché?, Parte 2: Dare e Avere
Post di Blog Selezionati
- Inglese
- Francese
- Cinese
Comunità
- Mailing List: Google Groups (Forum di discussione principale)
- Chat in Diretta (IRC): #beancount su web.libera.chat
- Telegram (Cinese): t.me/beancount_zh
Servizi e App Commerciali
Per gli utenti che desiderano la potenza di Beancount senza gestire l'infrastruttura da soli.
| Servizio | Descrizione |
|---|---|
| Beancount.io | Una piattaforma SaaS (Software as a Service) che fornisce un'istanza Beancount e Fava pronta all'uso. Offre anche app mobili dedicate per iOS e Android. |