Month Finance

by Kiryl Harbacheuski
5
4
3
2
1
Score: 51/100

Description

Плагин для управления личными финансами прямо в Obsidian

Reviews

No reviews yet.

Stats

0
stars
400
downloads
0
forks
77
days
6
days
6
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
6
commits

README file from

Github

Finance Tracker for Obsidian

Плагин для управления личными финансами прямо в Obsidian. Данные хранятся в обычной markdown-таблице, а плагин рендерит ниже неё отдельные секции-карточки: сколько потрачено за месяц, средний расход в день, сколько отложено в сбережения и bar-график трат по категориям.

Возможности

  • 📝 Таблица — просто markdown — источник данных остаётся обычной md-таблицей, плагин её не трогает и не скрывает.
  • 💸 Потрачено за месяц и средний расход в день — расходы без сбережений. Средний расход делится на число дней, прошедших по записям таблицы, а «non-zero-days» — на число дней, в которые реально были траты.
  • 🐷 Накопления в разных валютах — карточка со списком накоплений из frontmatter totalSavings (например, 0.40 ETH, 1500 USD), а мелкой строкой — сколько отложено за месяц. Если totalSavings не задан, крупно показывается нетто за месяц.
  • 📈 Bar-график трат по категориям — горизонтальные бары с процентами и стабильными цветами категорий. Категории с точкой (Еда.Продукты) объединяются в одну строку и делятся на цветные сегменты.
  • 🎯 Бюджет по категориям — сворачиваемый блок со столбчатой диаграммой: лимиты задаются во frontmatter, заливка показывает, насколько они израсходованы.
  • � ТОП расходов — таблица самых крупных трат месяца с суммой и долей от всех расходов; сворачивается в аккордеон.
  • �🎨 UI в стиле Obsidian — использует CSS-переменные темы (тёмная и светлая), адаптирован под мобильные экраны.

Как пользоваться

  1. Установите плагин и включите его.
  2. Нажмите на иконку кошелька в ленте слева или выполните команду «Создать финансовую заметку» — будет создана заметка с текущей датой (например, 11.11.2026.md) и готовой таблицей.
  3. Записывайте операции в таблицу. Карточки обновятся автоматически.

Настройки

Плагин добавляет вкладку настроек (Настройки → Month Finance):

  • Валюта — BYN, USD, EUR, RUB или своя (произвольный символ). Используется на карточках, когда в заметке валюта не задана во frontmatter.
  • Исключать накопления из среднего расхода — если включено (по умолчанию), траты на накопления не учитываются в среднем расходе за день.
  • Доп. категории накоплений — свои ключевые слова через запятую, которые плагин будет считать накоплениями.
  • Дней в месяце — делитель для среднего расхода, когда в таблице не заполнен день.

Раздел Секции дашборда — чекбоксы, которыми можно полностью убрать блоки из заметки:

  • Показывать бюджет — включает сворачиваемый блок «Бюджет по категориям». Сами лимиты задаются в заметке (frontmatter budget), а не в настройках — они относятся к конкретному месяцу.
  • Показывать ТОП расходов — включает сворачиваемую таблицу с самыми крупными тратами месяца.
  • Сколько трат выводить — число строк, вводится вручную (от 1 до 100, по умолчанию 5). Пункт недоступен, пока таблица выключена.

Формат таблицы

Таблица должна находиться в заметке с frontmatter finance: true. Колонки распознаются по заголовкам (рус./англ.):

Колонка Заголовки (пример) Описание
День День, Day День месяца (1–31). Если пусто — берётся ближайший прошедший день
Тип Тип, Type Доход / Расход (приход/уход)
Категория Категория, Category Например: Продукты, Сбережения
Название Название, Name Что за операция
Сумма Сумма, Amount Число; знак «−» = расход, «+» = доход
---
finance: true
currency: "₽"
---

| День |  Тип   | Категория  | Название             | Сумма |
| :--: | :----: | :--------- | :------------------- | ----: |
|  01  | Доход  | Зарплата   | Зарплата за месяц    | 50000 |
|  03  | Расход | Продукты   | Продукты за неделю   | -1200 |
|  08  | Расход | Сбережения | Перевод в сбережения | -2000 |

Порядок колонок может быть любым, «Сумма» обязательна. Если тип не указан, он определяется по знаку суммы. Валюта задаётся в frontmatter (currency); если она не задана, используется валюта из настроек плагина.

Если в строке не заполнена колонка «День», плагин подставляет ближайший прошедший день — последний заполненный выше в таблице. Поэтому серию трат за одно число можно не нумеровать каждую:

| День |  Тип   | Категория | Название             | Сумма |
| :--: | :----: | :-------- | :------------------- | ----: |
|  03  | Расход | Продукты  | Продукты за неделю   | -1200 |
|      | Расход | Кафе      | Обед                 |  -15  |
|      | Расход | Транспорт | Метро                |  -2   |

Категории и подкатегории

Категорию можно задавать иерархически через точку: Еда.Продукты, Еда.Рестораны, Еда.Продукты.Молочные. На bar-графике все подкатегории одного родителя (Еда) показываются одной строкой, разделённой на сегменты в оттенках цвета родителя. Наведите курсор на сегмент — появится подсказка с названием подкатегории и суммой трат по ней; наведите на название строки — увидите разбивку по всем подкатегориям.

