> ## Documentation Index
> Fetch the complete documentation index at: https://docs.habitify.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Timer

Timer is a built-in tool for any habit where the goal is measured in time rather than a simple checkbox. Instead of doing the activity and then trying to remember how long it actually took, you start the Timer, do the habit, and let Habitify log the time for you automatically.

Timer comes in three modes, so you can pick whichever fits the way you actually work:

* **Countdown**: counts down from a set duration, ideal when you know exactly how long you want to spend on something.
* **Stopwatch**: counts up with no fixed end, ideal when you don't know in advance how long the activity will take.
* **Pomodoro**: alternates focused work intervals with short breaks, ideal for tasks that benefit from structured bursts of concentration.

<Note>
  Timer is available on any habit with a goal measured in based-unit as 'minute' or 'hour'.
</Note>

Here's the guide to use Timer with Habitify to track progress of your habits with duration goal.

<Tabs>
  <Tab title=" iOS">
    <iframe src="https://drive.google.com/file/d/1AJscq-OhekkPpfNtFcW2_o9hif6ehNim/preview" width="640" height="360" />

    ## Starting a Timer session

    ### Starting a Countdown session

    <img src="https://mintcdn.com/habitify/MAfqQ4cs4NjrqKsk/images/Timer-Countdown-iOS.png?fit=max&auto=format&n=MAfqQ4cs4NjrqKsk&q=85&s=c0044ea15c4f6478472ef0cbf6a280c3" alt="Timer Countdown I OS" width="3964" height="2230" data-path="images/Timer-Countdown-iOS.png" />

    1. In *Journal*, navigate to the habit, and tap the **'⏱️ Timer'** smart button next to it.
    2. In the screen of *Timer*, Tap to open **'Countdown'** tab.
    3. Adjust the duration length for your session.<br />*Optionally*, in case you want some white noise, tap *'၊၊||၊ No background sound'* and choose one from the list, then tap **'***Done***'** button in the top right corner. Otherwise, tap *'Cancel'*.
    4. Tap the **'Start'** button to begin your session.

    ### Starting a Pomodoro session

    <img src="https://mintcdn.com/habitify/MAfqQ4cs4NjrqKsk/images/Timer-Pomodoro-iOS.png?fit=max&auto=format&n=MAfqQ4cs4NjrqKsk&q=85&s=3b689671e1c1757b6426f1c081c110ce" alt="Timer Pomodoro I OS" width="3979" height="2238" data-path="images/Timer-Pomodoro-iOS.png" />

    1. In *Journal*, navigate to the habit, and tap the **'⏱️ Timer'** smart button next to it.
    2. In the screen of *Timer*, tap to open '**Pomodoro**' tab.
    3. Adjust the duration length for your session.
       1. **Number of Pomodoros**: Choose the number of working intervals during the session. The maximum is 30.
       2. **Pomodoro Duration**: Set the duration of each working interval. Maximum is 23 hours 59 minutes per interval.
       3. **Breaks**:
          * *Short Break Length*: Define the length of each short break between 2 working intervals
          * *Long Break*: Configure the below settings and tap **'Done'** to save.
            * *Pomodoros before long break*: Set the number of working interval to complete before reaching the long break.
            * *Long break length*: Defind the length of each long break.
    4. Optionally, in case you want some white noise, tap *'***၊၊*||*၊ *No background sound***\*'\* under the habit name, and choose one from the list.<br />Tap **'Done'** button in the top right corner to save the change. Otherwise, tap \*'\***Cancel'**.
    5. When everything is set, tap **'Start'** button to begin the focus session.

    ### Starting a Stopwatch session

    <img src="https://mintcdn.com/habitify/MAfqQ4cs4NjrqKsk/images/Timer-Stopwatch-iOS.png?fit=max&auto=format&n=MAfqQ4cs4NjrqKsk&q=85&s=0dcdec5f588bfd203af3012d35f7589b" alt="Timer Stopwatch I OS" width="3942" height="2217" data-path="images/Timer-Stopwatch-iOS.png" />

    1. In *Journal*, navigate to the habit, and tap the **'⏱️ Timer'** smart button next to it.
    2. In the screen of *Timer*, Tap to open '**Stopwatch**' tab.
    3. Optionally, in case you want some white noise, tap '*၊၊||၊ No background sound*' and choose one from the list.<br />Then tap '*Done*' button in the top right corner to save the change. Otherwise, tap '*Cancel*'.
    4. Tap the '**Start'** button to begin your session.

    ## During a Timer session

    ### Pausing or stopping the session

    * **To pause the running session**, tap the '**⏸ Pause'** button under the time counter.<br />Later, tap the '**▶︎ Resume**' button to let it continue counting the time,
    * **To stop the running session**, tap the **'◼Stop'** button in the top right corner, tap '**Stop**' again to confirm, then choose between:
      * **'Save'**: to log the counted time to your habit's progress
      * **'Enter Different Duration'**: to log a custom value of your own to the habit's progress.
      * **'Discard'** (in the top left corner): to save nothing.
      * Optionally, tap **'Notes (optional)'** to conveniently add a note to your habit.

    ### Following habit's checklist

    <img src="https://mintcdn.com/habitify/MAfqQ4cs4NjrqKsk/images/Timer-Checklist-iOS.png?fit=max&auto=format&n=MAfqQ4cs4NjrqKsk&q=85&s=920b6ca435bddd16dc3943fd8198419f" alt="Timer Checklist I OS" width="3066" height="1725" data-path="images/Timer-Checklist-iOS.png" />

    1. Tap the **'⫶☰ #/# tasks'** under the habit name
    2. View and check in your checklist.
    3. Tap ⨂ button in the top right corner of the checklist to close.

    ### Controling background sound

    <img src="https://mintcdn.com/habitify/MAfqQ4cs4NjrqKsk/images/Timer-BackgroundSound.png?fit=max&auto=format&n=MAfqQ4cs4NjrqKsk&q=85&s=b8ab80ea0676398df18964ab766d8399" alt="Timer Background Sound" width="3014" height="1695" data-path="images/Timer-BackgroundSound.png" />

    In addition, **to control the background sound** while the counter is working:

    1. Tap the **၊၊||၊ button** under the habit name,
    2. Choose 'None' (to turn it off), or choose a white noise from the list
    3. Tap **'Save'** to save the change. <br />Otherwise, tap '**Cancel'** to discard any changes.

    ## FAQs

    <Accordion title="How to change the sound at the end of a session?">
      Currently, it is impossible to change or customize the ending sound of a timer session.
    </Accordion>

    <Accordion title="How to turn off the sound when a session ends?">
      To turn off the sound of timer, please turn your phone to silent mode, or just switch the button on the left side of the phone.
    </Accordion>

    <Accordion title="The timer suddenly stops. How to fix it?">
      You may once experience sudden stops with the timer session. Here are the steps to troubleshoot & resolve this issue.

      **1/ Check App Permissions**

      Ensure that Habitify has the necessary permissions to run uninterrupted:

      * Open **Settings**.
      * Scroll down and tap on **Habitify**.
      * Ensure that all relevant permissions, such as **Background App Refresh** and **Notifications**, are enabled.

      **2/ Check for Software Updates**

      Ensure both Habitify and your device's operating system are up to date:

      * Open the **App Store**
      * Search for Habitify and open the app page
      * If an update is available, tap **Update**.
      * Additionally, check for any available iOS or Android updates by going to **Settings** > **General** > **Software Update**.

      **3/ Avoid Power Saving Mode**

      Ensure that your device is not in power-saving mode, which can limit app functionality:

      * Open **Settings**.
      * Go to **Battery**.
      * Ensure that **Low Power Mode** is turned off.
    </Accordion>
  </Tab>

  <Tab title="🤖 Android">
    <iframe src="https://drive.google.com/file/d/17S2aXYnFABFiZWAsXu4oRVJRX1uIn_gJ/preview" width="640" height="360" />

    ## Starting a Timer session

    ### Starting a Countdown session

    <img src="https://mintcdn.com/habitify/MAfqQ4cs4NjrqKsk/images/Timer-Countdown-Android.png?fit=max&auto=format&n=MAfqQ4cs4NjrqKsk&q=85&s=2f181c1cdc93059a752e9796d6f5e217" alt="Timer Countdown Android" width="3515" height="1977" data-path="images/Timer-Countdown-Android.png" />

    1. In *Journal*, make sure you open the Daily View.
    2. Navigate to the habit, and tap the **'⏱️ '** smart button next to it.
    3. In the screen of *Timer*, Tap to open **'Countdown'** tab.
    4. Adjust the duration length for your session.<br />Optionally, in case you want some white noise, tap '♪' in the top right corner, and choose one from the list.
    5. Tap the **'Start'** button to begin your session.

    ### Starting a Pomodoro session

    <img src="https://mintcdn.com/habitify/MAfqQ4cs4NjrqKsk/images/Timer-Pomodoro-Android.png?fit=max&auto=format&n=MAfqQ4cs4NjrqKsk&q=85&s=b65ea1dfff15ccc316aa9f75002a611c" alt="Timer Pomodoro Android" width="3607" height="2029" data-path="images/Timer-Pomodoro-Android.png" />

    1. In *Journal*, make sure you open the Daily View.
    2. Navigate to the habit, and tap the **'⏱️ '** smart button next to it.
    3. In the screen of *Timer*, tap to open '**Pomodoro**' tab.
    4. Adjust the duration length for your session.
       1. **Number of Pomodoros**: Choose the number of working intervals during the session. The maximum is 30.
       2. **Pomodoro Duration**: Set the duration of each working interval. Maximum is 23 hours 59 minutes per interval.
       3. **Short Break Length**: Define the length of each short break between 2 working intervals
       4. **Long Break**: Set the number of working interval to complete before reaching the long break.
       5. **Long break length:** Defind the length of each long break.
    5. Optionally, in case you want some white noise, tap '♪' in the top right corner, and choose one from the list.
    6. When everything is set, tap **'Start'** button to begin the focus session.

    ### Starting a Stopwatch session

    <img src="https://mintcdn.com/habitify/MAfqQ4cs4NjrqKsk/images/Timer-Stopwatch-Android.png?fit=max&auto=format&n=MAfqQ4cs4NjrqKsk&q=85&s=07a8dd9ec10238e95050383f5a8f1b37" alt="Timer Stopwatch Android" width="3583" height="2015" data-path="images/Timer-Stopwatch-Android.png" />

    1. In *Journal*, make sure you open the Daily View.
    2. Navigate to the habit, and tap the **'⏱️ Timer'** smart button next to it.
    3. In the screen of *Timer*, Tap to open '**Stopwatch**' tab.
    4. Optionally, in case you want some white noise, tap '♪' in the top right corner, and choose one from the list.
    5. Tap the '**Start'** button to begin your session.

    ## During a Timer session

    ### Pausing or stopping the session

    * **To pause the running session**, tap the '**⏸ Pause'** button under the time counter.<br />Later, tap the '**▶︎ Resume**' button to let it continue counting the time,
    * **To stop the running session**, tap the **'◼Stop'** button in the top left corner, tap '**Stop**' again to confirm, then choose between:
      * **'Save and Close'**: to log the counted time to your habit's progress
      * **'Enter Different Duration'**: to log a custom value of your own to the habit's progress.
      * **'x'** (in the top left corner): to save nothing.

    ### Following habit's checklist

    <img src="https://mintcdn.com/habitify/MAfqQ4cs4NjrqKsk/images/Timer-Checklist.png?fit=max&auto=format&n=MAfqQ4cs4NjrqKsk&q=85&s=46ed0191d26169c41bb2c836af4296fd" alt="Timer Checklist" width="2421" height="1362" data-path="images/Timer-Checklist.png" />

    1. Tap the **'≔ #/# tasks'** under the habit name
    2. View and check in your checklist.
    3. Tap outside the checklist to close it.

    ### Controling background sound

    <img src="https://mintcdn.com/habitify/MAfqQ4cs4NjrqKsk/images/Timer-Background-Android.png?fit=max&auto=format&n=MAfqQ4cs4NjrqKsk&q=85&s=1fc9665f32fddf6124e58336980a96ec" alt="Timer Background Android" width="2697" height="1517" data-path="images/Timer-Background-Android.png" />

    In addition, **to control the background sound** while the counter is working:

    1. Tap the ♪ **button** in the top right corner.
    2. Choose 'None' (to turn it off), or choose a white noise from the list

    ## FAQs

    <Accordion title="How to change the sound at the end of a session?">
      Currently, it is impossible to change or customize the ending sound of a timer session.
    </Accordion>

    <Accordion title="How to turn off the sound when a session ends?">
      The ending sound of timer can be configured using the sound button on the side of the phone, separately with the settings of your device.
    </Accordion>

    <Accordion title="The timer suddenly stops. How to fix it?">
      You may once experience sudden stops with the timer session. Here are the steps to troubleshoot & resolve this issue.

      **1/ Check App Permissions**

      Ensure that Habitify has the necessary permissions to run uninterrupted:

      * Open **Settings**.
      * Scroll down and tap on **Habitify**.
      * Ensure that all relevant permissions, such as **Background App Refresh** and **Notifications**, are enabled.

      **2/ Check for Software Updates**

      Ensure both Habitify and your device's operating system are up to date:

      * Open the **Play Store**
      * Search for Habitify and open the app page
      * If an update is available, tap **Update**.
      * Additionally, check for any available iOS or Android updates by going to **Settings** > **General** > **Software Update**.

      **3/ Avoid Power Saving Mode**

      Ensure that your device is not in power-saving mode, which can limit app functionality:

      * Open **Settings**.
      * Go to **Battery**.
      * Ensure that **Low Power Mode** is turned off.
    </Accordion>
  </Tab>

  <Tab title="🖥️ Website & Desktop">
    <Note>
      Currently in the Website & Desktop apps, only Countdown Timer is supported
    </Note>

    <iframe src="https://drive.google.com/file/d/12qnrjuWdfpbSXvdecCoojyRNUbFZtwsU/preview" width="640" height="360" />

    ## Starting a Timer session

    <Steps>
      <Step title="Open the Timer screen">
        * In Grid layout, right-click the cell and choose 'Start timer
        * In List layout, hover your cursor on the habit, then click on '⏱️'
      </Step>

      <Step title="Configure the session duration">
        * Click on the field of duration value
        * Choose one pre-defined value from the list.

        <Note>
          Currently, website & desktop app does not support to configure a custom value for the duration of a timer session.
        </Note>
      </Step>

      <Step title="Start the session">
        * Click the '**Start Session**' button to begin
      </Step>
    </Steps>

    ## During a Timer session

    While a session is running, you can pause or stop it in midway.

    * **To pause**: click the 'Pause' button under the clock. Later, you can click the 'Continue' button to resume the session.
    * **To stop**: click the 'Stop' button under the clock. In Confirmation, click 'Discard Session' to confirm and close the timer.

    <Note>
      Currently, in the website & desktop app, stopping a running session will not give you the option to directly log the counted time to your habit's progress.
    </Note>
  </Tab>
</Tabs>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.