Metadata-Version: 2.4
Name: jal
Version: 2026.9.2
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 and amortization for bonds, staking and lending rewards for crypto
    5. Corporate actions for stocks (Split, Symbol change, Merger, Spin-Off, Stock dividend)
    6. Term deposits
    7. Crypto lending deposits/withdrawals and staking
    8. Swaps and cross-chain bridge transfers
- 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)
