21 posts tagged with "Beancount"

There is a plugin for beancount to forecast future recurring transactions. How to apply it in beancount.io? Put the following content into your ledger file.

; import the plugin
plugin "fava.plugins.forecast"

; add a monthly HOA fee
2022-05-30 # "HOA fee [MONTHLY]"
  Expenses:Hoa                                      1024.00 USD
  Assets:Checking                                  -1024.00 USD

And then, you will see the forecast in Net Profit chart.

The tag [MONTHLY] above means it will recur forever. If you have more conditions to apply, try [MONTHLY UNTIL 2022-06-01], [MONTHLY REPEAT 5 TIMES], [YEARLY REPEAT 5 TIMES], or [WEEKLY SKIP 1 TIME REPEAT 5 TIMES].

Beancounters traditionally use command-line tools or self-host servers with private networks, where they have to operate through a computer or a general-purpose text editor on mobile. Beancount.io reduces hassles by bringing open-sourced Android and iOS mobile apps and a secured cloud so that your ledger is now a few taps away from your fingerprint.

Beancount is a computer language that enables double-entry bookkeeping in text files. Once you define financial transactions in the file, it will generate various reports. Martin Blais, the designer of this language, argues that command-line bookkeeping has many advantages - It is fast, portable, open, and customized.

We strongly agree with the argument and share the feeling of empowerment brought by beancount language. And we wanted to do more - introducing the technology to more people. It means that we have to improve the usability and make it more accessible to a broader audience.

Not everyone is a command-line enthusiast, and this is why we build Beancount.io - the personal finance manager for everyone. Here is how it works:

For heavy-duty work, beancounters could still use their computers to edit or view the ledger with their browsers visiting https://beancount.io or syncing with Dropbox. This keeps the flexibility of the command-line tools, while not losing the cross-device access of the cloud-based solution.

For daily light-weight operations, such as instantly adding an entry, beancounters could use the mobile app to connect to the secured cloud.

Mike Thrift, a backend engineering working on this product, says

I used to set up a reminder every day for myself to open my laptop and input records to my bean files. Now, with beancount.io, it is way easier for me to modify my ledger whenever I need it, even when I am outdoors purchasing something in the store.

Zhi Li, a software engineer from Facebook, tells us

I have migrated all my beancount files to beancount.io, and now it works perfectly for my day-to-day usage. I have paid for Pro features like automatic data backup, but I feel there are more things you guys could do to improve the service.

You could sign up now at https://beancount.io/sign-up/ or download iOS or Android App. We streamlined the registration to collect as minimal information as we can from you to bootstrap the service. Then you will get a preset empty ledger that is ready for you to add an entry right away.

FAQs​

Would beancount.io sell my ledger data to any third party?​

• No. We are committed to keeping your data secured and private, and we will never sell your ledger data.

Is my data secured?​

• Yes. We protect your email and ledger with AES256, your password with BCrypt, and your network requests with SSL.

Is my ledger data end-to-end encrypted?​

• No. Due to technical constraints, we still have to decrypt your data into memory when indexing the ledger file in production servers. Therefore, we restrict direct access from any of our team members. Unfortunately, we cannot do this in Intel's SGX or any security vault due to high costs.

Is this a reliable service I could trust for the incoming few years?​

• Yes. We initially launched Beancount.io on July 4th, 2019, and it has been more than two years that we have operated the service securely and reliably. Therefore, we have no reason not to continue the service in the future.

Can I request new features and sponsor the project?​

• Yes. Please feel free to reach us at https://t.me/beancount for any feedback and support us by becoming a Pro user at https://beancount.io/pricing.

Many of our customers have been asking us how to add multiple files to one ledger since February. They need the file structure to archive or categorize transactions. So, finally, after a couple of months of work, we are glad to announce the feature is released for free.

Here is how to use it:

File > create a new file​

Go to the file editor tab on the left navigation sidebar. And then, follow the "File" dropdown and click "Create a new file".

Name your new file​

Give your file a valid filename and save it. All filenames must be ended with ".bean".

Include the file​

Here is a crucial step, you have to include the newly-created file in main.bean.

