mimiq is simple executable to record your Xcode simulator and convert it to several video type like gif, mp4 or mov.
if you don't have any idea about homebrew, homebrew is dependency manager on macos, to install homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"of for more information visit homebrew website
install via homebrew
brew install wendyliga/core/mimiqClone Repo
git clone https://github.com/wendyliga/mimiq.git
execute build script
make install
you will get mimiq executable, use it as you want
mimiq will installed at /usr/local/bin
Mimiq have a GUI version for Mac user, you can install and use it with keyboard shortcut and ease of click, check it more mimiq-gui.
mimiq
Just simple to call mimiq, it will automatically detect current running simulator and record it for you
previously mimiq is focus on recording GIF from your simulator, but from feedback on early user of mimiq, it has big potential, not just GIF.
so on 0.5.0, mimiq extend itself to support outputing format like mp4 and mov also.
available output
- gif
- mov
- mp4
mimiq --output mp4you can specify what quality of GIF, mimiq will generate.
available quality
- low
- medium
- high
how to use
mimiq --quality highyou can set where mimiq will place the generated output. for default, mimiq will generate output on desktop, but if you want to change it then, when start mimiq add this additional params
mimiq --path "~/...path/directory/folder"if you have multiple running simulator, then you need to spesify which simulator you want to mimiq.
get your running simulator by executing
mimiq listexample:
then record spesific simulato by its UDID
mimiq --udid 6ABC274C-76BB-483B-8DD6-8A9F8E486E0Fpress `enter`
to stop, just press enter. then grab your generated output
*raft approx 1Mb gif size for 15s
You can check upcomming feature on https://github.com/wendyliga/mimiq/projects/1
New version is available with this improvement, update your mimiq by
brew upgrade wendyliga/core/mimiqMIT License
Copyright (c) 2020 Wendy Liga
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.