# saveRecordingScreen

Save a video started by [`startRecordingScreen`](/docs/api/appium.md#startrecordingscreen) command to file.

info

This command is only supported for mobile sessions running on [Appium](https://appium.github.io/appium.io/docs/en/commands/device/recording-screen/start-recording-screen/).

## Usage[​](#usage "Direct link to Usage")

```
await browser.saveRecordingScreen(filepath)
```

## Parameters[​](#parameters "Direct link to Parameters")

| Name       | Type     | Details                                                                 |
| ---------- | -------- | ----------------------------------------------------------------------- |
| `filepath` | `String` | full or relative to the execution directory path to the generated video |

## Example[​](#example "Direct link to Example")

saveRecordingScreen.js

```
it('should save a video', async () => {
    await browser.startRecordingScreen();
    await $('~BUTTON').click();
    await browser.saveRecordingScreen('./some/path/video.mp4');
});
```

## Returns[​](#returns "Direct link to Returns")

* **\<Buffer>** **`return`:** video buffer