Git Product home page Git Product logo

quicktime_video_hack's Introduction

Gitpod Ready-to-Code

License: MIT CircleCI codecov Go Report

Release 0.6

  • qvh without Gstreamer is finally stable on MacOSX. I ran it for 16 hours straight on parallel devices and it worked flawlessly.
  • before a 1.0 Release I need to see if Gstreamer is stable enough and maybe fix or switch to ffmpeg
  • Linux support needs to be improved. It works but it is hard to get going currently.
  • Create an issue if you miss anything

1. What is this?

This is an Operating System indepedent implementation for Quicktime Screensharing for iOS devices :-)

Check out my presentation

See me talk about it at GoWayFest

See a demo on YouTube

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

2. Installation

2.1 Mac OSX

  1. On MacOS run brew install libusb pkg-config gstreamer gst-plugins-bad gst-plugins-good gst-plugins-base gst-plugins-ugly
  2. To just run: Download the latest release and run it
  3. To develop: Clone the repo and execute go run main.go (need to install golang of course)

2.2 Linux

  1. Run with Docker: the Docker files are here. There is one for just building and one for running.

  2. If you want to build/run locally then copy paste the dependencies from this Dockerfile and install with apt.

  3. Git clone the repo and start hacking or download the latest release and run the binary :-D

3. Usage

  • For just displaying the screen run qvh gstreamer and it will work.
  • For just getting raw media output without Gstreamer involved use qvh record out.h264 out.wav or qvh audio out.wav --wav for audio only
  • For troubleshooting run qvh diagnostics metrics.csv --dump=binary.bin which will persist logs to a file, dump all usb transfers and gather metrics.
  • See qvh gstreamer --examples for transcoding media or streaming.
  • For creating mp3 or ogg in audio only mode see qvh audio out.mp3 --mp3 and qvh audio out.ogg --ogg

4. Technical Docs/ Roll your own implementation

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

quicktime_video_hack's People

Contributors

danielpaulus avatar danielpauluscontentful avatar re995 avatar joonghyup-cha avatar mikejing506 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.