Handy Expense Tracker User Guide
From quickly logging a transaction to text and image recognition, category management, chart summaries, and data backups, this guide explains the most common tasks on iPhone, iPad, and Mac.
At the bottom of the record list, tap “Expense” or “Income”, then choose “Add Manually”, “Add from Text”, “Add with Camera”, or “Add from Photo”.
Browse by date, category, label, or payment method, or search for keywords in amounts, merchants, and details.
Data is synced automatically through iCloud; you can also export files regularly to keep independent backups.
1. Recording transactions
1.1 Adding a record
After opening the app, tap the “Expense” or “Income” button at the bottom, then choose how to add the record:
- Add Manually: Enter the category, amount, and other information in order.
- Add from Text: Analyze text from a recording, clipboard, or manual input to create an income or expense record.
- Add with Camera: Open the camera to photograph a receipt, bill, or order.
- Add from Photo: Choose an image from your library, or share or drag and drop an image from another app into Handy Expense Tracker.
Steps for manual entry
- Category: Select the category for the record, then proceed to “Subcategory”.
- Subcategory: Select an income or expense subcategory.
- General: Enter the amount, merchant, and date. Amounts support simple calculations using
+,-, and*. - Details: Add notes; you can also use voice input.
- Payment: Select a payment method, or choose “No Payment Method”.
- Label: You can select multiple labels; tap a selected label again to deselect it.
The amount and subcategory are required. At any step from “General” through “Label”, you can tap “Add” in the upper-right corner to save without proceeding through every page.
1.2 Adding a record via camera or image
- Select: Take a photo, choose an image from your library, or share or drag and drop an image from another app.
- Image: The app tries to detect the receipt and outline it with a green selection. Check that the selection includes the entire receipt, then adjust it if needed. Under “Edit”, choose “Cut” to crop the selected area; you can also rotate or clear the image.
- Analyze: Recognize the content in the selected area; if there is no selection, the entire image is recognized.
- Confirm: Select the recognized amount, date, merchant, and category, then close the results window and continue entering information.
- Save: Check the basic information, details, payment method, and labels, then tap “Add”.
The automatic selection may miss an edge or include unrelated content. Check and adjust the selected area before tapping “Analyze”. A merchant is recognized automatically only if it has appeared in previous records and also appears in the image text.
When adding a second or additional image, the app asks “Merge with existing image?”. Choose “Yes” to append the new image below the existing one, or “No” to replace it. Image analysis retains the most recent result; when analyzing again, you can display the previous result or analyze again.
1.3 Adding income or expenses via text
At the bottom of the record list, first tap “Expense” or “Income”, then choose “Add from Text”. The app analyzes the text according to the currently selected transaction type and recommends categories from the corresponding income or expense subcategories.
- Choose a text source: Choose “Recording”, “Clipboard”, or “Enter Manually”. Recording is suitable for speaking a transaction directly, such as “Lunch at McDonald’s 20.50 today”; before using the clipboard, copy the relevant text from an order, bill, or transaction notification.
- Check the text: The transcribed text or clipboard content opens on the details editing page; when using “Enter Manually”, you can enter the description directly. We recommend including the purpose or merchant, amount, and date, such as “Salary 3500 received today” for income.
- Analyze: Tap “Analyze” and the app will find amount, date, merchant, and category information in the text.
- Confirm the results: Under “The following information was extracted”, select the amount you need; when there are multiple candidates, you can adjust the merchant, date, and category. You can continue making changes after closing the results page.
- Complete and save: If no category was recognized, tap “Next step” to manually select a category and subcategory; then check the amount, merchant, date, details, payment method, and labels, and tap “Add” in the upper-right corner to save.
Try to include the amount and its purpose in the same description. Analysis results are only candidate information awaiting confirmation. Check the transaction type, amount, date, and category before saving; any unrecognized or inaccurate field can be edited manually.
1.4 Editing records and flexible input
On iPhone or iPad, long-press a record or swipe its row to open the available actions. On Mac, right-click the record. Choose “Edit” to modify its category, subcategory, amount, merchant, date, details, payment method, labels, and images. When finished, tap “Update” in the upper-right corner on the “General”, “Details”, “Payment”, or “Label” step.
- Amounts support simple formulas, making it easy to combine multiple expenses.
- Payment methods can use different currencies; foreign-currency records display the converted amount in the app’s home currency (the main currency used for totals).
- Multiple labels can be selected, which is useful for organizing records across trips, projects, or reimbursement status.
2. Browsing and finding records
2.1 Viewing records
- On iPhone or iPad, open the navigation menu in the upper-left corner and choose “Record” to browse your records. On Mac, open “Record” from the menu bar.
- Open “Category Management” and select a subcategory to view records in that subcategory.
- Open “Label Management” or “Payment Management” to view records with the corresponding label or payment method.
- Select conditions level by level in the chart summary to view records that match them.
The record list shows year, month, and day summary cards, with the selected range highlighted. Tap an available card to change the range. In the main record list, the year card shows an annual total but cannot open the full year’s records. Record lists opened from a category, label, or payment method provide their own available date ranges. Tap the date to choose another date, or tap a record to expand its details.
2.2 Batch processing, sorting, and searching
Tap “Edit” in the upper-left corner to enter batch mode, where you can delete records, add labels, or move multiple records to another subcategory.
When the list contains multiple records, a
sorting icon appears above the first record. Tap the icon on the left to sort by time, or the icon on the right to sort by amount.
To reuse an existing record, first find it by searching or browsing a subcategory, then choose “Copy” from its context menu. Long-press the record on iPhone or iPad, or right-click it on Mac:
- Search by amountTap the search button at the bottom and enter an amount; in the search results, long-press the target record and choose “Copy” from the shortcut menu.
- Search detailsTap the search button at the bottom and enter a keyword; in the search results, long-press the target record and choose “Copy” from the shortcut menu.
- Search by subcategoryOpen “Category Management” and select the target subcategory. If there are no records for the day, use the available month or year card to widen the date range; after finding the target record, long-press it and choose “Copy” from the shortcut menu.
When you start a search from a category, label, or payment method page, results are automatically limited to the current scope.
3. Charts and quick access
View charts on the home page
Open “Chart” to see a chart directly on the home page. If the first enabled summary field is year, month, or day, the chart shows a time trend. If it is a category, subcategory, label, payment method, or merchant, it shows a pie chart. Choose “Expense” or “Income”, then select “View details” to open the corresponding summary. In a time-trend chart, “Surplus” shows income minus expenses; “View details” is disabled in this mode.
Choose summary fields and chart size
Select “Edit” next to “Summarization method and order” to enable summary fields and reorder them with the up and down arrows. On the same page, “Home chart item count” controls the number of periods or items shown. The default is 12, and the range is 3–30. Changes are saved automatically. This setting also affects the number of items or records shown on quick access cards.
Open a summary and follow its levels to reach the matching records. On pages with chart-type controls, switch between a bar chart and a pie chart.
Save a summary to quick access
- Open a summary you use often and select the star to add it to quick access. Select the star again to remove it.
- When the dates in the path match the current dates, the app asks “Do you want to always keep the date on the access path up to date?”. Choose “Yes” to keep the relevant year, month, or day current. For example, a shopping summary saved for the current month will show the new month’s shopping expenses when the month changes.
- Return to the chart home page to see the saved summary card. A card with another summary level shows a pie chart; a card that leads directly to records shows recent record amounts as a line chart. Select “View details” to open the saved page.
4. Categories, labels, and payment methods
4.1 Categories and subcategories
Open “Category Management” to add, edit, and adjust income or expense categories. When using the app for the first time, you can also select the categories you need from the built-in category list and continue modifying them to suit how you track your spending.
Importing the built-in category list
- Open the list: Open “Category Management” and tap “Import category list” in the category list.
- Choose a transaction type: Use the “Expense/Income” switch at the top to view the corresponding built-in categories.
- Select categories: Tap a category name to select or deselect all subcategories under it; you can also expand it and select subcategories individually. For batch operations, use “Select All” or “Clear Selection” at the bottom.
- Confirm the import: After making your selections, tap “Import” in the upper-right corner and confirm the operation. The app creates the selected subcategories and their parent categories, then displays the number of categories and subcategories imported.
Built-in subcategories that already exist will not appear in the selection list again. If the page says “All built-in categories have been added”, there are no more items available to import for the current transaction type.
4.2 Labels
Labels are useful for information that cannot be fully represented by categories alone, such as trips, projects, family members, or reimbursement status. A record can have multiple labels. When editing a label, enable “Automatically label new record” to apply it to new records automatically. This is useful during a trip; turn it off when the trip ends.
4.3 Payment methods
Each payment method can have its own currency. For a foreign-currency payment method, the app converts the amount to its home currency—the main currency used for totals—using the current exchange rate. Changing the amount or payment method recalculates the converted amount.
Open “Payment Management” and add or edit a payment method. Use “Currency:” to select its currency. To track its balance, enable “Balance” and enter an amount. Enable “Set as default payment method” to select it automatically for new records; you can still choose a different method when entering a record.
To adjust existing foreign-currency income, open the payment method’s context menu and choose “Adjust income at current exchange rate”. This changes existing data, so check the selected account and whether you need the adjustment first.
5. Using the Mac version
The Mac version uses the same record fields as the iPhone and iPad versions and can sync data through iCloud. The main difference is that the Mac version uses the menu bar at the top of the screen and multiple separate windows to switch between features.
From the menu bar at the top of the Mac screen, choose “Record”, “Chart”, “Category Management”, “Label Management”, or “Payment Management”. These features open in separate windows that can be used side by side on the desktop.
5.1 Window layouts
- RecordDisplays income and expense records for browsing by date and is the main window for adding, viewing, and organizing records.
- ChartSelect summary charts on the left and view the selected statistics on the right. After entering a deeper level, use the back button in the toolbar to return to the previous level.
- Category ManagementUses a three-column layout: select a category in the left column, a subcategory in the middle column, and view records under that subcategory in the right column.
- Label ManagementManage and select labels on the left and view records using the selected label on the right.
- Payment ManagementManage and select payment methods on the left and view records using the selected payment method on the right.
5.2 Settings and other features
- “Template Management”, “Purchase”, “Questions”, and “Feedback” open in auxiliary windows; selecting another item switches that window to the corresponding content.
- “Settings” and “About” can be opened from the macOS app menu.
- In the “Category Management” window, choose “Import category list” to import built-in categories and subcategories.
- Choose “Help” from the “Help” menu to reopen this manual at any time.
When adding or editing records and managing charts, categories, labels, and payment methods, the fields work as described in the earlier sections. If authentication is enabled, the app requests Touch ID or your Mac login password when verification is needed; it may not prompt again if you have already authenticated.
6. Settings, syncing, and backups
- Automatic iCloud syncUse the same iCloud account to sync data automatically across multiple devices.
- Add Record buttonUnder “When clicked”, choose “Show Entry Method Menu”, or specify one of “Add Manually”, “Add from Text”, “Add with Camera”, or “Add from Photo”. Available options vary by device.
- AuthenticateWhen enabled, the app uses Face ID, Touch ID, or the device passcode to verify your identity each time you enter the app.
- Export to FileExport categories, subcategories, records, labels, payment methods, and quick access entries as a CSV data backup. Images in records are not exported.
- Import from FileRestore data from a CSV file; records that already exist locally are ignored.
After choosing an entry method, tapping “Income” or “Expense” on the record list opens that method directly without first displaying the menu. To temporarily use another method, long-press the “Income/Expense” button on iPhone or iPad; on Mac, right-click the button.
iCloud sync keeps data consistent across devices but is not the same as a historical backup. Export important data regularly and store it securely. CSV exports do not include images, payment method balances, automatic-label settings, or all app settings, so they are not a complete app backup.
7. Managing templates
On iPhone or iPad, open the upper-left navigation menu and choose “Template Management”. On Mac, open “Template Management” from the menu bar. Create a template for recurring monthly income or expenses, such as a cloud service fee. If the selected day does not exist in a month, the app uses that month’s last day; a template set to the 31st uses February 28 or 29. When the app checks templates, it creates any due records that have not yet been generated. It does not create future-dated records in advance.
8. Issues and feedback
On iPhone or iPad, open the upper-left navigation menu and choose “Feedback”. On Mac, open “Feedback” from the menu bar. If app notification permission is disabled, a prompt appears when you open the “Questions” page; follow the instructions to open System Settings and enable notifications so you can receive replies promptly.
9. Import/export file format
Each row in the CSV file represents a category, subcategory, record, label, payment method, or quick access entry. Fields are separated by ASCII commas ,. A comma within a field is escaped as \, (a backslash followed by a full-width comma). A line break is escaped as \n (a backslash followed by a lowercase n). These sequences are decoded during import. Keep the backslashes; a full-width comma or the letter n alone is not equivalent.
Do not change IDs or the field order without good reason. Before making batch changes to a file, save the original export file and validate the changes with a small amount of test data.
9.1 Categories
| Column | Field | Description |
|---|---|---|
| 1 | Type | Fixed at 0, indicating a category row |
| 2 | Category ID | A string that uniquely identifies the category |
| 3 | Category name | The category’s display name |
9.2 Subcategories
| Column | Field | Description |
|---|---|---|
| 1 | Type | Fixed at 1, indicating a subcategory row |
| 2 | Subcategory ID | A string that uniquely identifies the subcategory |
| 3 | Subcategory name | The subcategory’s display name |
| 4 | Parent category ID | The ID of the category to which the subcategory belongs |
| 5 | Transaction type | true indicates income; false indicates expenses |
9.3 Records
| Column | Field | Description |
|---|---|---|
| 1 | Type | Fixed at 2, indicating a record row |
| 2 | Record ID | A string that uniquely identifies the record |
| 3 | Parent subcategory ID | The ID of the subcategory to which the record belongs |
| 4 | Record date | In the format year-month-day hour:minute, for example 2026-07-29 14:20 |
| 5 | Amount | The record amount, for example 100.00 |
| 6 | Record type | 0 for a normal record, 1 for an automatically generated record, and 2 for a template; preserve the original value |
| 7 | Merchant | The merchant name |
| 8 | Details | The record’s detailed text |
| 9 | Label ID | One or more label IDs, separated internally by commas. On export, each separator becomes \,, for example label-a\,label-b |
| 10 | Payment method ID | The ID of the payment method used for the record |
| 11 | Foreign-currency amount | The foreign-currency amount when a foreign-currency payment method is used |
9.4 Labels
| Column | Field | Description |
|---|---|---|
| 1 | Type | Fixed at 3, indicating a label row |
| 2 | Label ID | A string that uniquely identifies the label |
| 3 | Label name | The label’s display name |
| 4 | Label color | RGB values range from 0 to 1 and are separated by |, for example 0.5|0|0.5 |
9.5 Payment methods
| Column | Field | Description |
|---|---|---|
| 1 | Type | Fixed at 4, indicating a payment method row |
| 2 | Payment method ID | A string that uniquely identifies the payment method |
| 3 | Payment method name | The payment method’s display name |
| 4 | Currency code | The currency used by the payment method, for example USD |
9.6 Quick access
Quick access entries are included in the export. Their fields restore saved summary conditions. Keep the original values rather than editing them manually.
| Column | Field | Description |
|---|---|---|
| 1 | Type | Fixed at 5, indicating a quick access entry |
| 2 | Quick access ID | A string that uniquely identifies the entry |
| 3 | Transaction type | 1 indicates income; 0 indicates expenses |
| 4 | Summary fields | The fields used in the saved path; preserve the original value |
| 5 | Condition values | The values corresponding to the summary fields; preserve the original value |
| 6 | Remaining summary fields | The fields available for further summary levels; preserve the original value |
Comments
Comments are reviewed before they appear below the article.
No comments yet. Be the first to comment.