mattyfaz/actualtap repository overview

⁠Actual Tap

A Fastify API service that automatically creates transactions in Actual Budget when you use Tap-to-Pay on your mobile device.

⁠Overview

Actual Tap bridges the gap between mobile payments and your Actual Budget, making expense tracking seamless and automatic. When you tap to pay with your mobile device, Actual Tap receives the transaction details and automatically creates the corresponding entry in your Actual Budget.

⁠Key Features

• 🚀 Fast and lightweight Fastify API
• 💳 Automatic transaction creation from Tap-to-Pay
• 📱 Mobile automation support (iOS Shortcuts & Android Tasker)
• 🔒 Secure API key authentication
• 🐳 Easy deployment with Docker
• 🔄 Real-time transaction syncing with Actual Budget

⁠Quick Start

docker run -p 3001:3001 \
  -e TZ=your_timezone \
  -e API_KEY=your_api_key \
  -e ACTUAL_URL=your_actual_url \
  -e ACTUAL_PASSWORD=your_password \
  -e ACTUAL_SYNC_ID=your_budget_id \
  -e ACTUAL_ENCRYPTION_PASSWORD=your_encryption_password \ # optional
  mattyfaz/actualtap

⁠Docker Compose

services:
  actualtap:
    container_name: actualtap
    image: mattyfaz/actualtap:latest
    restart: always
    ports:
      - 3001:3001
    environment:
      - TZ=
      - API_KEY=
      - ACTUAL_URL=
      - ACTUAL_PASSWORD=
      - ACTUAL_SYNC_ID=
      - ACTUAL_ENCRYPTION_PASSWORD=

⁠Environment Variables

⁠Documentation

For detailed setup instructions, including mobile automation configuration, visit our GitHub repository⁠.

⁠License

GPL-3.0