Awesome Beancount
Kurátorovaný sprievodca ekosystémom Beancount. Beancount je výkonný, open-source účtovný systém, ktorý využíva jednoduchý textový formát na správu vašich financií s prísnosťou podvojného účtovníctva. Táto stránka spája komunitou spravované zoznamy a prehľady ekosystému do jedného komplexného zdroja.
Prečo plain-text účtovníctvo?
Plain-text účtovníctvo (PTA) je metodika správy financií pomocou jednoduchých textových súborov a výkonných nástrojov príkazového riadka. Tento prístup vám poskytuje plné vlastníctvo vašich údajov, zaručuje dlhovekosť a ponúka bezkonkurenčnú flexibilitu pre automatizáciu a analýzu.
- Oficiálne centrum PTA: Plain Text Accounting
- Jemný úvod: Accounting for the simple minds with plain text accounting
- Od webových aplikácií k CLI: Command line accounting: From mint.com to Ledger
Ekosystém Beancount
Ekosystém Beancount je zbierka nástrojov, doplnkov a zdrojov vytvorených okolo jadra systému. Každý komponent zohráva špecifickú úlohu pri vytváraní kompletného pracovného postupu správy financií.
1. Jadro a oficiálne zdroje
Toto sú základné prvky Beancountu, ktoré spravuje autor a oficiálni prispievatelia.
| Zdroj | Popis |
|---|---|
| Beancount (jadro) | Jadro, ktoré číta váš súbor účtovnej knihy, vynucuje pravidlá podvojného účtovníctva a generuje reporty. Poskytuje základné utility príkazového riadka ako bean-check a bean-format. Všetky ostatné nástroje sú postavené na tomto základe. |
| Domovská stránka | beancount.github.io |
| Zdrojový kód | github.com/beancount/beancount |
| Dokumentácia | GitHub Pages a Google Docs |
| Externé príspevky | Oficiálny zoznam komunitných príspevkov |
| Beanquery | Výkonný nástroj na dopytovanie podobný SQL (v3) na spúšťanie pokročilých dopytov (napr. SELECT ... FROM ... WHERE ...) nad vašou účtovnou knihou na generovanie vlastných analýz. |
2. Používateľské rozhrania
Tieto nástroje poskytujú vizuálne rozhrania na skúmanie a úpravu vašich finančných údajov.
| Nástroj | Popis |
|---|---|
| Fava | Definitívny, plnohodnotný webový dashboard pre Beancount. Poskytuje interaktívne grafy, podrobné tabuľky, úpravy v prehliadači a systém rozšírení pre pridávanie funkcií, ako je rozpočtovanie. |
| Fava-GTK | Natívna aplikácia pre GNOME Desktop, ktorá obaľuje Favu pre bezproblémové používanie na desktope. |
| Beancount Mobile | Mobilná aplikácia na zadávanie údajov a pridávanie transakcií na cestách. |
| Beancount Telegram Bot | Telegram bot na rýchle pridávanie transakcií do vašej účtovnej knihy prostredníctvom chatu. |
3. Importovanie transakcií
Importovanie je proces konverzie údajov z finančných inštitúcií (ako bankové CSV alebo PDF) na záznamy v Beancounte.
| Nástroj | Popis |
|---|---|
| Beangulp (v3) | Moderný, samostatný framework na vytváranie importérov. Spracováva externé súbory pomocou Python skriptov (pluginov) a generuje direktívy pre Beancount. |
| Smart Importer | Nástroj, ktorý vylepšuje importéry pomocou strojového učenia na automatické predpovedanie a priraďovanie kategórií. |
| Beancount Reds Ingestor | Zbierka importérov so spoločnou knižnicou na prácu so súbormi CSV a OFX. |
| double-entry-generator | Pravidlový importér zameraný na čínske služby ako Alipay a WeChat Pay. |
Komunitné importéry (podľa krajín)
Rozsiahla zbierka skriptov pre konkrétne banky a služby, spravovaná komunitou.
- Čína
- Alipay / 支付宝: deb-sig/double-entry-generator, wzyboy/importer
- China Merchants Bank (CMB): Debetná karta, Kreditná karta
- WeChat Pay / 微信支付: deb-sig/double-entry-generator
- Francúzsko
- Caisse d'Epargne: beancount-ce
- Boursorama, Amex: Beancount-myTools
- Nemecko
- 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
- Holandsko
- ABN AMRO: beancount-abnamro
- Švajčiarsko
- Všeobecné: tariochbctools (BCGE, Neon, Raiffeisen, ZKB, Fidelity)
- Finpension: drnuke-bean
- PostFinance: tariochbctools, drnuke-bean
- Spojené kráľovstvo
- Monzo, Revolut, Wise: Evernight/beancount-importers
- Revolut, Wise: tariochbctools
- USA
- 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. Podpora editorov a nástroje
Nástroje, ktoré integrujú Beancount do vášho vývojového prostredia s cieľom zjednodušiť úpravy a údržbu.
- Podpora IDE: Pluginy poskytujúce zvýrazňovanie syntaxe, automatické dopĺňanie a kontrolu zostatkov v reálnom čase.
- VSCode
- Emacs
- Vim
- Zed
- Sublime Text
- Atom
- Beancount Language Server (pre akýkoľvek editor kompatibilný s LSP)
- Automatizácia a pomôcky:
bean-add: Interaktívne pridávanie transakcií z príkazového riadka.beancount-black: Nástroj na striktné formátovanie kódu pre súbory Beancount.beancount-categorizer: Automatická kategorizácia transakcií pomocou pravidiel regulárnych výrazov.beanahead: Správa a plánovanie budúcich transakcií.
- Nástroje na migráciu dát: Pomôcky na konverziu dát z iných účtovných systémov.
- Z GnuCash: henriquebastos/gc-to-bc, dtrai2/gc-to-bc
- Z Ledger/hledger: travisdahlke/gist, zacchiro/ledger2beancount
- Z YNAB: hoostus/beancount-ynab
5. Pluginy (Rozšírenia účtovnej knihy)
Python moduly v rámci účtovnej knihy, ktoré bežia počas spracovania s cieľom vynútiť vlastné pravidlá, automatizovať transakcie alebo pridať nové funkcie.
- Rozpočtovanie:
- fava-envelope: Rozšírenie pre Fava na obálkové rozpočtovanie.
- Automatizácia a kontroly:
- autobean.share: Rozdeľovanie výdavkov a správa dlhov.
- autobean.sorted: Zabezpečuje chronologické zoradenie transakcií.
- beancount-checkclosed: Automaticky kontroluje nulový zostatok na uzavretých účtoch.
- Manipulácia s dátami:
- autobean.narration: Automaticky generuje popisy transakcií.
- beancount-lazy-plugins.filter_map: Aplikuje operácie na filtrovanú skupinu transakcií.
6. Cenové zdroje
Skripty, ktoré získavajú historické a aktuálne ceny komodít, akcií a mien na sledovanie hodnoty investícií.
- beancount-exchangerates: Pre fiat meny cez API ako
frankfurter.dev. - pricehist: Nástroj na získavanie cien z viacerých zdrojov.
- beancount-cryptoassets: Na získavanie cien kryptomien.
- tariochbctools: Obsahuje cenový zdroj pre Interactive Brokers.
Vzdelávanie a komunita
Knihy a podrobné návody
- Sledovanie osobných financií pomocou Pythonu: Kniha, ktorá poskytuje komplexný návod na vytvorenie systému osobných financií pomocou Beancount. (Webstránka)
- Séria blogov v čínštine (BYVoid): Časť 1: Prečo?, Časť 2: Má dať a dal
Vybrané príspevky na blogoch
- Angličtina
- Francúzština
- Čínština
Komunita
- E-mailová konferencia: Google Groups (Primárne diskusné fórum)
- Live Chat (IRC): #beancount na web.libera.chat
- Telegram (v čínštine): t.me/beancount_zh
Komerčné služby a aplikácie
Pre používateľov, ktorí chcú využívať silu Beancount bez toho, aby si sami spravovali infraštruktúru.
| Služba | Popis |
|---|---|
| Beancount.io | Platforma SaaS (Software as a Service), ktorá poskytuje pripravenú inštanciu Beancount a Fava. Ponúka tiež špecializované mobilné aplikácie pre iOS a Android. |
