Counter - FAQ

Frequently Asked Questions

Basics

How do I create a counter?

Tap the + floating action button on the main screen. Fill in the counter name, choose a color, set the initial value, increment/decrement steps, and optionally assign it to a category. Tap Save to create it.

How do I increment or decrement a counter?

On the main screen, tap the + or buttons on each counter card. You can also open the counter detail screen for more options, including setting a custom value.

What are categories and how do I use them?

Categories let you organize counters into groups. When you create or edit a counter, you can assign it to a category. On the main screen, counters can be displayed grouped by category using the Categorized view mode in Settings.

How do I change the color of a counter?

Open the counter editor (long press a counter or tap the edit icon) and tap the color circle. Choose any color from the palette. The color is used for the counter card and charts.

How do I reset a counter?

Open the counter detail screen and tap the Reset option. The counter will be set back to its configured reset value (default is 0). The reset is logged in the counter history.

What is the PIN / private mode?

You can set a PIN in Settings > Security to protect private counters. When a counter is marked as private, you must enter the PIN (or use biometric unlock if enabled) to view it. The PIN is stored securely as a hash.

Can I use fingerprint to unlock private counters?

Yes. Go to Settings > Security and enable Biometric unlock. You must first set a PIN before enabling biometric authentication. Once enabled, you can use your fingerprint instead of the PIN.

How do I change the layout or view mode?

In Settings you can configure:

  • View mode – Flat list or Categorized view
  • Layout type – List or Grid arrangement
  • Item template – Different card styles for counters
Can I change the app theme?

Yes. Go to Settings and choose between Light, Dark, or System default theme. You can also enable Dynamic Color (Material You) to use your device's wallpaper-based color palette.

Advanced Counters

What are View Counters (formulas)?

View Counters are computed counters whose value is calculated from a mathematical formula referencing other counters. They update automatically when the referenced counters change.

Use the syntax c{id} to reference a counter by its ID. For example:

  • c1 + c2 – sum of counter 1 and counter 2
  • c3 * 2 – double the value of counter 3
  • c1 - c2 + c3 – combined calculation
  • (c1 + c2) / 2 – average of two counters

Standard math operators are supported: +, -, *, /, %.

How do I set custom increment/decrement steps?

When creating or editing a counter, set the Increment value and Decrement value fields. Each tap of +/− will change the counter by these amounts.

Can I set minimum or maximum limits on a counter?

Yes. In the counter editor, you can set a minimum value and/or maximum value. The counter will not go below the minimum or above the maximum. If a value exceeds the range, it will be adapted automatically.

How do I export and import my data?

Go to Settings > Backup:

  • Export – Saves all your data (counters, categories, goals, challenges, automations, logs) as a JSON file you can store anywhere.
  • Import – Restores data from a previously exported JSON file.

This is useful for backing up your data or transferring to a new device.

What are counter effects?

Counter effects add visual feedback when you tap +/−. You can choose different animation effects in Settings > Counter effects, or disable them by selecting None.

How does the counter history/log work?

Every change to a counter is logged with the timestamp, new value, delta (change amount), and whether it was a manual action, reset, or automatic change. You can view the history from the counter detail screen and use charts to visualize trends over time.

Automations (Events & Actions)

What are Events & Actions?

The Events & Actions system lets you automate tasks based on counter changes. You configure rules: when a specific event occurs on a counter, one or more actions are executed automatically.

You can enable or disable this feature in Settings > Events & Actions.

What events are available?

There are 12 event types you can use as triggers:

  • Counter Updated – Fires every time the counter changes.
  • Reached Value – Counter reaches exactly a specific value.
  • Reached Greater Value – Counter reaches or exceeds a value.
  • Reached Less Value – Counter drops below a value.
  • Multiple of Value – Counter value is a multiple of N (e.g., every 10).
  • Between Values – Counter value is between two numbers.
  • Even Value – Counter value is even.
  • Odd Value – Counter value is odd.
  • Prime Value – Counter value is a prime number.
  • Palindrome Value – Counter value is a palindrome (e.g., 121, 1331).
  • Reached Max Value – Counter hits its configured maximum.
  • Reached Min Value – Counter hits its configured minimum.
What actions can I configure?

There are 11 action types:

  • Show Notification – Display a system notification with custom text.
  • Toast Message – Show a temporary on-screen message.
  • Webhook – Send an HTTP request to a URL.
  • Telegram Message – Send a message to a Telegram chat.
  • Reset Counter – Reset the counter to its reset value.
  • Increment Another Counter – Increment a different counter.
  • Decrement Another Counter – Decrement a different counter.
  • Double Counter Value – Double the current counter value.
  • Set Counter Color – Change the counter's color.
  • Set Counter Title – Change the counter's title.
  • Tasker Intent – Send a broadcast intent for Tasker/Automate/Macrodroid.
How do I set up a Webhook?

Create an event-action rule, select Webhook as the action, and configure:

  1. URL – The endpoint to call.
  2. HTTP Method – GET, POST, PUT, PATCH, or DELETE.
  3. Headers – Optional custom headers (e.g., Content-Type).
  4. Body – Optional request body (for POST/PUT/PATCH). Supports template variables.
  5. Authentication – Optional: Bearer token, Basic auth, or API Key.
  6. Retries – Number of retry attempts on failure.
  7. Timeout – Request timeout in seconds.

