Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/catchpoint/WebPageTest.xrecord
Console app for capturing video on OS X (particularly from iOS devices)
https://github.com/catchpoint/WebPageTest.xrecord
Last synced: about 2 months ago
JSON representation
Console app for capturing video on OS X (particularly from iOS devices)
- Host: GitHub
- URL: https://github.com/catchpoint/WebPageTest.xrecord
- Owner: catchpoint
- License: bsd-3-clause
- Created: 2015-02-26T20:53:26.000Z (almost 10 years ago)
- Default Branch: master
- Last Pushed: 2017-02-21T17:53:58.000Z (almost 8 years ago)
- Last Synced: 2024-08-02T06:25:58.980Z (5 months ago)
- Language: Swift
- Size: 5.73 MB
- Stars: 122
- Watchers: 19
- Forks: 38
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## xrecord - Capture video on OS X from the command line (including iOS devices)
## System Requirements
To record from iOS it requires an iOS 8.x+ device connected with a lightning connector and OS X Yosemite (10.10) or later.
## Getting started
```
brew install coming soon. In the meantime, use the xrecord binary from the /bin directory
```
## Command line
### Help
```bash
$ xrecord --help
```
### Options
* **-l, --list**: List available capture devices.
* **-n, --name**: Device Name.
* **-i, --id**: Device ID.
* **-o, --out**: Output File.
* **-f, --force**: Overwrite existing files.
* **-q, --quicktime**: Start QuickTime in the background (necessary for iOS recording).
* **-t, --time**: Recording time in seconds (records until stopped if not specified).
* **-u, --quality**: Recoding quality (low, medium, high, photo - defaults to high).
* **-d, --debug**: Display debugging info to stderr.
* **-h, --help**: Prints a help message.
### Examples
#### List available capture devices
```bash
$ xrecord --quicktime --list
Available capture devices:
AppleHDAEngineInput:1B,0,1,0:1: Built-in Microphone
5f355a5b183b2d2d7ba91dcfadd4c14b98504642: iPhone
CC2437519T1F6VVDH: FaceTime HD Camera
```
#### Record video from iPhone
```bash
$ xrecord --quicktime --name="iPhone" --out="/Users/blah/video/iphone.mp4" --force
Recording started. Hit ctrl-C to stop.
Done
```
## Known Issues
* Start of actual recording can lag by up to 3 seconds and may truncate at the end. Leave some time on either end of the activity being recorded for capture lag.
* Screen orientation changes stops video capture