> For the complete documentation index, see [llms.txt](https://documentation.hak5.org/wifi-pineapple-pager/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.hak5.org/wifi-pineapple-pager/vibrate.md).

# VIBRATE

`VIBRATE` Play a ringtone or ringtone file as a vibration pattern. A ringtone is \[a RTTTL format]\(/wifi-pineapple-pager/device/ringtones/) monophonic series of notes.

### When to use it <a href="#when-to-use-it" id="when-to-use-it"></a>

Use `VIBRATE` to play a custom (or pre-installed system) ringtone as a vibration pattern. Vibration patterns are controlled as if they were ringtones - when a note would play, the vibration motor is triggered. This can be used to generate complex patterns or basic notifications without sound.

#### Syntax <a href="#syntax" id="syntax"></a>

```none
VIBRATE [rtttl or filename]
```

**rtttl or filename&#x20;*****required***

Play the uspplied RTTTL ringtone, or play a RTTTL file.

To play a custom ringtone, use the entire RTTTL ringtone here.

To play a ringtone file, pass the name of the file. `VIBRATE` looks for the ringtone files in `/root/ringtones/`.

### Results <a href="#results" id="results"></a>

`VIBRATE` will eit with an error if another vibration pattern or ringtone is currently playing.

### Examples <a href="#examples" id="examples"></a>

```bash
# Play the default `alert.rtttl` ringtone as vibration
VIBRATE "alert"
```

```bash
# Play a custom ringtone as vibration
VIBRATION "custom:d=16,o=4,b=200:8e4,8g4,8a#4,8d5,8b6"
```

{% hint style="info" %}
Remember to enclose the prompt text in quotes if it contains spaces!
{% endhint %}