Metadata-Version: 2.4
Name: jal
Version: 2026.9.3
Summary: Just Another Ledger - project to track personal financial records
Home-page: https://github.com/titov-vv/jal
Author-email: jal@gmx.ru
License: GPL-3.0-or-later
Project-URL: User manual, https://titov-vv.github.io/jal/manual/
Project-URL: Source, https://github.com/titov-vv/jal
Project-URL: Bug Tracker, https://github.com/titov-vv/jal/issues
Project-URL: Support, https://t.me/jal_support
Classifier: Development Status :: 4 - Beta
Classifier: Topic :: Office/Business
Classifier: Topic :: Office/Business :: Financial
Classifier: Topic :: Office/Business :: Financial :: Accounting
Classifier: Topic :: Office/Business :: Financial :: Investment
Classifier: Intended Audience :: End Users/Desktop
Classifier: Environment :: X11 Applications :: Qt
Classifier: Natural Language :: English
Classifier: Natural Language :: Russian
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: docs/LICENSE
Requires-Dist: lxml>=4.5.0
Requires-Dist: pandas>=2.1.0
Requires-Dist: openpyxl>=3.1.0
Requires-Dist: xlrd>=2.0.1
Requires-Dist: PySide6>=6.5.1
Requires-Dist: requests>=2.24.0
Requires-Dist: XlsxWriter>=1.3.3
Requires-Dist: bip_utils>=2.9.0
Requires-Dist: sqlparse
Requires-Dist: oauthlib
Requires-Dist: requests-oauthlib
Requires-Dist: setuptools
Requires-Dist: packaging
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license
Dynamic: license-file
Dynamic: project-url
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

<img src="https://raw.githubusercontent.com/titov-vv/jal/master/docs/img/jal_logo.png" alt="JAL" width="88">

# JAL 
Just Another Ledger is a project for personal finance tracking.

It was designed to keep records of personal incomes/spendings and investments with up-to-date information about account's balances and portfolio value.

### Main features
- multiple accounts in any number of currencies; the reporting currency (everything is converted into) is the one you set for your country of residence
- the operations it records:
    1. Generic income/spending operations that may be split into several categories
    2. Asset and money transfers between accounts (with currency conversion if required)
    3. Buy/Sell operation for securities (jal supports stocks, ETFs, options, partial support of bonds and futures)
    4. Asset payments (dividends for stocks, interest for bonds) and asset income (stock dividends and vesting,
       staking and lending rewards for crypto)
    5. Corporate actions for stocks (Split, Symbol change, Merger, Spin-Off, Stock dividend)
    6. Term deposits
    7. Wrapping: crypto lending deposits/withdrawals and liquid staking, with the protocol named
    8. Swaps, cross-chain bridge transfers and on-chain actions (approvals, failed transactions); gas is a fee of
       the operation it paid for
- crypto wallets on Ethereum, Arbitrum, Avalanche, Bitcoin, Solana, Tron and Hyperliquid: operations are fetched from
the chain, staked positions are tracked separately and rewards that are earned but not paid out yet are reported
- reports:
    1. Daily history of account balance.
    2. Portfolio asset allocation for a given date.
    3. Monthly income/expenditure by category, peer or tag.
    4. Investment profit/loss and history of payments for an assets.
    5. Closed deals summary.
    6. Term deposits and staked positions.
- quotes updates: stocks and ETFs from Yahoo (US, LSE, Frankfurt, Warsaw, Helsinki), Euronext, TMX TSX and MOEX;
crypto from DeFiLlama; currency rates from the European and the Russian central banks
- Broker, bank and crypto exchange statement import:
    1. International: Interactive Brokers Flex statement (xml), Freedom Finance (xml), Just2Trade (xlsx), Trading 212 (csv), Revolut (csv).
    2. Russian: KIT Finance (xlsx), PSB broker (xlsx/xls), VTB Investments (xlsx), Tvoy Broker (zip).
    3. Crypto exchanges: KuCoin (zip), Bitget (zip).
- Investments report for tax declaration preparation for Russia and Portugal.  
Russian tax estimation for open positions.
- *experimental* Download russian electronic slips from russian tax authority (FNS). This function requires authorization and `pyzbar` package installation for QR recognition.  
You may authorize via SMS, FNS personal account or ESIA/Gosuslugi. QR code may be scanned from camera, clipboard image or image file on disk.

[**User manual**](https://titov-vv.github.io/jal/manual/) - the whole program explained from the first start onwards.

Full description is available at Github - *[English](https://github.com/titov-vv/jal/blob/master/docs/README.md), [Русский](https://github.com/titov-vv/jal/blob/master/docs/README.ru.md)*

Support: [jal@gmx.ru](mailto:jal@gmx.ru?subject=%5BJAL%5D%20Help) or [Telegram](https://t.me/jal_support)
