Latest 1.0.6
License MIT
Platforms ios 6.0, requires ARC



Swift Usage

Using COSTouchVisualizer is possible with Swift. Inside your AppDelegate, redefine your window and declare a visualizer window with storyboards.

With Storyboards

class AppDelegate: UIResponder, UIApplicationDelegate, COSTouchVisualizerWindowDelegate {

  lazy var window: UIWindow? = {
      var customWindow = COSTouchVisualizerWindow(frame: UIScreen.mainScreen().bounds)
      customWindow.touchVisualizerWindowDelegate = self
      return customWindow

Without Storyboards

Objective-C Usage

To run the example project; clone the repo, and run pod update from the Example directory first. By default, this project has Debug Mode disabled. If you want to see the gestures while you’re testing, follow the Debugging Mode instructions.

With Storyboards
in your AppDelegate implementation simply add the following getter

#import <COSTouchVisualizerWindow.h>


// Add this method to your AppDelegate method
- (COSTouchVisualizerWindow *)window {
    static COSTouchVisualizerWindow *visWindow = nil;
    if (!visWindow) visWindow = [[COSTouchVisualizerWindow alloc] initWithFrame:[[UIScreen mainScreen] bounds]];
    return visWindow;

Without Storyboards

#import <COSTouchVisualizerWindow.h>


- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // Setup window
    self.window = [[COSTouchVisualizerWindow alloc] initWithFrame:[[UIScreen mainScreen] bounds]];
    self.window.backgroundColor = [UIColor whiteColor];




To make the window change active status dynamically or to enable debugging mode, you could make an object
implements the COSTouchVisualizerWindowDelegate protocol.

Here are 2 optional methods in this delegate protocol:

- (BOOL)touchVisualizerWindowShouldShowFingertip:(COSTouchVisualizerWindow *)window;
- (BOOL)touchVisualizerWindowShouldAlwaysShowFingertip:(COSTouchVisualizerWindow *)window;

By default, the window only shows fingertip when there is a mirrored window.

The first delegate method (-touchVisualizerWindowShouldShowFingertip:) tells the window to enable
fingertip or not. You should return YES to enable the fingertip feature, or NO if you want to close this

The second method (-touchVisualizerWindowShouldAlwaysShowFingertip:) tells the window to always show the
fingertip even if there’s no any mirrored screens (when returning YES). If this method returns NO, the window
only show fingertip when connected to a mirrored screen.

- (COSTouchVisualizerWindow *)window {
  if (!_customWindow) {
    _customWindow = [[COSTouchVisualizerWindow alloc] initWithFrame:[[UIScreen mainScreen] bounds]];

    // ... other setup code

    _customWindow.touchVisualizerWindowDelegate = self;
  return _customWindow;

- (BOOL)touchVisualizerWindowShouldAlwaysShowFingertip:(COSTouchVisualizerWindow *)window {
    return YES;  // Return YES to make the fingertip always display even if there's no any mirrored screen.
                 // Return NO or don't implement this method if you want to keep the fingertip display only when
                 // the device is connected to a mirrored screen.

- (BOOL)touchVisualizerWindowShouldShowFingertip:(COSTouchVisualizerWindow *)window {
    return YES;  // Return YES or don't implement this method to make this window show fingertip when necessary.
                 // Return NO to make this window not to show fingertip.


// Add these lines after the windows is initialized
// Touch Color
[visWindow setFillColor:[UIColor yellowColor]];
[visWindow setStrokeColor:[UIColor purpleColor]];
[visWindow setTouchAlpha:0.4];
// Ripple Color
[visWindow setRippleFillColor:[UIColor yellowColor]];
[visWindow setRippleStrokeColor:[UIColor purpleColor]];
[visWindow setRippleAlpha:0.1];


This project requires ARC.


COSTouchVisualizer is available through CocoaPods, to install
it simply add the following line to your Podfile:

pod "COSTouchVisualizer"


Joe Blau, [email protected]


COSTouchVisualizer is available under the MIT license. See the LICENSE file for more info.

Latest podspec

    "name": "COSTouchVisualizer",
    "version": "1.0.6",
    "summary": "Visualize iOS finger touches, gestures and holds on external displays",
    "description": "tttTouch Screen Visualizer visualizes your touches, gestures, and holds onntttthe screen.  Touches are visualized by a circle fading out and expanding.ntttGestures are visualized by smaller ripples fading in.  Holds arentttare visualized by a morphing effect on the circle.nntttThe library also lets you customize the color and opacity of and borderntttof the touch circles.n",
    "homepage": "",
    "screenshots": [
    "license": "MIT",
    "authors": {
        "Joe Blau": "[email protected]"
    "source": {
        "git": "",
        "tag": "1.0.6"
    "social_media_url": "",
    "platforms": {
        "ios": "6.0"
    "requires_arc": true,
    "source_files": "Classes",
    "ios": {
        "exclude_files": "Classes/osx"
    "osx": {
        "exclude_files": "Classes/ios"

Pin It on Pinterest

Share This