what is actual-expense-logger fr?

dominatos/actual-expense-logger — explained in plain English

Analysis updated 2026-05-18

★ 4TypeScriptAudience · developerComplexity · 3/5Setup · moderate

vibe map

mindmap
  root((actual-expense-logger))
    What it does
      Logs expenses via Telegram chat
      Parses US and European numbers
      Picks category via chat buttons
    Tech stack
      TypeScript
      Docker and Docker Compose
      Actual Budget API
    Key features
      Multiple account support
      Automatic backups before writes
      Duplicate submission guard
    Use cases
      Log expenses on the go from Telegram
      Run a private self hosted budgeting bot
      Restrict bot access to specific users
    Audience
      Actual Budget users
      Self hosting hobbyists
      Developers wanting a Telegram bot example

mindmap root((actual-expense-logger)) What it does Logs expenses via Telegram chat Parses US and European numbers Picks category via chat buttons Tech stack TypeScript Docker and Docker Compose Actual Budget API Key features Multiple account support Automatic backups before writes Duplicate submission guard Use cases Log expenses on the go from Telegram Run a private self hosted budgeting bot Restrict bot access to specific users Audience Actual Budget users Self hosting hobbyists Developers wanting a Telegram bot example

what do people make with this?

VIBE 1

Log everyday expenses into Actual Budget by chatting with a Telegram bot.

VIBE 2

Manage expenses across multiple named budget accounts from one bot.

VIBE 3

Restrict who can use the bot to a specific list of Telegram users.

VIBE 4

Self host the bot with Docker alongside an existing Actual Budget server.

what's the stack?

TypeScriptNode.jsDockerDocker Compose

how it stacks up fr

	dominatos/actual-expense-logger	0labs-in/vision-link	alfons-fhl/cursor-plan2api
Stars	4	4	4
Language	TypeScript	TypeScript	TypeScript
Setup difficulty	moderate	moderate	moderate
Complexity	3/5	3/5	3/5
Audience	developer	developer	developer

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Requires a self-hosted Actual Budget server and a Telegram bot token from BotFather, Node.js 22+ needed if not using Docker.

The README does not state a license, so terms of use are not specified.

in plain english

This project is a Telegram chat bot that lets someone quickly log an expense into Actual Budget, a self hosted personal budgeting tool, just by sending a message. A user simply types an amount like 15 or 15.50 into the chat, and the bot understands both US style numbers and European style numbers written with a comma. The bot then shows a set of clickable category buttons so the user can pick which budget category the expense belongs to, and it records the transaction into a chosen budget account. The bot supports setting up either a single default account, which requires no extra selection step, or multiple named accounts a user can choose between per transaction. It is written in TypeScript and has 66 automated tests. To protect against mistakes like double tapping a button and creating the same expense twice, it uses a guard that blocks a second submission while one is still being processed. Before saving any new transaction, it makes a backup copy of the budget data, and it keeps only the five most recent backups to avoid filling up disk space. If the bot is shut down, it makes sure to finish saving and syncing data first rather than losing anything mid operation. Running the bot requires a Telegram bot token, obtained for free from Telegram's official bot creation account, a working self hosted Actual Budget server, and a set of configuration values such as the server address, password, and sync ID, all placed in a configuration file. Access can be restricted to specific Telegram user accounts by listing their IDs, and the bot refuses all messages if that list is left empty. Sensitive values like passwords can also be supplied through Docker secrets rather than a plain configuration file, which is the recommended approach for real deployments. The project can be run either with Docker and Docker Compose, which is the suggested method and includes persistent storage for cached budget data, or run directly on a machine with Node.js version 22 or newer by installing dependencies and building the TypeScript code.

prompts (copy fr)

prompt 1

Walk me through setting up the .env file for actual-expense-logger.

prompt 2

Help me deploy actual-expense-logger with Docker Compose and secrets.

prompt 3

Explain how the bot's backup and sync process works before saving a transaction.

prompt 4

Show me how to configure multiple Actual Budget accounts for this bot.

Frequently asked questions