💰 Finance Manager — Obsidian Plugin

Track income and expenses directly in your Obsidian notes.
Each note is a separate account (cash, card, crypto wallet, etc.).

Translations: 🇷🇺 Документация на русском языке (Russian)

Version: 2.2.0 | Min Obsidian Version: 1.8.7

---

Installation

Option 1: Manual

npm install
npm run build

Copy the contents of dist/ to .obsidian/plugins/finance-manager/

Then: Obsidian Settings → Community plugins → enable Finance Manager.

Option 2: Via BRAT

1. Install BRAT plugin (Beta Reviewers Auto-update Tool)
2. Run command: BRAT: Add a beta plugin for testing
3. Enter repo: https://github.com/dimanchello/obsidian-finance
4. Confirm → plugin installs automatically

---

Language

Plugin auto-detects language from Obsidian settings:

• 🇷🇺 Russian (default)
• 🇬🇧 English

---

Usage

Insert in any note:

```finance-account
```

On first open the plugin automatically inserts an id: <hex> line into the block — a unique account identifier. This lets you rename or move the note without losing data.

Use Insert account template command from the command palette.

---

Features

Tab Navigation

Each account has four tabs, switched via the ••• menu:

• Records — income and expenses
• Debts — debt tracking
• Credits — loans with payment schedules
• Deposits — savings with interest accruals

Account

Name	Click the title → edit inline
Currency	Click the badge next to the title → select from list or custom

Records

• Only Amount is required
• Date and Time side by side
• Smart autocomplete: entering a category or payer auto-fills amount, tag, and the other field from the last matching record (shows "✨ data substituted" badge)
• Note — visually highlighted with accent color
• Internal operations: 🔄 button in the "Payer" field marks a record as internal — excluded from stats. Filter "Internal" in the filter panel shows only such records.
• Calculator: 🧮 button in the amount field opens a built-in calculator

Table

• Desktop: full table with sticky header
• Mobile: each record renders as a card with field labels
• Column visibility: show/hide columns via ⚙️ menu — settings persist across Obsidian restarts

Filters & Sorting

• Search across all fields
• Filter by type (income/expense), category, tag, payer, dates
• Sort by date, amount, category, date added
• Filter state persists per note

Analytics

• Statistics: income, expenses, balance (including debts)
• Charts by category and month

Attachments

• Photo receipts and documents
• Attached to records and open in Obsidian

Import / Export

Export: CSV, JSON, XML

Import:

1. Select file (.csv / .json / .xml)
2. For JSON — specify array path (e.g. data.records)
3. For XML — specify record tag (auto-detected)
4. Map file fields to account fields
5. Choose type detection: by field, by amount sign, or all income/expense
6. Click "Import"

Exchange rate is imported only when explicitly specified in the file and not equal to 1. Empty value or rate = 1 is not stored.

Debts

• Two directions: "Owed to me" (lent) and "I owe" (borrowed)
• Payment tracking: borrow → repay
• Auto-calculated balance accounting for all additional disbursements
• Interest rate and due date
• Filters by status (paid/unpaid), direction, person, dates
• Movement history for each debt

Credits

• Types: consumer, auto loan, mortgage
• Monthly payment schedule
• Automatic payment creation and expense records
• Early repayment (reduce amount or term)
• Status tracking: active / paid

Deposits

• Types: term, demand, savings
• Automatic interest calculation based on actual calendar days (rate × days / 365)
• Accrual type: to account or capitalization
• Top-ups and partial withdrawals
• Automatic income records on interest accrual
• Automatic deposit closure at term end

Plugin Settings

• Default currency for new accounts
• Currency management: add, remove, reorder currencies via drag-and-drop
• Records per page

Commands

Find orphaned accounts — shows data folders whose id does not appear in any note. This can happen if a note was deleted or its finance-account block was removed. The command lets you delete such folders manually.

---

Data Structure

Data is stored in .obsidian/plugins/finance-manager/accounts/{accountId}/ in separate JSON files:

.obsidian/plugins/finance-manager/accounts/{accountId}/
  meta.json       # name, currency, accent color, note path
  records.json    # income/expense records
  debts.json      # debts
  credits.json    # credits
  deposits.json   # deposits
  exchanges.json  # currency exchanges
  state.json      # filter state and column visibility settings

meta.json

{
  "version": 4,
  "name": "Sberbank Card",
  "currency": "₽",
  "accentColor": "#7c3aed"
}

records.json

{
  "version": 4,
  "records": [
    {
      "id": "uuid",
      "createdAt": 1700000000000,
      "date": "2024-11-15",
      "time": "14:30",
      "type": "expense",
      "amount": 1500.00,
      "category": "Groceries",
      "tag": "food",
      "payer": "Ivan",
      "note": "Supermarket",
      "attachmentPath": "",
      "isInternal": false
    }
  ],
  "categories": ["Groceries", "Transport"],
  "tags": ["food"],
  "payers": ["Ivan"]
}

---

Development

npm run dev     # Watch mode
npm run build   # Build to dist/
npm test        # Unit tests
npm run lint    # ESLint check

---

Roadmap

• CRUD records with date and time
• Inline account name editing
• Per-account currency
• Filters and sorting with persistence
• Pagination
• Statistics (income/expenses/balance)
• Smart autocomplete
• Attachments (photo receipts)
• Import CSV/JSON/XML with field mapping
• Export CSV/JSON/XML
• Mobile responsive layout
• Debt system
• Analytics with charts
• Multi-language (RU/EN)
• Internal operations (excluded from stats)
• Credit management
• Deposit management
• Auto-accruals for deposits and payments for credits
• Table column visibility
• Built-in calculator

---

License

MIT