rja96/fireflyiii-telegram-bot repository overview

⁠Telegram Bot for Firefly III

Telegram bot to manage expenses, accounts, and transactions in Firefly III easily.

⁠🚀 Features

• Interactive menu with buttons in Telegram (/menu)
• /gasto: Quick expense registration with category and destination support
• /expenseButton: Step-by-step guided flow: origin → amount → destination → category → budget → tags → confirmation
• /assets: List asset accounts
• /cuenta: Show recent account transactions
• /refresh: Manually refresh accounts and categories cache
• Categories, budgets, and tags support for expenses
• Recent destinations tracking (most used appear first)
• TTL cache for faster responses
• User authorization via ALLOWED_USER_IDS
• Docker image available for amd64 and arm64

⁠🛠️ Quick Usage

⁠Pull image

docker pull rja96/fireflyiii-telegram-bot:latest

Or a specific version:

docker pull rja96/fireflyiii-telegram-bot:v2.0.0

⁠Docker Compose example

services:
  firefly-bot:
    image: rja96/fireflyiii-telegram-bot:latest
    container_name: firefly_bot
    env_file:
      - .env
    restart: unless-stopped
    networks:
      - firefly_net

networks:
  firefly_net:
    external: true

👉 Recommended: use a .env file for environment variables.

⁠📋 Environment Variables

⁠📚 More Info

• GitHub repository:
  https://github.com/rodrigoaguilar96/fireflyiii-telegram-bot⁠

• Changelog:
  https://github.com/rodrigoaguilar96/fireflyiii-telegram-bot/blob/main/CHANGELOG.md⁠