Asset Track

简体中文

Import your bills once a month. Understand where your money went, what changed in your assets, and whether the picture is complete.

Asset Track is a private, local personal finance tool for monthly settlement. It turns bills exported from payment platforms into one organized financial record, then helps you review spending, assets, loans, investments, and data gaps.

You do not need to record every purchase as it happens. Asset Track is built for a short, focused monthly review: import what already exists, resolve the few things that need your judgment, check the result, and move on.

[!IMPORTANT] Current recommended version: 1.9.0. This release makes the monthly review easier to follow: bill import is split into clear structure, mapping, and preview steps, while transaction warnings, grouped views, monthly progress, and reconciliation explanations are presented more compactly. It does not introduce a database or settings migration.

Why Asset Track

• Once a month: replace continuous manual entry with a focused monthly routine.
• One financial record: different bill formats are organized into one local SQLite source of truth.
• Checkable results: asset changes and transaction data help reveal missing or inconsistent records.
• Private by default: no account, no network requests by default, no telemetry, and no cloud classification; the optional AI classifier only contacts an endpoint you explicitly configure.

The guiding idea is simple: the system handles repetitive organization; you keep the final say.

How it works

Export your bills
        ↓
Import and map the fields
        ↓
Resolve exceptions and categories
        ↓
Update month-end assets, loans, and investments
        ↓
Reconcile and review the result

Who it is for

Asset Track is a good fit if you:

• mostly pay through services such as WeChat, Alipay, or bank cards;
• do not want to maintain a daily bookkeeping habit;
• are willing to spend a little time organizing bills once a month;
• care about private ownership of financial data;
• want to understand asset changes, not only see spending charts.

What it covers

• CSV, XLSX, and XLS bill import with reusable field mappings;
• monthly transactions, accounts, loans, investments, and fixed assets;
• investment-account selection for deposits and withdrawals, with account-level monthly investment analysis;
• category and precise product, counterparty, combined, and daifu rules for repeated cleanup;
• outgoing, incoming, and investment transaction tabs with detail and grouped views;
• previewed batch edits, income/daifu conversion, and local audit records;
• optional AI classification that never writes without confirmation;
• conflict and missing-category review;
• monthly and annual spending and asset analysis;
• reconciliation between transactions and asset changes;
• local backup, restore, and data-directory migration.

Installation

1. Install Asset Track from Settings → Community plugins → Browse.

If the community directory is unavailable, download only main.js, manifest.json, and styles.css from the same GitHub Release and place them in <Vault>/.obsidian/plugins/asset-track/.

Getting started

1. Open Settings → Asset Track and choose a dedicated folder inside the current vault.
2. Create a new database in an empty folder, or load an existing one.
3. After installation, open the editor in either of these ways:
   • Click the Asset Track icon in the ribbon.
   • Press Cmd/Ctrl + P to open the command palette, then run Asset Track: Open editor.
4. Import this month’s bills, review the exceptions, update month-end assets, and save the month.

Data and privacy

Your financial data stays in the folder you choose inside your vault. Asset Track does not require an account or track financial behavior. It does not contact a server unless you explicitly configure and use the optional AI classifier; only the selected rows and category definitions needed for that request are sent to the endpoint you choose. Backups and restores are initiated by you, and disabling or uninstalling the plugin does not delete your database or backups.

About the direct filesystem access warning

Obsidian may show a Direct Filesystem Access warning because Asset Track uses desktop SQLite and local file operations. This access is used to create and open the SQLite database, keep SQLite sidecar files safe, create protection snapshots before migrations or restores, and export or restore complete backups.

The warning describes the capability class, not hidden behavior. Asset Track does not use it to scan your vault or system. The normal database path is always the data directory you choose inside the current vault: <dataDirectory>/accounting_system.db, with automatic protection snapshots under <dataDirectory>/backups/. Files outside that directory are touched only when you explicitly choose a backup export destination or restoration file.

Compatibility

• Desktop Obsidian only: macOS, Windows, and Linux.
• Version 1.9.0 requires Obsidian 1.13.0 or later. Update to the latest available 1.13.x desktop release before installing or updating.
• The plugin does not require Python, a separate Node.js installation, or a sidecar.

Read more

• User guide
• Product philosophy and design principles
• Privacy and data trust model

Developer and maintainer documentation is indexed in the documentation reading guide. Release and build procedures are in the release guide.