mapbox / fingertips

Touch indicators on external displays for iOS applications.

Fingertips

Presentation mode for your iOS app

Fingertips is a small library (one class) meant for presentations from iOS devices that shows all touches and gestures so that the audience can see them.

This library does not do the mirroring or screen recording for you!

Just drop in our replacement UIWindow subclass and your app will automatically determine when you are in the screen recording or an external screen is available. It will show every touch on-screen with a nice partially-transparent graphic that automatically fades out when the touch ends.

If you are using storyboards, the easiest way to integrate Fingertips is to override the window method of your application delegate like this:

// AppDelegate.m

- (UIWindow *)window {
    if (!_window) {
        _window = [[MBFingerTipWindow alloc] initWithFrame:[UIScreen mainScreen].bounds];
    }
    return _window;
}

// AppDelegate.swift (Swift)

var window: UIWindow? = FingerTipWindow(frame: UIScreen.main.bounds)

For iOS 13+ with UISceneDelegate:

var windows: [UIWindow] = []

func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) {
    guard let windowScene = scene as? UIWindowScene else { return }

    let window = FingerTipWindow(windowScene: windowScene)

    window.rootViewController = // Your root view controller
    window.makeKeyAndVisible()

    windows.append(window)
}

Fingertips require iOS 11.0 or greater and ARC. It uses no private API and is safe for App Store submissions.

demo.mp4

Configuration

You shouldn't need to configure anything, but if you want to tweak some knobs:

• touchImage: pass a UIImage to use for showing touches
• touchAlpha: change the visible-touch alpha transparency
• fadeDuration: change how long lifted touches fade out
• strokeColor: change default touchImage stroke color (defaults to black)
• fillColor: change default touchImage fill color (defaults to white)

If you ever need to debug Fingertips, just set the DEBUG_FINGERTIP_WINDOW environment variable to YES in Xcode or set the runtime property alwaysShowTouches to YES.

License

Copyright (c) 2011-2023 Mapbox, Inc.

The Fingertips library should be accompanied by a LICENSE file. This file contains the license relevant to this distribution. If no license exists, please contact Mapbox.

fingertips's Issues

New warning in Xcode 11.4: Missing switch cases

/Users/xxxx/Projekte/Apps/xxx/Pods/Fingertips/MBFingerTipWindow.m:217:21: Enumeration values 'UITouchPhaseRegionEntered', 'UITouchPhaseRegionMoved', and 'UITouchPhaseRegionExited' not handled in switch

C

Working with iOS13+ and a scene delegate

I love this plugin, but for new projects with a Scene Delegate it doesn't work.
How do you modify this to work with a Scene Delegate?

FingerTipWindow is not overridable

Hello,

FingerTipWindow is not overridable, as it is declared as public class, and not as open class.

Please, give us possibility to override FingerTipWindow and add our logics to there.

Best,
Giorgi

Screenshot

A screenshot or animated GIF in the README would be helpful.

Can it work in a swift project?

In the appDelegate's didFinishLaunchingWithOptions, I tried setting the window property but no luck (Executing the code below, my app landed on a black screen after the splash and that was it - not sure where to go from there)

class AppDelegate: UIResponder, UIApplicationDelegate {

  var window: UIWindow?

  func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool {
  //...
  window = MBFingerTipWindow(frame:UIScreen.mainScreen().bounds)
  //...
}

[super sendEvent:event]; EXC_BAD_ACCESS

I am getting occasionally EXC_BAD_ACCESS at MBFingetTipWindow.m, line 258:
[super sendEvent:event];

`v0.6.0` tag is not parsed by Swift Package Manager

When I add the URL https://github.com/mapbox/Fingertips as a dependency in Xcode, I cannot specify version 0.6.0 because the tag is not parsed by Xcode (it doesn't like the "v").

In this attached screenshot, notice how the highest version it shows is 0.4.0, because that's the highest tag it can parse.

Thanks for this lib. I created a guide to help in the installation process

Hey, thanks for this repo!
I created a step by step guide to install this on your iOS project.
Hope it helps anyone :)

Doesn't work with Carthage

We're trying to use this with Carthage and when we execute carthage update nothing gets built. Upon further inspection, it appears that the project file is not brought down. Any ideas?

Support QuickTime recording

Could you please add support for QuickTime recording?

Apparently it's possible to detect if the phone screen is being recorded using the following technique:
link

Not working when connecting to MacBook with lightning cable.

Fingertips works well when I project the phone screen to AppleTV using AirPlay.
But when I connect the phone to Mac with Lightning cable, it doesn't work.
I have to set alwaysShowTouches as true, then I can see the fingertips, but it always shows.

Can you fix this?

And, can you add enable/disable API to turn on/off the fingertips even when connected to AirPlay?

Thanks.

Finger

// AppDelegate.m

• (UIWindow *)window {
  if (!_window) {
  _window = [[MBFingerTipWindow alloc] initWithFrame:[UIScreen mainScreen].bounds];
  }
  return _window;
  }
  // AppDelegate.swift (Swift 2)

var window: UIWindow? = MBFingerTipWindow(frame: UIScreen.mainScreen().bounds)
// AppDelegate.swift (Swift 3)

var window: UIWindow? = MBFingerTipWindow(frame: UIScreen.main.bounds)

add to CocoaPods

Xcode 8.3.3 warning due to targeting iOS 5.0

Expected behavior

No warnings when building an Xcode project that uses CocoaPods to depend on Fingertips.

Observed behavior

Xcode displays a "Buildtime" warning on Pods.xcodeproj stating "Update to recommended settings". Clicking on the warning displays a view with an issue in Fingertips: "An iOS Deployment Target earlier than 8.0 is not supported by this version of Xcode. This will update the value for Target 'Fingertips' to '8.0'."

Steps to reproduce

Add pod 'Fingertips' to your Podfile
Run pod install
Load your Xcode project and build

Version

Xcode 8.3.3
Fingertips 0.5.0

version 0.6.0 in CocoaPods

Do you plan to push version 0.6.0 to CocoaPods (Podspec)?

Add instructions on how to enable the class

In AppDelegate.m import the following class:

import <Fingertips/MBFingerTipWindow.h>

Add the following method:
//Used for showing touches

• (MBFingerTipWindow *)window
  {
  static MBFingerTipWindow *visualFeedbackWindow = nil;
  if (!visualFeedbackWindow) visualFeedbackWindow = [[MBFingerTipWindow alloc] initWithFrame:[[UIScreen mainScreen] bounds]];
  return visualFeedbackWindow;
  }

Fingertips are displayed in wrong location if app window is shrunk using StageManager

Video/screenshot to follow

AlwaysShowFingertips isn't working

setting alwaysShowFingerTips to true doesn't seem to be working. I set it to true immediately after creating the window and never saw any fingertips.

1

Код

Problem with view controller-based status bar appearance iOS 7

When this plugin is installed and it is using, the viewControllers can't change the status bar style with methods like preferredStatusBarStyle