| День |  Тип   | Категория        | Название           | Сумма |
| :--: | :----: | :--------------- | :----------------- | ----: |
|  02  | Расход | Еда.Продукты     | Продукты за неделю | -1200 |
|  05  | Расход | Еда.Рестораны    | Ужин с друзьями    | -800  |

Бюджет по категориям

Категории можно задать лимит на месяц во frontmatter заметки — в поле budget. Лимит указывается для категории верхнего уровня (без подкатегорий):

---
finance: true
currency: "₽"
budget:
    Еда: 5000
    Транспорт: 1000
    Развлечения: 2000
---

Тогда в дашборде появляется отдельная столбчатая диаграмма «Бюджет по категориям». Все столбики одной высоты (100% = лимит), а заливка показывает, какая доля лимита уже израсходована:

  • цвет заливки совпадает с цветом категории в графике «Траты по категориям»;
  • под столбиком — название категории и сумма лимита, сверху — процент использования;
  • при превышении лимита рядом с процентом показывается перерасход в скобках (132% (−600 ₽)), красным;
  • при наведении на столбик показывается подсказка: потрачено / лимит, процент, остаток или перерасход;
  • в шапке карточки — суммарный итог по всем бюджетам с общей полосой прогресса.

Бюджет сравнивается с тратами без накоплений. Если для категории лимит задан, а трат ещё не было, она всё равно показывается с 0%.

Иерархические категории. Бюджет понимает точечную нотацию так же, как и основной график:

  • лимит на родителя (Еда: 5000) учитывает все его подкатегории — Еда.Продукты, Еда.Рестораны и т. д.;
  • лимит на подкатегорию (Еда.Продукты: 2000) считает только её траты;
  • можно задать оба сразу — в диаграмме появятся две отдельные колонки: общая по Еда и отдельная по Еда.Продукты;
  • цвет подкатегории берётся у родителя, так что визуально видно, к какой группе она относится.

Накопления. Категориям-накоплениям тоже можно задать сумму в budget — это будет цель «отложить за месяц»:

budget:
    Накопления: 5000

Считается по фактическим переводам в накопления. Для таких столбиков логика инвертирована: при достижении цели (100% и больше) процент становится зелёным, а в подсказке пишется «Цель выполнена» вместо «Перерасход».

Диаграмму можно выключить в настройках плагина (Секции дашборда → «Показывать бюджет»). Блок сворачивается кликом по заголовку — как и таблица «ТОП расходов»: справа в заголовке показывается общий процент использования бюджета (красным при перерасходе).

ТОП расходов

Ниже графиков выводится таблица «ТОП расходов» — самые крупные траты месяца:

  • строки отсортированы по сумме, рядом показана доля траты от всех расходов (без накоплений);
  • одинаковые операции (совпадают «Название» и «Категория») суммируются в одну строку, в колонке «День» тогда показывается ×N — число операций (наведите курсор, чтобы увидеть точное значение);
  • цветная точка слева совпадает с цветом категории в графике «Траты по категориям»;
  • справа в заголовке — сумма всех трат из таблицы;
  • клик по заголовку сворачивает и разворачивает таблицу (аккордеон).

Число строк и показ таблицы настраиваются в разделе Секции дашборда в настройках плагина. Если в таблице нет колонки «Название», вместо описания используется категория.

Средний расход в день

  • Средний расход в день = расходы без сбережений ÷ число дней, прошедших по календарю записей (последний день, который встречается в таблице). Если в таблице есть записи 1, 2, 7 и 8 числа, сумма делится на 8. В настройках можно включить учёт накоплений в этом расчёте.
  • Non-zero-days расход = расходы без сбережений ÷ число дней, в которые реально были траты. Для того же примера — деление на 4 (3–6 числа трат не было).

Если колонка «День» не заполнена, средний расход считается по числу дней из настроек (по умолчанию 30).

Сбережения

Расходы в категориях-сбережениях не попадают в «Потрачено за месяц» и в bar-график — они суммируются в «Накопления за месяц» и показываются мелкой строкой в карточке накоплений. По умолчанию распознаются категории, содержащие: сбережен, накоплен, savings, сэйвинг, вклад, инвест, копилка. Можно задать свою категорию в frontmatter:

---
finance: true
currency: "₽"
savingsCategory: "Сбережения"
---

Снятие из накоплений. Если в категории-накоплении указан тип Доход, это трактуется как «взяли из накоплений», и сумма вычитается из отложенного за месяц:

День Тип Категория Название Сумма
08 Расход Накопления Отложил в копилку -300
20 Доход Накопления Снял из копилки 700

Итог «Накопления в этом месяце» = 300 − 700 = −400, и подсказка в карточке накоплений покажет именно отрицательное значение.

В диаграмме бюджета отрицательного значения быть не может (нельзя «вложить минус»): если нетто по накоплениям ушло в минус, столбик показывает 0 и 0%, а в подсказке — весь лимит в «Осталось».

Общие накопления на текущий момент задаются в frontmatter totalSavings — можно одной суммой в базовой валюте, а можно списком в разных валютах (каждая запись — сумма ВАЛЮТА):

---
finance: true
currency: "₽"
totalSavings:
    - 0.40 ETH
    - 1500 USD
    - 2500 BYN
---

Эти значения показываются крупно в карточке «Всего накоплено», а «отложено в сбережения за месяц» — мелким шрифтом под ними. Если totalSavings не задан, карточка просто показывает сумму, отложенную за месяц.

Разработка

npm install
npm run dev      # watch-сборка в out/main.js
npm run build    # production-сборка с проверкой типов

Лицензия

MIT