{
  "language": "en",
  "name": "Clock",
  "packageId": "com.adrianillo.clock",
  "minimumAndroid": "7.0",
  "appLanguageSource": "Android",
  "projectVersion": "1.3.1",
  "reviewed": "2026-11-10",
  "modified": "2026-11-10",
  "url": "https://clock.adrianillo.name/manual/en/",
  "landingUrl": "https://clock.adrianillo.name/en/",
  "summary": "Learn to set your alarms, run several countdowns and check the time in other cities. Choose a task to get started.",
  "offline": "All five functions work offline, including city search.",
  "screenshots": {
    "alarm-list": {
      "caption": "Alarm list",
      "light": "https://clock.adrianillo.name/manual/assets/screenshots/en/alarm-list--light.png",
      "dark": "https://clock.adrianillo.name/manual/assets/screenshots/en/alarm-list--dark.png"
    },
    "alarm-menu": {
      "caption": "Hold an alarm to open its options",
      "light": "https://clock.adrianillo.name/manual/assets/screenshots/en/alarm-menu--light.png",
      "dark": "https://clock.adrianillo.name/manual/assets/screenshots/en/alarm-menu--dark.png"
    },
    "alarm-reorder": {
      "caption": "Choose Reorder to reveal the drag handles",
      "light": "https://clock.adrianillo.name/manual/assets/screenshots/en/alarm-reorder--light.png",
      "dark": "https://clock.adrianillo.name/manual/assets/screenshots/en/alarm-reorder--dark.png"
    },
    "alarm-reordered": {
      "caption": "The alarm changes position after dragging",
      "light": "https://clock.adrianillo.name/manual/assets/screenshots/en/alarm-reordered--light.png",
      "dark": "https://clock.adrianillo.name/manual/assets/screenshots/en/alarm-reordered--dark.png"
    },
    "alarm-next": {
      "caption": "Pull the list down to reveal the next-alarm countdown",
      "light": "https://clock.adrianillo.name/manual/assets/screenshots/en/alarm-next--light.png",
      "dark": "https://clock.adrianillo.name/manual/assets/screenshots/en/alarm-next--dark.png"
    },
    "alarm-editor": {
      "caption": "Alarm time, days and weekly repeat",
      "light": "https://clock.adrianillo.name/manual/assets/screenshots/en/alarm-editor--light.png",
      "dark": "https://clock.adrianillo.name/manual/assets/screenshots/en/alarm-editor--dark.png"
    },
    "alarm-sound": {
      "caption": "Tone, alert type, volume and gradual increase",
      "light": "https://clock.adrianillo.name/manual/assets/screenshots/en/alarm-sound--light.png",
      "dark": "https://clock.adrianillo.name/manual/assets/screenshots/en/alarm-sound--dark.png"
    },
    "tone-picker": {
      "caption": "Preview and choose a tone or add your own audio",
      "light": "https://clock.adrianillo.name/manual/assets/screenshots/en/tone-picker--light.png",
      "dark": "https://clock.adrianillo.name/manual/assets/screenshots/en/tone-picker--dark.png"
    },
    "alarm-type": {
      "caption": "Choose sound, vibration or both",
      "light": "https://clock.adrianillo.name/manual/assets/screenshots/en/alarm-type--light.png",
      "dark": "https://clock.adrianillo.name/manual/assets/screenshots/en/alarm-type--dark.png"
    },
    "alarm-actions": {
      "caption": "Light sensitivity and actions for light or shaking",
      "light": "https://clock.adrianillo.name/manual/assets/screenshots/en/alarm-actions--light.png",
      "dark": "https://clock.adrianillo.name/manual/assets/screenshots/en/alarm-actions--dark.png"
    },
    "alarm-details": {
      "caption": "Volume buttons, snooze, duration and name",
      "light": "https://clock.adrianillo.name/manual/assets/screenshots/en/alarm-details--light.png",
      "dark": "https://clock.adrianillo.name/manual/assets/screenshots/en/alarm-details--dark.png"
    },
    "snooze-picker": {
      "caption": "Choose the snooze interval",
      "light": "https://clock.adrianillo.name/manual/assets/screenshots/en/snooze-picker--light.png",
      "dark": "https://clock.adrianillo.name/manual/assets/screenshots/en/snooze-picker--dark.png"
    },
    "alarm-duration": {
      "caption": "Choose how long the alert rings",
      "light": "https://clock.adrianillo.name/manual/assets/screenshots/en/alarm-duration--light.png",
      "dark": "https://clock.adrianillo.name/manual/assets/screenshots/en/alarm-duration--dark.png"
    },
    "flash-options": {
      "caption": "Steady or blinking flash and delay before sound",
      "light": "https://clock.adrianillo.name/manual/assets/screenshots/en/flash-options--light.png",
      "dark": "https://clock.adrianillo.name/manual/assets/screenshots/en/flash-options--dark.png"
    },
    "alarm-ringing": {
      "caption": "Hold Turn off or Snooze until the ring is full",
      "light": "https://clock.adrianillo.name/manual/assets/screenshots/en/alarm-ringing--light.png",
      "dark": "https://clock.adrianillo.name/manual/assets/screenshots/en/alarm-ringing--dark.png"
    },
    "world-clock": {
      "caption": "Local time and saved world-clock cities",
      "light": "https://clock.adrianillo.name/manual/assets/screenshots/en/world-clock--light.png",
      "dark": "https://clock.adrianillo.name/manual/assets/screenshots/en/world-clock--dark.png"
    },
    "city-search": {
      "caption": "Search for a city and check its country",
      "light": "https://clock.adrianillo.name/manual/assets/screenshots/en/city-search--light.png",
      "dark": "https://clock.adrianillo.name/manual/assets/screenshots/en/city-search--dark.png"
    },
    "stopwatch": {
      "caption": "Individual laps, cumulative time and sharing while paused",
      "light": "https://clock.adrianillo.name/manual/assets/screenshots/en/stopwatch--light.png",
      "dark": "https://clock.adrianillo.name/manual/assets/screenshots/en/stopwatch--dark.png"
    },
    "timer": {
      "caption": "Countdown and controls for the selected timer",
      "light": "https://clock.adrianillo.name/manual/assets/screenshots/en/timer--light.png",
      "dark": "https://clock.adrianillo.name/manual/assets/screenshots/en/timer--dark.png"
    },
    "timer-create": {
      "caption": "Hours, minutes, seconds and preset durations",
      "light": "https://clock.adrianillo.name/manual/assets/screenshots/en/timer-create--light.png",
      "dark": "https://clock.adrianillo.name/manual/assets/screenshots/en/timer-create--dark.png"
    },
    "settings-appearance": {
      "caption": "Settings: theme and time format",
      "light": "https://clock.adrianillo.name/manual/assets/screenshots/en/settings-appearance--light.png",
      "dark": "https://clock.adrianillo.name/manual/assets/screenshots/en/settings-appearance--dark.png"
    },
    "settings-clock": {
      "caption": "Settings: time picker and first weekday",
      "light": "https://clock.adrianillo.name/manual/assets/screenshots/en/settings-clock--light.png",
      "dark": "https://clock.adrianillo.name/manual/assets/screenshots/en/settings-clock--dark.png"
    },
    "settings-week": {
      "caption": "Choose the first day of the week",
      "light": "https://clock.adrianillo.name/manual/assets/screenshots/en/settings-week--light.png",
      "dark": "https://clock.adrianillo.name/manual/assets/screenshots/en/settings-week--dark.png"
    },
    "settings-timer": {
      "caption": "Settings: tone, volume and three timer presets",
      "light": "https://clock.adrianillo.name/manual/assets/screenshots/en/settings-timer--light.png",
      "dark": "https://clock.adrianillo.name/manual/assets/screenshots/en/settings-timer--dark.png"
    },
    "settings-preset": {
      "caption": "Edit a preset duration",
      "light": "https://clock.adrianillo.name/manual/assets/screenshots/en/settings-preset--light.png",
      "dark": "https://clock.adrianillo.name/manual/assets/screenshots/en/settings-preset--dark.png"
    },
    "settings-light": {
      "caption": "Settings: light sensitivity, auto-calibration and restoring defaults",
      "light": "https://clock.adrianillo.name/manual/assets/screenshots/en/settings-light--light.png",
      "dark": "https://clock.adrianillo.name/manual/assets/screenshots/en/settings-light--dark.png"
    },
    "settings-restore": {
      "caption": "Confirm before restoring settings",
      "light": "https://clock.adrianillo.name/manual/assets/screenshots/en/settings-restore--light.png",
      "dark": "https://clock.adrianillo.name/manual/assets/screenshots/en/settings-restore--dark.png"
    },
    "calibration-dark": {
      "caption": "First measurement: keep the phone still with the light off",
      "light": "https://clock.adrianillo.name/manual/assets/screenshots/en/calibration-dark--light.png",
      "dark": "https://clock.adrianillo.name/manual/assets/screenshots/en/calibration-dark--dark.png"
    },
    "calibration-bright": {
      "caption": "Second measurement: turn the light on without moving the phone",
      "light": "https://clock.adrianillo.name/manual/assets/screenshots/en/calibration-bright--light.png",
      "dark": "https://clock.adrianillo.name/manual/assets/screenshots/en/calibration-bright--dark.png"
    },
    "calibration-result": {
      "caption": "Review the suggested sensitivity and adjust the slider if needed",
      "light": "https://clock.adrianillo.name/manual/assets/screenshots/en/calibration-result--light.png",
      "dark": "https://clock.adrianillo.name/manual/assets/screenshots/en/calibration-result--dark.png"
    },
    "calibration-confirm": {
      "caption": "Confirm applying to existing and new alarms",
      "light": "https://clock.adrianillo.name/manual/assets/screenshots/en/calibration-confirm--light.png",
      "dark": "https://clock.adrianillo.name/manual/assets/screenshots/en/calibration-confirm--dark.png"
    }
  },
  "guides": [
    {
      "id": "getting-started",
      "title": "Getting started",
      "summary": "Find your way around the four tabs and test your first alert.",
      "sections": [
        {
          "id": "navigate",
          "title": "Four tabs, five uses",
          "p": [
            "Clock brings together Alarm, Clock, Timer and Stopwatch. The Clock tab contains both local time and world time. You do not need an account to get started.",
            "The app is available in Spanish, English, German, French, Italian and Portuguese. Its language follows Android settings; this website's language picker changes only the manual."
          ]
        },
        {
          "id": "first-test",
          "title": "Run a first test",
          "steps": [
            "Open Alarm and tap +. Set a time a few minutes ahead and enter a recognisable name.",
            "Check the days, alert type, tone and volume. Tap Save and grant the alarm access Android requests.",
            "Check that the switch is on and review the next alarm. Lock the phone and wait for the alert.",
            "Hold Turn off until the circle completes. If the alert does not appear or sound, check the permissions and troubleshooting guides."
          ],
          "shots": [
            "alarm-list"
          ]
        },
        {
          "id": "device",
          "title": "What you need",
          "p": [
            "Clock requires Android 7.0 or later. Alarm and timer alerts depend on device permissions and power settings. Light detection, flash and shaking the phone require the relevant hardware.",
            "Data are stored on the device. The app does not need Internet for its five functions. Sharing results or opening links uses the external application you choose."
          ]
        }
      ],
      "url": "https://clock.adrianillo.name/manual/en/getting-started/",
      "markdownUrl": "https://clock.adrianillo.name/manual/data/en/getting-started.md"
    },
    {
      "id": "alarms",
      "title": "Create and organise alarms",
      "summary": "Set the time, days and repeat schedule; edit and reorder your alarms.",
      "sections": [
        {
          "id": "create",
          "title": "Create an alarm",
          "steps": [
            "In Alarm, tap + and select the time. Check AM or PM when using the 12-hour format.",
            "Enter a name and select the days it should ring. Review the next activation shown before saving.",
            "Configure sound, vibration and other options. Scroll through the editor to reach the settings below.",
            "Tap Save. Check the time and the alarm switch in the list."
          ],
          "shots": [
            "alarm-editor"
          ]
        },
        {
          "id": "schedule",
          "title": "Once or every week",
          "p": [
            "With no days selected, the alarm is scheduled for the next occurrence of the chosen time: today if it has not passed, otherwise tomorrow. The preview tells you when.",
            "With days selected and weekly repeat off, it rings on the upcoming dates for those days and turns off once they have all been used. Enable weekly repeat to keep ringing on those days every week. Selecting all days without repeat does not create a permanent daily alarm."
          ],
          "note": "Check the next alarm after changing your phone's time or time zone."
        },
        {
          "id": "manage",
          "title": "Edit, disable and reorder",
          "p": [
            "Tap an alarm to edit it. Its switch disables it without deleting it. Saving in the editor enables it again.",
            "Hold a row to open the edit, delete and reorder options. In Reorder, drag the handles and finish reordering when done. The display order does not change the scheduled times.",
            "To delete an alarm, choose the corresponding option and confirm. The next-alarm display is calculated from enabled alarms."
          ]
        },
        {
          "id": "reorder",
          "title": "Reorder alarms",
          "steps": [
            "Hold an alarm and choose Reorder in the menu.",
            "Drag its handle up or down to the desired position. List order does not change the scheduled times.",
            "Use the control to finish reordering. You can also tap a handle and choose Move up or Move down."
          ],
          "shots": [
            "alarm-menu",
            "alarm-reorder",
            "alarm-reordered"
          ]
        },
        {
          "id": "countdown",
          "title": "See how long until the next alarm",
          "steps": [
            "At the start of the list, drag your finger down to reveal the panel above the alarms.",
            "The panel shows the remaining time and details of the next enabled alarm. Scroll the list up again to hide it. This is not a countdown for an arbitrary row: it refers to the next scheduled alarm."
          ],
          "shots": [
            "alarm-next"
          ]
        }
      ],
      "url": "https://clock.adrianillo.name/manual/en/alarms/",
      "markdownUrl": "https://clock.adrianillo.name/manual/data/en/alarms.md"
    },
    {
      "id": "sound",
      "title": "Sound, vibration and volume",
      "summary": "Choose a tone, import audio and adjust how the alert starts and how long it lasts.",
      "sections": [
        {
          "id": "type",
          "title": "Choose the alert type",
          "p": [
            "Open an alarm and select sound, vibration or both in the alarm type. A vibration-only alert will not play the tone.",
            "Open the tone picker to preview and select an app or device tone. Confirm the choice and save the alarm."
          ],
          "shots": [
            "alarm-type"
          ]
        },
        {
          "id": "custom",
          "title": "Use your own audio",
          "steps": [
            "In the tone picker, tap the option to add a new tone.",
            "Choose an audio file using Android's picker. Clock imports a copy into its private storage.",
            "Listen to the result, confirm the tone and save the alarm. If importing fails, try a valid local audio file."
          ],
          "p": [
            "You can delete imported tones in the picker. If a tone is in use, the app replaces it with a default tone; check the affected alarms afterwards."
          ],
          "shots": [
            "tone-picker"
          ]
        },
        {
          "id": "volume",
          "title": "Gradual volume and duration",
          "p": [
            "Adjust the volume in the editor. Enable gradual volume if you want the sound to rise progressively and review its settings.",
            "Alert duration controls how long it can keep ringing. The Snooze (Zz) interval controls the wait before ringing again after you snooze it. These are separate settings.",
            "Timers have their own tone and volume in Settings. Test with your phone locked and with your usual Do Not Disturb mode."
          ],
          "shots": [
            "alarm-sound",
            "alarm-duration"
          ]
        }
      ],
      "url": "https://clock.adrianillo.name/manual/en/sound/",
      "markdownUrl": "https://clock.adrianillo.name/manual/data/en/sound.md"
    },
    {
      "id": "ringing",
      "title": "Dismiss, snooze and use the flash",
      "summary": "Learn the hold gesture and configure volume buttons, shaking and flash.",
      "sections": [
        {
          "id": "hold",
          "title": "When an alarm rings",
          "p": [
            "Hold Turn off or the snooze control until the circle completes. A brief tap does not complete the action. Snoozing uses the interval set for that alarm.",
            "While an alarm is snoozed, hold Cancel alarm to cancel that pending alert. This does not delete the alarm settings or future repeats.",
            "If you only see a notification, tap it to open the alarm screen. Check permissions if the screen does not appear on the lock screen."
          ],
          "shots": [
            "alarm-ringing"
          ]
        },
        {
          "id": "buttons",
          "title": "Volume buttons and shaking the phone",
          "p": [
            "In each alarm's editor, choose whether the volume buttons do nothing, dismiss the alert or snooze it.",
            "The shake option uses the accelerometer. Choose whether it turns off or snoozes the alarm, then test the movement with an alarm set a few minutes ahead. It is not general room motion or presence detection."
          ],
          "shots": [
            "alarm-actions",
            "alarm-details"
          ]
        },
        {
          "id": "flash",
          "title": "Flash and delay before sound",
          "p": [
            "If supported by the device, configure a steady or blinking flash for the alarm. Also check the delay before sound starts.",
            "Test it together with light detection: a mirror or reflective surface can send the flash back towards the sensor and dismiss or snooze the alert. Light detection has its own guide."
          ],
          "shots": [
            "flash-options"
          ]
        }
      ],
      "url": "https://clock.adrianillo.name/manual/en/ringing/",
      "markdownUrl": "https://clock.adrianillo.name/manual/data/en/ringing.md"
    },
    {
      "id": "light",
      "title": "Dismiss an alarm with light",
      "summary": "Enable detection and calibrate where you will place the phone.",
      "sections": [
        {
          "id": "enable",
          "title": "Enable the light action",
          "steps": [
            "Check that your phone has a light sensor. Open the alarm editor and enable light detection.",
            "Choose whether a light change will dismiss or snooze the alert. Adjust that alarm's sensitivity and save.",
            "Place the phone in its usual position with the sensor uncovered and test an alarm with the room light off. Then switch the room light on and check the action."
          ],
          "note": "Detection depends on ambient light, sensor and placement. Test it before relying on it to wake you.",
          "shots": [
            "alarm-actions"
          ]
        },
        {
          "id": "calibrate",
          "title": "Auto-calibrate sensitivity",
          "steps": [
            "Open Settings, find Light detection sensitivity and tap Auto-calibrate.",
            "Put the phone where it will be during the alarm. Turn the light off, keep it still and tap Measure with light off.",
            "Turn the light on without moving the phone and start the second measurement.",
            "Review the suggested sensitivity. Adjust the slider if needed, then confirm Set and apply to all."
          ],
          "p": [
            "Confirmation applies the profile to existing and new alarms. You can then select a different sensitivity for an individual alarm. Moving the global slider without applying does not save the change."
          ],
          "shots": [
            "calibration-dark",
            "calibration-bright",
            "calibration-result",
            "calibration-confirm"
          ]
        },
        {
          "id": "adjust",
          "title": "If it stops too early or does not respond",
          "p": [
            "Reduce sensitivity if the screen or another weak light is enough to dismiss it. Increase sensitivity if the room light does not trigger the action, first checking the sensor is uncovered.",
            "If readings are unstable or the light increase is too small, repeat calibration. A failed or cancelled measurement keeps the previous settings. Without a compatible sensor, use the screen buttons or another available action."
          ]
        }
      ],
      "url": "https://clock.adrianillo.name/manual/en/light/",
      "markdownUrl": "https://clock.adrianillo.name/manual/data/en/light.md"
    },
    {
      "id": "timer",
      "title": "Run several timers together",
      "summary": "Create named countdowns, switch between them and pause each one separately.",
      "sections": [
        {
          "id": "create",
          "title": "Start a countdown",
          "steps": [
            "Open Timer and tap + to show the creation panel.",
            "Set hours, minutes and seconds and enter a name, such as Pasta. The picker supports up to 99 h, 59 min and 59 s.",
            "Tap one of the three preset durations to fill in the time if you wish. Tap Start.",
            "Tap + again to add another timer; the previous one keeps running."
          ],
          "shots": [
            "timer-create"
          ]
        },
        {
          "id": "manage",
          "title": "Switch, pause and delete",
          "p": [
            "Swipe horizontally between timers. The controls apply to the timer currently in view.",
            "Tap Pause to temporarily stop that countdown and Resume to continue with its remaining time. The other countdowns do not pause.",
            "Use Delete to remove the selected timer. When a countdown finishes, stop its alert; if several alerts have completed, the screen lets you stop all of them."
          ],
          "shots": [
            "timer"
          ]
        },
        {
          "id": "defaults",
          "title": "Change presets and sound",
          "p": [
            "In Settings, under Timers, edit each of the three preset durations. You can also change the timer alert tone and volume.",
            "If Android requests alarm and reminder access, grant it and start the countdown again. If no alert appears when it finishes, review notifications and battery settings in the permissions guide."
          ],
          "shots": [
            "settings-timer"
          ]
        }
      ],
      "url": "https://clock.adrianillo.name/manual/en/timer/",
      "markdownUrl": "https://clock.adrianillo.name/manual/data/en/timer.md"
    },
    {
      "id": "stopwatch",
      "title": "Stopwatch and laps",
      "summary": "Time a session, mark laps and share the results while paused.",
      "sections": [
        {
          "id": "measure",
          "title": "Start, pause and resume",
          "steps": [
            "Open Stopwatch and tap Start.",
            "Tap Lap whenever you want to mark a segment without stopping the total.",
            "Tap Pause to stop measuring. Resume continues the same session.",
            "While paused, use Share to send the result through the application you choose."
          ]
        },
        {
          "id": "laps",
          "title": "Read the laps",
          "p": [
            "The list distinguishes each lap's time from the cumulative time since starting. The current lap is compared with the previous one so you can see how its duration changes.",
            "Times display milliseconds and can span several days. This display is not a certification of sporting precision and does not mark laps automatically."
          ],
          "shots": [
            "stopwatch"
          ]
        },
        {
          "id": "reset",
          "title": "Reset a session",
          "p": [
            "Reset returns the stopwatch to zero and clears the session's laps. Share results first if you want to keep them.",
            "The app saves the session on the device to restore it when you return to the screen. It does not provide a workout archive: clearing app data or uninstalling can remove the saved session."
          ]
        }
      ],
      "url": "https://clock.adrianillo.name/manual/en/stopwatch/",
      "markdownUrl": "https://clock.adrianillo.name/manual/data/en/stopwatch.md"
    },
    {
      "id": "clock",
      "title": "Local clock and time format",
      "summary": "Read the dial, digital time, seconds and date from your phone.",
      "sections": [
        {
          "id": "read",
          "title": "Read local time",
          "p": [
            "Open Clock. The analogue dial and digital time appear at the top with seconds and the date. Your saved world-clock cities appear below.",
            "Local time comes from the phone. If it is wrong, check date, time and time zone in Android settings; the manual does not change device time."
          ],
          "shots": [
            "world-clock"
          ]
        },
        {
          "id": "format",
          "title": "Choose 12 or 24 hours",
          "steps": [
            "Open Settings from Clock's menu.",
            "Choose 12 Hours or 24 Hours in Clock format.",
            "Return to Clock and check the result. In 12-hour mode, check AM or PM when creating alarms."
          ],
          "p": [
            "The default clock style and the option to show or hide its selector refer to the time picker in the alarm editor. They do not remove the dial or digital time from the Clock screen."
          ],
          "shots": [
            "settings-appearance"
          ]
        },
        {
          "id": "appearance",
          "title": "Change the appearance",
          "p": [
            "Select the light or dark theme in Settings; it applies throughout the app. World time remains available in the same tab in either theme."
          ]
        }
      ],
      "url": "https://clock.adrianillo.name/manual/en/clock/",
      "markdownUrl": "https://clock.adrianillo.name/manual/data/en/clock.md"
    },
    {
      "id": "world-clock",
      "title": "World clock and cities",
      "summary": "Search for cities offline and organise the times you need to check.",
      "sections": [
        {
          "id": "add",
          "title": "Add a city",
          "steps": [
            "Open Clock and tap +.",
            "Enter a city name in search. The catalogue and aliases are searched on the device without Internet.",
            "Choose the matching result, checking the country or zone when names are similar.",
            "Repeat to add more cities. Their times appear below local time."
          ],
          "shots": [
            "city-search"
          ]
        },
        {
          "id": "organize",
          "title": "Reorder and remove cities",
          "p": [
            "Hold a city and drag it to change its position. Swipe it sideways to remove it from your list.",
            "Removing a city does not change the phone's time. You can search for it and add it again."
          ],
          "shots": [
            "world-clock"
          ]
        },
        {
          "id": "zones",
          "title": "Time zones and seasonal changes",
          "p": [
            "Clock uses Android's time-zone rules for each city. The difference from your local time can change with daylight saving time; keep the system updated.",
            "If a city is missing, try another name or a city in the same time zone. The app searches an included catalogue, not every location in the world.",
            "World clock shows current times. It does not include a meeting planner or future-date converter. The app retains the GeoNames data credits."
          ]
        }
      ],
      "url": "https://clock.adrianillo.name/manual/en/world-clock/",
      "markdownUrl": "https://clock.adrianillo.name/manual/data/en/world-clock.md"
    },
    {
      "id": "settings",
      "title": "Clock settings",
      "summary": "Themes, time format, first weekday and defaults for light and timers.",
      "sections": [
        {
          "id": "open",
          "title": "Open settings",
          "p": [
            "Open Clock's menu and select Settings. General settings change the app's presentation; editor settings are saved in each alarm."
          ],
          "shots": [
            "settings-appearance"
          ]
        },
        {
          "id": "general",
          "title": "Theme, time and week",
          "p": [
            "Choose a light or dark theme and a 12- or 24-hour format. Set the first day of the week or let the phone determine it.",
            "Default clock style selects the digital or analogue time picker for new alarms. Showing or hiding the option controls whether you can change it in each editor; these are not two modes of the local clock screen."
          ],
          "shots": [
            "settings-clock",
            "settings-week"
          ]
        },
        {
          "id": "defaults",
          "title": "Timer sound and presets",
          "p": [
            "Timers includes the tone, volume and three preset durations. Each alarm's sound is set in its own editor."
          ],
          "shots": [
            "settings-timer",
            "settings-preset"
          ]
        },
        {
          "id": "sensitivity",
          "title": "Light detection sensitivity",
          "p": [
            "The slider selects global sensitivity. It is not saved until you choose Select and apply to all and confirm. This affects existing and new alarms; you can adjust each alarm separately afterwards.",
            "Auto-calibrate measures the room with the light off and on. The light guide shows both measurements, the suggestion and confirmation. Without a compatible sensor this section may be unavailable."
          ],
          "shots": [
            "settings-light"
          ]
        },
        {
          "id": "restore",
          "title": "Restore defaults",
          "p": [
            "Restore asks for confirmation and returns general settings to their initial values. It is not a button to delete all alarms or clear Android app data.",
            "Check the theme, format, timer sound and light sensitivity again after restoring. Clearing storage in Android is a separate operation that can remove app data."
          ],
          "shots": [
            "settings-restore"
          ]
        }
      ],
      "url": "https://clock.adrianillo.name/manual/en/settings/",
      "markdownUrl": "https://clock.adrianillo.name/manual/data/en/settings.md"
    },
    {
      "id": "permissions",
      "title": "Android permissions and alerts",
      "summary": "Check notifications, the lock screen and alarm access.",
      "sections": [
        {
          "id": "notifications",
          "title": "Notifications and full screen",
          "p": [
            "Allow Clock notifications when Android asks. In system settings, check that the alarm notification channel has High importance so it can show the notification and actions.",
            "If Android provides full-screen alarm access, enable it to display an alarm when the phone is locked. Without it, a notification may appear instead of a full-screen alert."
          ]
        },
        {
          "id": "exact",
          "title": "Alarms and reminders",
          "p": [
            "On Android 12 and 12L, Clock may request alarm and reminder access when you save an alarm or start a timer. Grant it and return to Clock to complete the action.",
            "Other versions may manage this access differently. Follow app prompts and the options your Android version provides, without looking for a switch the system does not offer."
          ]
        },
        {
          "id": "battery",
          "title": "Battery, Do Not Disturb and tests",
          "steps": [
            "If alerts are delayed, review Clock's battery or background restrictions in Android. Names and paths vary by manufacturer.",
            "Check that Do Not Disturb allows alarms and check volume. Review Do Not Disturb access if your system requires it.",
            "Prevent task managers from force-stopping Clock. After changing permissions or power settings, test an alarm and a timer with the phone locked."
          ],
          "note": "No setting lets an Android app alert you while the phone is powered off. Turn it on before the scheduled time."
        }
      ],
      "url": "https://clock.adrianillo.name/manual/en/permissions/",
      "markdownUrl": "https://clock.adrianillo.name/manual/data/en/permissions.md"
    },
    {
      "id": "troubleshooting",
      "title": "Troubleshooting",
      "summary": "Follow practical checks for alerts, sensors, cities and data.",
      "sections": [
        {
          "id": "silent",
          "title": "An alarm is silent or late",
          "p": [
            "Check it is enabled and the next-alarm preview matches the intended date and time. Review AM/PM, days and weekly repeat.",
            "Check alert type, tone, volume, gradual volume and flash delay. If light detection is enabled, rule out ambient light dismissing or snoozing the alarm.",
            "Review permissions, notification channel, Do Not Disturb and battery restrictions using the permissions guide. Test a near-future alarm with the phone locked after each change."
          ]
        },
        {
          "id": "screen",
          "title": "The screen is missing or the button does not respond",
          "p": [
            "Open the alarm notification and check full-screen access. Hold the control until the circle completes; a quick tap does not dismiss or snooze.",
            "If the alarm was snoozed, Cancel alarm cancels that pending alert. It does not delete the weekly alarm."
          ]
        },
        {
          "id": "other",
          "title": "Light, timers and cities",
          "p": [
            "If an alarm dismisses itself, lower light sensitivity and check flash reflections. If light is not detected, uncover the sensor and repeat both measurements.",
            "If a timer does not alert you, check its tone and volume in Settings as well as notifications. Pausing one timer leaves the others counting.",
            "If a city's time is wrong, first check Android's date, time and zone. Update the system for its latest time-zone rules."
          ]
        },
        {
          "id": "data",
          "title": "Still having trouble? You can report the problem",
          "p": [
            "Clock stores its data on the device; backups depend on Android. Before clearing storage or uninstalling, remember you may lose alarms, cities, tones and the stopwatch session.",
            "I am an independent developer and maintain this app in my spare time. If you find a bug, you can email me at clock@adrianillo.name. The information you send may help me investigate and improve the app, although I cannot guarantee a reply or a fix.",
            "See the privacy policy for how your messages will be handled.",
            "To report an issue, use the contact in the footer and include your model, Android version, Clock version, affected function and reproduction steps. Avoid sending unnecessary personal files."
          ]
        }
      ],
      "url": "https://clock.adrianillo.name/manual/en/troubleshooting/",
      "markdownUrl": "https://clock.adrianillo.name/manual/data/en/troubleshooting.md"
    }
  ]
}
