https://github.com/alexjsp/record-ios-simulator

A script to start and stop video recordings from the iOS Simulator as easily as taking a screenshot.
https://github.com/alexjsp/record-ios-simulator

ios simulator tools

Last synced: 11 days ago
JSON representation

A script to start and stop video recordings from the iOS Simulator as easily as taking a screenshot.

• Host: GitHub
• URL: https://github.com/alexjsp/record-ios-simulator
• Owner: alexjsp
• License: mit
• Created: 2019-01-04T10:24:32.000Z (almost 6 years ago)
• Default Branch: master
• Last Pushed: 2019-02-09T12:43:35.000Z (almost 6 years ago)
• Last Synced: 2024-10-23T00:36:01.752Z (20 days ago)
• Topics: ios, simulator, tools
• Language: Shell
• Size: 179 KB
• Stars: 215
• Watchers: 5
• Forks: 9
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Record iOS Simulator

A script to start and stop video recordings from the iOS Simulator as easily as taking a screenshot.

Run the script to start a video recording, then run it again to stop that recording and have it saved to the Desktop with a name like `Simulator 2019-01-04 at 10.16.21.mp4`.

Also includes Alfred and Keyboard Maestro implementations that allow you to start and stop a recording easily with ⌘R in the Simulator (or any other trigger those apps support).

# Usage Instructions

## Alfred

Download the [Record Simulator.alfredworkflow](https://github.com/alexp2ad/record-ios-simulator/raw/master/Record%20Simulator.alfredworkflow) file and open it to add the workflow to Alfred. After adding the workflow you can double click the `Hotkey` action and assign a hotkey of your choice to start and stop the recording (I like ⌘R), or you can just trigger the workflow from Alfred with the `record` keyword.

Once the workflow has been added, and the hotkey set, just use the hotkey in the Simulator to start a video recording, and then again to end the recording.

## Keyboard Maestro

Download the [Record Simulator.kmmacros](https://github.com/alexp2ad/record-ios-simulator/raw/master/Record%20Simulator.kmmacros) file and open it to add the macro to Keyboard Maestro. By default it is triggered using the ⌘R hotkey while the Simulator is focused, but you can tweak this behaviour after adding the macro if desired.

Once the macro has been added, just use the hotkey in the Simulator to start a video recording, and then again to end the recording.

## Script Usage

If using other utilities, or wanting to simply have a script that you can run in the terminal, then download and run the bash script. On first run it will start a recording, on second run it will end the recording and save it to the Desktop.

# Behaviour

There are several variables at the top of the script that can be edited to modify the behaviour:

| Variable | Default | Description |

| --- | --- | --- |

| `outputDirectory` | `~/Desktop/` | Determines where recordings are saved. |

| `openRecordings` | `true` | If `true` video recordings will be opened when ended, otherwise a notification is displayed. |

| `playSounds` | `true` | If `true` system sounds will be played when starting and stopping a recording. |

| `filename` | `"Simulator "$(date '+%Y-%m-%d at %H.%M.%S')` | By default files are saved with date-based names like `Simulator 2019-01-04 at 10.16.21.mp4`, tweak this to change filenames to your liking. (No need to include an extension, `.mp4` is added further into the script) |

# Contributing

PRs with improvements, fixes, features welcomed.

After modifying the script, please run the `utils/generateFiles.sh` script to update the Keyboard Maestro and Alfred implementations with the script changes, and include those changes with your script update commit. You do __not__ need Alfred or KM to do this.