# 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](https://plaintextaccounting.org/)
- **Un'introduzione Graduale:** [Accounting for the simple minds with plain text accounting](https://dustri.org/b/accounting-for-the-simple-minds-with-plain-text-accounting.html)
- **Dalle App Web alla CLI:** [Command line accounting: From mint.com to Ledger](https://muehe.org/posts/command-line-accounting/)

***

## 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](https://beancount.github.io/)                                                                                                                                                                        |
| **Codice Sorgente**    | [github.com/beancount/beancount](https://github.com/beancount/beancount)                                                                                                                                                   |
| **Documentazione**     | [GitHub Pages](https://beancount.github.io/docs/) e [Google Docs](https://docs.google.com/document/d/1RaondTJCS_IUPBHFNdT8oqFKJjVJDsfsn6JEjBG04eA/edit)                                                                    |
| **Contributi Esterni** | [Elenco ufficiale dei contributi della comunità](https://beancount.github.io/docs/external_contributions.html)                                                                                                             |
| **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](https://github.com/deb-sig/double-entry-generator), [wzyboy/importer](https://github.com/wzyboy/awesome-beancount/blob/master/importers/alipay_acclog.py)
  - China Merchants Bank (CMB): [Carta di Debito](https://github.com/wzyboy/awesome-beancount/blob/master/importers/cmb_debit_cards.py), [Carta di Credito](https://github.com/wzyboy/awesome-beancount/blob/master/importers/cmb_credit_cards.py)
  - WeChat Pay / 微信支付: [deb-sig/double-entry-generator](https://github.com/deb-sig/double-entry-generator)

- **Francia**

  - Caisse d'Epargne: [beancount-ce](https://github.com/ArthurFDLR/beancount-ce)
  - Boursorama, Amex: [Beancount-myTools](https://github.com/grostim/Beancount-myTools)

- **Germania**

  - Commerzbank: [beancount-commerzbank](https://github.com/siddhantgoel/beancount-commerzbank)
  - Deutsche Kredit Bank (DKB): [beancount-dkb](https://github.com/siddhantgoel/beancount-dkb)
  - ING: [beancount-ing](https://github.com/siddhantgoel/beancount-ing)
  - N26: [beancount-n26](https://github.com/siddhantgoel/beancount-n26)
  - Volksbank & GLS-Bank: [beancount-importer-volksbank](https://github.com/Fjanks/beancount-importer-volksbank)

- **India**
  - SBI, BOI, Paytm, HSBC, ICICI: [beancount-importers-india](https://github.com/dumbPy/beancount-importers-india)

- **Paesi Bassi**
  - ABN AMRO: [beancount-abnamro](https://github.com/deepakg/beancount-abnamro)

- **Svizzera**

  - Generale: [tariochbctools](https://tariochbctools.readthedocs.io/) (BCGE, Neon, Raiffeisen, ZKB, Fidelity)
  - Finpension: [drnuke-bean](https://github.com/Dr-Nuke/drnuke-bean?tab=readme-ov-file#finpension-importer)
  - PostFinance: [tariochbctools](https://github.com/tarioch/beancounttools/blob/master/src/tariochbctools/importers/postfinance/importer.py), [drnuke-bean](https://github.com/Dr-Nuke/drnuke-bean?tab=readme-ov-file#postfinance-importer-swiss)

- **Regno Unito**

  - Monzo, Revolut, Wise: [Evernight/beancount-importers](https://github.com/Evernight/beancount-importers/)
  - Revolut, Wise: [tariochbctools](https://tariochbctools.readthedocs.io/en/latest/importers.html#revolut)

- **Stati Uniti**

  - Amex, Chase, Citi, Schwab: [mterwill/gist](https://gist.github.com/mterwill/7fdcc573dc1aa158648aacd4e33786e8#file-importers-amex-py)
  - Capital One: [mtlynch/beancount-capitalone](https://github.com/mtlynch/beancount-capitalone)
  - Chase: [mtlynch/beancount-chase-bank](https://github.com/mtlynch/beancount-chase-bank), [ArthurFDLR/beancount-chase](https://github.com/ArthurFDLR/beancount-chase)
  - Clipper: [beancount-clipper](https://git.sr.ht/~goorzhel/beancount-clipper)
  - Mercury: [mtlynch/beancount-mercury](https://github.com/mtlynch/beancount-mercury)

- **Blockchain**
  - [tariochbctools](https://tariochbctools.readthedocs.io/en/latest/importers.html#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](https://marketplace.visualstudio.com/items?itemName=Lencerf.beancount)
  - [Emacs](https://github.com/beancount/beancount-mode)
  - [Vim](https://github.com/nathangrigg/vim-beancount)
  - [Zed](https://github.com/zed-extensions/beancount)
  - [Sublime Text](https://github.com/norseghost/sublime-beancount)
  - [Atom](https://atom.io/packages/beancount)
  - [Beancount Language Server](https://github.com/polarmutex/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](https://github.com/henriquebastos/gnucash-to-beancount/), [dtrai2/gc-to-bc](https://github.com/dtrai2/gnucash-to-beancount/)
  - Da Ledger/hledger: [travisdahlke/gist](https://gist.github.com/travisdahlke/71152286b0a8826249fe), [zacchiro/ledger2beancount](https://github.com/zacchiro/ledger2beancount)
  - Da YNAB: [hoostus/beancount-ynab](https://github.com/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](https://github.com/polarmutex/fava-envelope): Un'estensione Fava per il budget a buste.

- **Automazione e Controlli:**

  - [autobean.share](https://github.com/SEIAROTg/autobean/tree/master/autobean/share): Suddivisione delle spese e gestione dei debiti.
  - [autobean.sorted](https://github.com/SEIAROTg/autobean/tree/master/autobean/sorted): Assicura che le transazioni siano ordinate cronologicamente.
  - [beancount-checkclosed](https://github.com/daniel-wells/beancount_checkclosed): Controlla automaticamente il saldo a zero sui conti chiusi.

- **Manipolazione Dati:**

  - [autobean.narration](https://github.com/SEIAROTg/autobean/tree/master/autobean/narration): Genera automaticamente descrizioni delle transazioni.
  - [beancount-lazy-plugins.filter\_map](https://github.com/Evernight/beancount-lazy-plugins/tree/main?tab=readme-ov-file#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](https://github.com/xuhcc/beancount-exchangerates): Per valute fiat tramite API come `frankfurter.dev`.
- [pricehist](https://gitlab.com/chrisberkhout/pricehist): Un recuperatore di prezzi multi-fonte.
- [beancount-cryptoassets](https://github.com/xuhcc/beancount-cryptoassets): Per il recupero dei prezzi delle criptovalute.
- [tariochbctools](https://tariochbctools.readthedocs.io/): 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](https://personalfinancespython.com/))
- **Serie di Blog in Cinese (BYVoid):** [Parte 1: Perché?](https://byvoid.com/zhs/blog/beancount-bookkeeping-1), [Parte 2: Dare e Avere](https://byvoid.com/zhs/blog/beancount-bookkeeping-2)

### Post di Blog Selezionati

- **Inglese**

  - [Counting beans - and more - with Beancount](https://lwn.net/Articles/751874/)
  - [Managing Personal Finances using Python](https://sgoel.dev/posts/managing-personal-finances-using-python/)
  - [No-Bullshit Beancount Introduction](https://web.archive.org/web/20221119110728/https://blog.leononame.dev/2019/08/beancount/)

- **Francese**
  - [Beancount ou la comptabilité pour les hackers](https://cyril.deguet.com/fr/2015/09/03/beancount-comptabilite-pour-hackers/)

- **Cinese**
  - [Beancount —— 命令行复式簿记](https://wzyboy.im/post/1063.html)

### Comunità

- **Mailing List:** [Google Groups](https://groups.google.com/g/beancount) (Forum di discussione principale)
- **Chat in Diretta (IRC):** [#beancount su web.libera.chat](https://web.libera.chat/gamja/?channels=%23beancount)
- **Telegram (Cinese):** [t.me/beancount\_zh](https://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](https://apps.apple.com/app/id1527950512) e [Android](https://play.google.com/store/apps/details?id=io.beancount.android). |

## Metti al lavoro il testo semplice.

Crea un libro contabile Beancount o segui la guida per configurare il tuo ambiente.

[Inizia gratis](https://beancount.io/sign-up/?next=%2Fledger%2F) [Guida introduttiva](https://beancount.io/it/docs/getting-started)

## Where to look next

- [Sitemap](https://beancount.io/sitemap.xml) - all pages with hreflang alternates
- [LLMs index](https://beancount.io/llms.txt) - curated links for AI agents (also /llms-full.txt for full docs)
- [Documentation](https://beancount.io/docs) - every doc is also available as text/markdown via .md suffix or Accept negotiation
- [REST API reference](https://beancount.io/docs/api-reference) - interactive endpoints, schemas, authentication, and code samples
- [OpenAPI spec](https://beancount.io/openapi.json) - OpenAPI 3.1 spec for this website's public content endpoints; the product contract for ledger operations is at https://beancount.io/api-gateway/v1/openapi.json
- [GraphQL](https://beancount.io/graphql) - public, read-only content API over the blog and research logs (no credentials, no ledger data): 12 query fields over 23 types
- [MCP server](https://beancount.io/mcp) - Model Context Protocol at https://beancount.io/api-gateway/mcp
