This guide is for xBand App v2.4.0 and Firmware v3.02.126 and later.
The guide focuses on features specific to using xBand in Morse mode. You will find other guides here.
Overview of commands
A command is a series of short and/or long button presses that represents one or more letters in Morse code. Write the command on the Morse button and then execute it by double pressing the Action button.
You can read more about commands in the guide for Writing and using commands in Morse mode.
Get current time in minutes
Command: "E"
Press the Morse button quickly one time.
This corresponds to writing the letter: E, in Morse code: 
xBand response: Current time in minutes, for example 37 if time is 12:37.
Get current time in hours and minutes
Command: "I"
Press the Morse button quickly two times.
This corresponds to writing the letter: I, in Morse code: 
xBand response: Current time in hours and minutes, for example 12 37 if time is 12:37.
Get current date
Command: "S"
Press the Morse button quickly three times.
This corresponds to writing the letter: S, in Morse code: 
xBand response: Current date, day and month. For example 05 11 if the date is November 5th.
Check connection
Command: "H"
Press the Morse button quickly four times.
This corresponds to writing the letter: H, in Morse code: 
xBand response:
If xBand is connected it will respond with the connection up vibration.
If xBand is not connected it will respond with the connection down vibration.
Check battery level
Command: "5"
Press the Morse button quickly five times.
This corresponds to writing the number: 5, in Morse code: 
xBand response: Current battery level in percent, for example 81 if the battery level is 81%.
Find your phone
Command: "F"
Make two short, one long and one short press on the Morse button.
This corresponds to writing the letter: F, in Morse code: 
xBand response: Letter: C (Long, Short, Long, Short).
Your phone will start playing a sound to help you locate it. On Android, you can stop the sound by issuing the command again or by pressing the phone’s lock button. On iOS, the sound will stop automatically after a short time.
Automatic time toggle
Command: “C”
Press long, short, long, short on the Morse button.
This corresponds to writing the letter: C, in Morse code: 
xBand response:
-
- If automatic time was off, it will turn on and xBand will vibrate the letter: A (short, long)
- If automatic time was on, it will turn off and xBand will vibrate the letter: N (long, short)
When toggled on, automatic time will use the settings for interval and format set in the settings for automatic time in the app.
Alarm
Commands:
-
- “A hour minute”
- “A hour”
Make a short and a long press on the Morse button.
This corresponds to writing the letter: A, in Morse code: 
Add a space (single press on the Action button), then enter 1 or 2 numbers, each separated by a space.
The numbers define the time of the alarm:
-
- 1 number: the hour
- 2 numbers: hour and minute
Examples:
-
- A 8: Set an alarm for 08:00.
- A 7 30: Set an alarm for 07:30.
If an alarm for the specified time has already been created, the command will toggle the alarm on or off. If no such alarm exists, a new alarm will be created.
xBand response:
-
- New alarm created: xBand vibrates the entered time
- Alarm toggled on: xBand vibrates the letter: A (short, long)
- Alarm toggled off: xBand vibrates the letter: N (long, short)
If you use an alarm often, we recommend creating a shortcode for it, making it easy to toggle it on and off.
Timer
Commands:
-
- “T hours minutes seconds”
- “T hours minutes”
- “T minutes”
Make a long press on the Morse button.
This corresponds to writing the letter: T, in Morse code: 
Add a space (single press on the Action button), then enter 1 to 3 numbers, each separated by a space.
The numbers define the timer duration:
-
- 1 number: minutes
- 2 numbers: hours and minutes
- 3 numbers: hours, minutes and seconds.
Examples:
-
- T 10: Set a 10-minute timer
- T 0 0 30: Set a 30-second timer
- T 1 2 3: Set a 1 hour, 2 minutes, and 3 seconds timer
If a timer with the same duration already exists, the command will toggle the timer on or off. If no such timer exists, a new timer will be created.
xBand response:
-
- New timer created: xBand vibrates the entered duration
- Timer toggled on: xBand vibrates the letter: A (short, long)
- Timer toggled off: xBand vibrates the letter: N (long, short)
If you use a timer often, we recommend creating a shortcode for it, making it easy to toggle it on and off.
Check timer
Commands:
-
- “ET hours minutes seconds”
- “ET hours minutes”
- “ET minutes”
Make a short press, pause, then make a long press on the Morse button.
This corresponds to writing the letters: ET, in Morse code: 
Add a space (single press on the Action button), then enter 1 to 3 numbers, each separated by a space.
The numbers must match the duration the timer was originally set to:
-
- 1 number: minutes
- 2 numbers: hours and minutes
- 3 numbers: hours, minutes and seconds.
Examples:
-
- ET 10: Check remaining time on a 10-minute timer
- ET 0 0 30: Check remaining time on a 30-second timer
- ET 1 2 3: Check remaining time on a 1 hour, 2 minutes, and 3 seconds timer
xBand response: xBand vibrates the remaining time of the selected timer. If no running timer exists with the given duration, xBand responds with an error (8 dots).
If you use a timer often, we recommend creating a shortcode for checking it, making it easy to check how much time is left.
Toggle Stopwatch
Command: "T"
Make a long press on the Morse button.
This corresponds to writing the letter: T, in Morse code:
xBand response:
-
- If the stopwatch was off, it will start and xBand will vibrate the letter: A (short, long)
- If the stopwatch was on, it will stop and xBand will vibrate the elapsed time since it was started.
Check Stopwatch
Command: "ET"
Make a short press, pause, then make a long press on the Morse button.
This corresponds to writing the letters: ET, in Morse code:
xBand response: The elapsed time of the last started stopwatch.
The command will work even if the stopwatch is currently not active, as long as xBand has not been restarted since the stopwatch was last running.
Get the current time in a custom time format
Command: “CT hour-flag minute-flag second-flag”
On the Morse button, write the letters: CT, in Morse code: 
Add a space (single press on the Action button), then enter three flags, each separated by a space. The flags represent hours, minutes and seconds, in that order and each flag controls how that part of the time is reported.
Available flags:
-
- 0 : Exclude this part of the time
- F : Full value
- T : Tens — first digit. (Only available for minutes and seconds)
- U : Units — second digit. (Only available for minutes)
- Q : Quarters — number of 15-minute intervals. (0–3, only available for minutes)
Examples:
-
- ct 0 Q T: Vibrates the number of quarters past the hour, followed by the tens digit of seconds
- ct 0 0 F: Vibrates seconds only
xBand response: xBand vibrates the current time using the format defined by your flags.
If you use a custom time format often, we recommend creating a shortcode so you can access it quickly and easily.
Write a text message
Command: “M shortname message”
Note for iOS-users: Your phone needs to be unlocked and the xBand app open when you execute this command. (On Android this is not needed.)
- Write the letter: M, (two long presses) on the Morse button.
- Make a space with a single press on the Action button.
- Write the shortname for a contact you have added in the xBand app on the Morse button and you want to send a text message to.
- Make a space with a single press on the Action button.
- Write the message you want to send. This can include any character supported by xBand and can contain spaces between words, which are made by making a single press on the Action button. To write a word, or a contact name with several letters, make a short pause between each letter to separate the individual characters from each other.
- And execute the command by double pressing the Action button
xBand response: Letter: C (Long, Short, Long, Short), if xBand could successfully interpret your command. Error-signal (8 short) if xBand could not interpret your command (if the entered shortname did not exist or any other error occurred).
On Android: the entered text message will be sent to the contact linked to the shortname.
On iOS: A message interface will open on your phone with the contact and message you wrote filled in. Press the send button on the phone screen to send the text message.
HTTP API Request
Command: “W message”
The letter: W, starts a request to a Webhook. Follow by making a space with a single press on the Action button. Then enter the text to send to the Webhook. For example "w Hello World".
The entered message will be sent to your configured webhook.
xBand response: Success (Letter: C), error (8 dots) or nothing, depending on the response from the Webhook. If no Webhook is registered, xBand will respond with an error.
To make a HTTP request to a Webhook, you have to set up a Webhook and register it in the xBand app under Integrations, HTTP API. See the Integrations, HTTP API page in the app for more information.
You can read more in the developer resources.
HTTP API Buddy
Command: “B message”
The letter: B, starts a request to send a message to another person who has an xBand. Follow by making a space with a single press on the Action button. Then enter the text to send to the other person. For example "b Hi".
The message will vibrate on the other person's xBand (your "Buddy").
xBand response: Success (Letter: C) if the message was sent. Error (8 dots) if no buddy has been added in the configuration or if there is any other error.
A success message does not guarantee that your buddy received the message, only that it was sent.
To send a message to someone, you must enter that person´s API secret in the xBand app under Integrations, HTTP API, Buddy. See the Integrations, HTTP API page in the app for more information.