Example: To send a POST request when a counter reaches 100:

Event: Reached Value = 100
Action: Webhook
  URL: https://your-api.com/notify
  Method: POST
  Body: {"counter": "{{title}}", "value": {{value}}}
How do I set up Telegram notifications?

To receive Telegram messages when events trigger:

  1. Create a Telegram bot via @BotFather on Telegram and copy the bot token.
  2. Start a conversation with your bot, then find your chat ID (you can use @userinfobot or @RawDataBot).
  3. In the app, create an event-action rule and select Telegram Message as the action.
  4. Enter your bot token and chat ID.
  5. Write your message text. You can use template variables for dynamic content.
How does Tasker/Automate/Macrodroid integration work?

The Tasker Intent action sends a broadcast intent that can be received by Tasker, Automate, Macrodroid, or other automation apps on your device.

The intent includes counter data (ID, value, title) and you can add custom extras. This lets you trigger complex automations on your phone based on counter events.

Example: Turn on a smart light when a counter reaches a target value by chaining Counter → Tasker Intent → Tasker HTTP Request to your smart home API.

Can I chain multiple actions on a single event?

Yes. You can create multiple event-action rules for the same counter and event. Each rule can have a different action, so when the event fires, all matching actions execute.

Integrations (NFC, Widgets, External)

How do NFC tags work with Counter?

You can write NFC tags that increment, decrement, or reset a specific counter just by tapping your phone on the tag.

To set up an NFC tag:

  1. Open a counter's detail screen.
  2. Select the NFC write option.
  3. Choose the action: Increment, Decrement, or Reset.
  4. Optionally set a custom step value.
  5. Hold an NFC tag near your phone to write it.

Once written, simply tap the tag to trigger the action — even from the lock screen if NFC is enabled system-wide.

You can enable or disable NFC reading in Settings.

What widgets are available?

Counter offers two widget types for your home screen:

  • Standard Widget – Shows the counter name, value, and +/−/reset buttons. Allows full interaction directly from the home screen.
  • Compact Widget – A minimal 1×1 widget showing just the counter title and value. Tap to increment.

To add a widget, long-press your home screen, select Widgets, and find Counter in the list.

What is the External Intent Receiver?

The External Intent Receiver allows other apps to control your counters via Android broadcast intents. This is useful for advanced automation with Tasker, Automate, Macrodroid, or custom scripts.

Setup:

  1. Enable it in Settings > External Integration.
  2. Optionally configure an authentication token for security.

Supported commands:

  • increment – Increase counter value (optional custom value).
  • decrement – Decrease counter value (optional custom value).
  • reset – Reset counter to its reset value.
  • set_value – Set counter to a specific value.

Intent format:

Action: com.zipangulu.counter.ACTION_EXTERNAL_COMMAND
Extras:
  counter_id (long) - required
  command (string)  - required
  value (int)       - optional
  auth_token (string) - if authentication is enabled

Tasker example: Send Intent action com.zipangulu.counter.ACTION_EXTERNAL_COMMAND with extras counter_id: 1 and command: increment.

Goals & Challenges

What types of goals can I set?

There are four goal types:

  • Reach Value – Reach a specific target value (e.g., count to 100).
  • Reach by Date – Reach a target value before a deadline date.
  • Range Goal – Keep the counter value between a minimum and maximum bound.
  • Decrease Goal – Reduce the counter below a specific target value.

Each goal can have a priority (Low, Medium, High) and can auto-complete when the target is reached.

Do I get notified when I reach a goal?

Yes. The app monitors your goals in the background and sends a notification when a goal is reached or when a deadline is approaching. You can see your goal progress on the Goals tab.

What are Challenges?

Challenges let you compete by counting as fast as possible. Create a challenge, add one or more counters, and optionally set a timer (in seconds). When the challenge starts, all selected counters can optionally be reset to zero. The challenge play screen tracks progress in real-time.

Challenges are great for competitive counting games or timed exercises.

Other

What does the Premium version include?

The Premium version removes all ads from the app. All features are available in the free version — Premium is a way to support development while enjoying an ad-free experience.

Is my data safe? Does Counter collect personal information?

All your counter data is stored locally on your device. Counter does not send your counter data to any external server. Firebase Crashlytics and Analytics are used to improve app stability and understand general usage patterns, but no personal counter data is shared.

You can review the full Privacy Policy from Settings > Privacy Policy.

How do I contact support?

Go to Settings > Contact Support. This will open your email app with diagnostic information pre-filled to help us assist you faster.

Can I delete all my data?

Yes. Go to Settings > Backup > Delete all data. This will permanently delete all counters, categories, goals, challenges, automations, and logs. This action cannot be undone, so consider exporting a backup first.

The app is in the wrong language. How do I change it?

Counter follows your device's system language. To change the app language, go to your device's Settings > Apps > Counter > Language (on Android 13+), or change your device language in Settings > System > Language.

Supported languages: English, German, Spanish, French, Italian, Portuguese, Russian, Chinese.