🎉🎉 New Release 0.5 is out, now with stable execution on Mac OS X, no more unplugging devices 🎉🎉🎉🎉🎉🎉
This is an Operating System indepedent implementation for Quicktime Screensharing for iOS devices :-)
This repository contains all the code you will need to grab and record video and audio from one or more iPhone(s) or iPad(s) without needing one of these expensive MacOS X computers or the hard to use QuickTime Player :-D
- You can record video and audio as raw h264 and wave audio in the Apple demonstration mode (Device shows 9:41am, full battery and no cellphone carrier in the status bar)
- Also you can just grab device audio as wave, ogg or mp3 without the Apple demonstration mode now 🎉
- You can use custom Gstreamer Pipelines to transcode the AV data into whatever you like
I will work on stabilizing Linux support next. On my current ubuntu box I need to disable the Camera mode, kill usbmuxd and restart the tool like 20 times before it works. It's really hard to get going. Also, let me know if you have ideas what needs to be added.
- On MacOS run
brew install libusb pkg-config gstreamer gst-plugins-bad gst-plugins-good gst-plugins-base gst-plugins-ugly - To just run: Download the latest release and run it
- To develop: Clone the repo and execute
go run main.go(need to install golang of course)
-
Run with Docker: the Docker files are here. There is one for just building and one for running.
-
If you want to build/run locally then copy paste the dependencies from this Dockerfile and install with apt.
-
Git clone the repo and start hacking or download the latest release and run the binary :-D
Q.uickTime V.ideo H.ack (qvh) v0.5-beta
Usage:
qvh devices [-v]
qvh activate [--udid=<udid>] [-v]
qvh record <h264file> <wavfile> [--udid=<udid>] [-v]
qvh audio <outfile> (--mp3 | --ogg | --wav) [--udid=<udid>] [-v]
qvh gstreamer [--pipeline=<pipeline>] [--examples] [--udid=<udid>] [-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"
audio Records only audio from the device. It does not change the status bar like the video recording mode does.
The recorded audio will be saved in <outfile> with the selected format. Currently (--mp3 | --ogg | --wav) are supported.
Adding more formats is trivial though so create an issue or a PR if you need something :-)
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.
QVH probably does something similar to what QuickTime and com.apple.cmio.iOSScreenCaptureAssistant are doing on MacOS.
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