For example, if you added stock.bean, then specify include "stock.bean" in main.bean.

Refresh and navigate to file​

Refresh the page, and you will see the file appears in the "File" dropdown.

Rename or delete the file​

When navigated to the file, you could rename or delete it in the "Edit" dropdown.

Having troubles?​

Ask questions in https://t.me/beancount.

We upgraded the MIT-licensed open-source software Fava to version 1.19. Here are the changes since our last update:

• v1.19 (2021-05-18)
  • migrate from conversion and interval options to default-page option
  • add option invert-income-liabilities-equity
  • upgrade to CodeMirror 6
  • adds a Bulgarian translation
  • other small improvements and bug fixes
• v1.18 (2021-01-16)
  • couple of small improvements and various bug fixes.

Feeling excited? Try it now at https://beancount.io/ledger/

Having questions? We will be there for you at https://t.me/beancount :)

Amortization spreads out payments to many installments over time. In beancount.io, you can use the plugin fava.plugins.amortize_over to achieve so.

Without amortization, if you want to insure your car for 6 months with costs of $600. You have to record this as a one-time expense for a particular date.

2017-06-01 open Assets:Bank:Checking
2017-06-01 open Assets:Prepaid-Expenses
2017-06-01 open Expenses:Insurance:Auto

![2021-01-09-amortize](https://opengraph-image.blockeden.xyz/api/og-beancount-io?title=Understanding%20Amortization%20in%20Beancount)

2017-06-01 * "Pay car insurance"
    Assets:Bank:Checking       -600.00 USD
    Assets:Prepaid-Expenses

However, with amortization, you could allocate the expense over six months by putting plugin "fava.plugins.amortize_over" to the top of the file and using amortize_months: 6 for the transaction

plugin "fava.plugins.amortize_over"

2020-06-01 open Assets:Bank:Checking
2020-06-01 open Assets:Prepaid-Expenses
2020-06-01 open Expenses:Insurance:Auto

2020-06-01 * "Amortize car insurance over six months"
    amortize_months: 6
    Assets:Prepaid-Expenses       -600.00 USD
    Expenses:Insurance:Auto

And then in Journal, you will see the transaction is split into 6 postings.

2020-11-01 * Amortize car insurance over six months (6/6) am
2020-10-01 * Amortize car insurance over six months (5/6) am
2020-09-01 * Amortize car insurance over six months (4/6) am
2020-08-01 * Amortize car insurance over six months (3/6) am
2020-07-01 * Amortize car insurance over six months (2/6) am
2020-06-01 * Amortize car insurance over six months (1/6) am

Maintaining a secured and performant online service is never a one-time thing. It takes effort not only to develop new features but also to renew existing functionalities.

Stale software puts our customers at risk of security vulnerabilities. How do we reduce this risk? On the one hand, we proactively work with security researchers to find and resolve unexpected issues. On the other hand, we merge the latest version of the upstream software periodically.

Today we are glad to share some improvements we have made to improve Beancount.io.

1. We upgraded the server and sped up the service up to 30%. Service availability was also greatly improved.
2. We upgraded the MIT-licensed open-source software Fava to version 1.17. It fixed various bugs and added many new features.

Feeling excited? Try it now at https://beancount.io/ledger/

Having questions? We will be there for you at https://t.me/beancount :)

Beancount.io is excited to announce the brand new rewards program for developers in our community! A Security Bug Bounty program is an open offer to external individuals to receive compensation for reporting beancount.io and open-sourced Beancount mobile bugs related to the security of the core functionality.

No technology is perfect, and we believe that working with developers, engineers, and technologists across the globe is crucial in identifying weaknesses in our project while building. If you think you’ve found a security issue in our product or service, we encourage you to notify us. We welcome working with you to resolve the issue promptly.

Campaign Period​

2020-10-15 17:00 PST to 2020-11-30 17:00 PST

Scope​

The following components of Beancunt are included in 1 Stage of the Bug Bounty Campaign:

1. beancount.io/ledger : Your personal finance manager.
2. open-sourced Beancount mobile

Steps to participate and report bugs​

• If it is NOT related to personally identifiable information (PII) and exact ledger data. Provide information about bugs through the GitHub ISSUE request in https://github.com/puncsky/beancount-mobile/issues/:
  • Asset. Chose the repository the bug is related to and create a “New Issue” in it.
  • Severity. Chose the level of vulnerability according to “Qualifying Vulnerabilities”
  • Summary — Add a summary of the bug
  • Description — Any additional details about this bug
  • Steps — Steps to reproduce
  • Supporting Material/References — Source code to replicate, list any additional material (e.g., screenshots, logs, etc.)
  • Impact — What impact does the found bug has, what could an attacker achieve?
  • Your name, country, and Telegram id for contact.
• If it is related to PII and exact ledger data, contact puncsky on Telegram and send the information above.
• The Beancount.io team will review all bugs and will provide you with feedback as quickly as possible via the comments on the page with a specific bug or via Telegram in person if it is related to PII and exact ledger data.
• Distribution of rewards will be carried out in Physical Gift, Gift Card, or USDT equivalent after the campaign finishes around 2020-12-01 PST.

Qualifying vulnerabilities​

To qualify for the bounty, the security bug must be original and previously unreported.

Only the following design or implementation issues that substantially affect the stability or security of Beancount.io are qualified for the reward. Common examples include:

• Leak of the PII and ledger data while the host machine is not compromised
• A special action that causes the entire website or mobile app to suspend or crash
• A user impacts another user without prior access grant

For scenarios that do not fall within one of the above categories, we still appreciate reports that help us secure our infrastructure and our users and reward those reports on a case-by-case basis.

Out of Scope Vulnerabilities​

When reporting vulnerabilities, please consider the attack scenario, exploitability, and security impact of the bug. The following issues are considered out of scope, and we will NOT accept any of the following types of attacks:

• Denial of service attacks
• Phishing attacks
• Social engineering attacks
• Reflected file download
• Software version disclosure
• Issues requiring direct physical access
• Issues requiring exceedingly unlikely user interaction
• Flaws affecting out-of-date browsers and plugins
• Publicly accessible login panels
• CSV injection
• Email enumeration / account oracles
• CSP Weaknesses
• Email Spoofing
• Techniques allowing you to view user profile photos (these are considered public)

Rewards​

The prize for the most critical bug exposing PII and ledger data is an AirPods Pro (in the U.S.) or USDT equivalent.

The prize for a security bug is a $20 Amazon Gift Card or USDT equivalent.

We are a small team with a limited budget and could distribute only

• 1 AirPods Pro for all.
• 10 $20 rewards per month, up to 3 months. If the actual case exceeds that amount in that month, we will send the remaining reward in the next month. ($600 in total for this campaign)

Got questions?​

Ask us at https://t.me/beancount

Privacy is core to our DNA, our culture, and our values. We are committed to protecting your data across our systems.

And today, we are excited to open-source Beancount mobile. That means the code is publicly available, scrutinized by people. That level of transparency ensures both the security of the App, and your peace of mind concerning what we do with your data.

Open source gives our customers more choices on the market and better solutions in many ways. We build Beancount.io on top of excellent open-source projects and hope to open source as many modules of our system as possible in the future. And Beancount mobile is just the beginning of this journey :)

We update the Beancount app as often as possible to make it faster and more reliable for you. Here are a couple of the enhancements you'll find in the latest update:

• Add subscription of email report

• Add announcement section

Love the app? Rate us! Your feedback keeps the Beancount devs coding.

Have a question? Visit https://t.me/beancount.

Beancount users often give us feedback that it is painful to add an entry to the ledger on mobile devices. Today, we are glad to announce the first-ever Beancount iOS App and Android App.

This App makes it easy to add transactions to your ledger and view some financial reports on your phone. And you can also edit the ledger file directly via the web view. Your usage of this App will determine what features we will add in the future. Please feel free to join our community and discuss Beancount and bookkeeping at https://t.me/beancount.

Our mission is to help people live a better financial life, and Beancount App is just a very initial step of what we are planning to achieve. There is an Android one pending in review. And more tools are coming soon.