1. What is this?
This is an Operating System indepedent implementation for Quicktime Screensharing for iOS devices :-)
Check out my presentation
See a demo on YouTube
This repository contains all the code you will need to grab and record video and audio from your iPhone or iPad
without needing one of these expensive MacOS X computers :-D
It probably does something similar to what QuickTime
and com.apple.cmio.iOSScreenCaptureAssistant
are doing on MacOS.
Currently you can use it to dump a h264 file and a wave file or mirror your device in a desktop window. Transcoding it to anything else is very easy since I used Gstreamer to render the AV data.
2. Installation
- Install Gstreamer and LibUSB with brew or apt depending on your platform.
On MacOS run
brew install libusb
and brew install pkg-config
and brew install gstreamer gst-plugins-bad gst-plugins-good gst-plugins-base gst-plugins-ugly
- Download the latest release and run it or clone the repo and execute
go run main.go
3. Usage
Q.uickTime V.ideo H.ack (qvh) v0.3-beta
Usage:
qvh devices [-v]
qvh activate [--udid=<udid>] [-v]
qvh record <h264file> <wavfile> [-v] [--udid=<udid>]
qvh gstreamer [--pipeline=<pipeline>] [--examples] [-v]
qvh --version | version
Options:
-h --help Show this screen.
-v Enable verbose mode (debug logging).
--version Show version.
--udid=<udid> UDID of the device. If not specified, the first found device will be used automatically.
The commands work as following:
devices lists iOS devices attached to this host and tells you if video streaming was activated for them
activate enables the video streaming config for the device specified by --udid
record will start video&audio recording. Video will be saved in a raw h264 file playable by VLC.
Audio will be saved in a uncompressed wav file. Run like: "qvh record /home/yourname/out.h264 /home/yourname/out.wav"
gstreamer If no additional param is provided, qvh will open a new window and push AV data to gstreamer.
If "qvh gstreamer --examples" is provided, qvh will print some common gstreamer pipeline examples.
If --pipeline is provided, qvh will use the provided gstreamer pipeline instead of
displaying audio and video in a window.
3. Technical Docs/ Roll your own implementation
I have written some documentation here doc/technical_documentation.md
So if you are just interested in the protocol or if you want to implement this in a different programming language than golang, read the docs.
Also I have extracted binary dumps of all messages for writing unit tests and re-develop this in your preferred language in a test driven style.
I have given up on windows support :-)
Port to Windows (I don't know why, but still people use Windows nowadays) Did not find a way to do it