Repository files navigation

TouchVisualizer is a lightweight pure Swift implementation for visualising touches on the screen.

• Works with justa single line of code!
• Supports multiple fingers.
• Supports multipleUIWindow's.
• Displays touch radius (finger size).
• Displays touch duration.
• Customise the finger-points image and colour.
• Supports iPhone and iPad in both portrait and landscape mode.

It's fun!

• Swift 4.0
• Xcode 9.2
• iOS9.0 or later

TouchVisualizer works with Swift 5.2 from version 4.0.0.

Note: Embedded frameworks require a minimum deployment target of iOS 9.0.

Information: To use TouchVisualizer with a project targeting iOS 8.0 or lower, you must include theTouchVisualizer.swift source file directly in your project.

CocoaPods is a centralised dependency manager that automates the process of adding libraries to your Cocoa application. You can install it with the following command:

$ gem update$ gem install cocoapods$ pods --version

To integrate TouchVisualizer into your Xcode project using CocoaPods, specify it in yourPodfile and runpod install.

platform :ios,'9.0'use_frameworks!pod"TouchVisualizer",'~> 4.0'

Carthage is a decentralised dependency manager that automates the process of adding frameworks to your Cocoa application.

You can install Carthage withHomebrew using the following command:

$ brew update$ brew install carthage

To integrate TouchVisualizer into your Xcode project using Carthage, specify it in yourCartfile:

github "morizotter/TouchVisualizer" "4.0.0"

To install TouchVisualizer without a dependency manager, please add all of the files in/Pod to your Xcode Project.

To start using TouchVisualizer, write the following line wherever you want to start visualising:

import TouchVisualizer

Then invoke visualisation, by calling:

Visualizer.start()

and stop the presentation like this:

Visualizer.stop()

Get touch locations by this:

Visualizer.getTouches()

It is really simple, isn't it?

TouchVisualizer also has the ability to customize your touch events. Here is an example of what can be customized:

varconfig=Configuration()config.color=UIColor.redColor()config.image=UIImage(named:"YOUR-IMAGE")config.showsTimer=trueconfig.showsTouchRadius=trueconfig.showsLog=trueVisualizer.start(config)

• How to take an iOS screen movie

• TouchVisualizer Demo movie #potatotips // Speaker Deck @potatotips May 13 2015

Please file issues or submit pull requests for anything you’d like to see! We're waiting! :)

TouchVisualizer is released under the MIT license. Go read the LICENSE file for more information.

There is a similartouch visualization library calledCOSTouchVisualizer, which is written in Objective-C.COSTouchVisualizer supports earlier versions of iOS and is more mature. If TouchVisualizer isn't enough for you, try that!