Android · Tasker / MacroDroid

Tasker, MacroDroid and app links

Recognize text or save prepared transactions from your own Android workflows.

Before you start

  • Budget AI and your chosen automation app installed.
  • Recognizing text uses Budget AI’s AI limits and internet access. Prepared fields are saved without recognition.

Step by step

  1. Copy a link from Budget AI

    Install and open Budget AI, then open Settings → Automation links. Tap the action you need to copy its link.

    Screenshot coming soon
    Copy a link from Budget AI

  2. Choose a trigger in your automation app

    In Tasker or MacroDroid, choose the event that should start the workflow, such as a bank SMS or notification. Give that tool the permissions it needs. Filter by sender or bank app and payment keywords.

    Screenshot coming soon
    Choose a trigger in your automation app

  3. Prepare the data and open the link

    Pass the event text to recognize_text, or extract the fields with your own rules or AI and use add_transaction. Configure an action that opens the resulting URI in Budget AI. URL-encode parameter values before inserting them.

    Screenshot coming soon
    Prepare the data and open the link

  4. Test one transaction

    Run the workflow once with sample data. Check the amount, type, account and category. Then test a real trigger on your phone, including while it is locked; background launches depend on Android and the automation tool.

    Screenshot coming soon
    Test one transaction

Useful details

Budget AI recognizes the text

The recognize_text link uses the same recognition flow as text and voice input. One result opens for review; multiple results open together for confirmation. Internet access and the app’s AI usage limits apply.

Your rules or your AI

Use add_transaction for one prepared transaction or add_transactions for a list. These actions save fields without Budget AI recognition or the entry form. Your chosen AI service has its own terms and costs.

Quick access to input

Use voice to start voice input, scan to open the scanner, or transaction_form to open a new transaction form. Copy the corresponding links from settings.

Link formats and transaction fields

Replace the sample values with your data. Use category and account names from Budget AI.

Recognize text and review

budgetai://recognize_text?text=Coffee%206.50%20and%20taxi%2012

Save one prepared transaction

budgetai://add_transaction?amount=6.50&type=expense&currency=USD&note=Coffee

Save a list: URL-encoded JSON in items

budgetai://add_transactions?items=%5B%7B%22amount%22%3A6.5%2C%22type%22%3A%22expense%22%7D%2C%7B%22amount%22%3A500%2C%22type%22%3A%22income%22%7D%5D

Open voice input, the scanner or the form

budgetai://voice
budgetai://scan
budgetai://transaction_form
Parameters for add_transaction and objects in items
FieldValue
amountRequired positive number, such as 6.50. Use type for expense or income.
typeexpense or income. If omitted, the category type is used; otherwise it defaults to expense.
category / subcategoryAn existing name or ID; names are matched without case sensitivity. A subcategory belongs to the supplied category. Omit category to save an uncategorized transaction.
accountExisting account name or ID. If omitted, the selected account is used, otherwise the first account.
currencyCurrency code such as USD or EUR. Defaults to the account’s currency, or the app default when there is no account.
date / noteOptional ISO 8601 date and note. The date defaults to now.

Encode each parameter value, not the entire URL. Spaces can be %20 or +; a literal + must be %2B and & must be %26. For add_transactions, encode the JSON array as the items value. Unknown names or currency codes produce an error. A batch can be partly saved: check the result before repeating it to avoid duplicates.

Choose what your workflow forwards

Filter out codes, passwords and unrelated messages in Tasker or MacroDroid before passing data to Budget AI or another AI. Built-in auto-tracking stop words do not filter your external workflow before it sends data. Choose a single trigger per payment to avoid processing both its SMS and notification.

These custom links can open Budget AI; their launch behavior depends on Android and the automation tool.

Video walkthrough

Video coming soon

For now, follow the complete written steps above.