How do I change the touch point color in TouchVisualizer?

Customize by setting the `color` property in the Configuration object before starting Visualizer. For example, create a config with `config.color = UIColor.red` and call `Visualizer.start(config)`.

TouchVisualizer vs COSTouchVisualizer which is better?

TouchVisualizer is better for pure Swift projects targeting iOS 9.0+, offering a lightweight, modern approach. COSTouchVisualizer is preferable for Objective-C compatibility or support for iOS versions below 9.0, as it's more mature.

Does TouchVisualizer work on iPad in landscape mode?

Yes, TouchVisualizer supports both iPhone and iPad in portrait and landscape orientations, as stated in the README's features and demonstrated in the GIFs.

How to stop TouchVisualizer after starting it?

Simply call `Visualizer.stop()` wherever you want to end the touch visualization. This is straightforward and mentioned in the usage section of the README.

Can I use TouchVisualizer in a production app?

While technically possible, it's designed for debugging and demos. Using it in production might add visual clutter; consider toggling it only in debug builds or for specific user testing scenarios.

TouchVisualizer not showing touch radius on simulator, how to fix?

This is a known limitation—touch radius visualization doesn't work on the simulator. For accurate display, test on a physical iOS device where the hardware provides touch radius data.

Open-Awesome

TouchVisualizer

MITSwift4.0.0

A lightweight pure Swift library for visualizing touch interactions on iOS screens with a single line of code.

GitHub

871 stars111 forks0 contributors

What is TouchVisualizer?

TouchVisualizer is a lightweight Swift library that visualizes touch interactions on iOS screens. It displays touch points, duration, and radius to help developers debug touch interfaces or create engaging demos. The library can be integrated with a single line of code and supports multiple fingers and windows.

Target Audience

iOS developers who need to debug touch interactions, create screen recordings for presentations, or demonstrate app usability. It's particularly useful for those building touch-heavy applications or preparing demo videos.

Value Proposition

Developers choose TouchVisualizer for its simplicity—requiring only one line of code to start—and its pure Swift implementation. It offers customizable touch visualization without the overhead of Objective-C libraries, making it ideal for modern iOS projects.

Overview

Lightweight touch visualization library in Swift. A single line of code and visualize your touches!

Use Cases

Best For

Debugging multi-touch gestures in iOS applications
Creating screen recordings for app demonstrations or presentations
Visualizing touch radius and duration during usability testing
Adding visual feedback for touch interactions in demo builds
Teaching iOS development with visible touch interactions
Replacing COSTouchVisualizer in Swift-based projects

Not Ideal For

Projects targeting iOS 8.0 or earlier, as TouchVisualizer requires iOS 9.0+ for embedded frameworks
Debugging touch radius on the iOS simulator, since this feature only works on physical devices
Teams deeply invested in Objective-C who need broader iOS version support, where COSTouchVisualizer is more mature
Production apps where persistent visual touch feedback could confuse users or isn't needed for the final product

Pros & Cons

Pros

Single-Line Integration

Start touch visualization with just `Visualizer.start()`, making it incredibly easy to add without complex boilerplate code, as highlighted in the README.

Multi-Touch Support

Handles multiple fingers and works across multiple UIWindows, essential for debugging complex, gesture-heavy interfaces in modern iOS apps.

Customizable Appearance

Allows customization of touch point color, image, size, and toggles for log display and timers, providing flexibility for different demo or debugging needs.

Lightweight and Swift Native

Built purely in Swift, ensuring seamless integration with modern iOS projects and avoiding Objective-C dependency overhead.

Cons

Simulator Limitations

Touch radius display doesn't work on the iOS simulator, a admitted limitation in the README that hampers debugging for developers without physical devices.

iOS Version Restriction

Requires iOS 9.0 or later, excluding support for older devices and apps targeting earlier iOS versions, which can be a barrier for legacy projects.

Limited Maturity

As noted in the README, it's less mature than COSTouchVisualizer, with fewer features and no support for iOS versions below 9.0, making it a niche choice.

Frequently Asked Questions

Related Projects

Kif

Keep It Functional - An iOS Functional Testing Framework

Stars6,248

Forks919

Last commit8 days ago

EarlGrey

:tea: iOS UI Automation Test Framework

Bluepill is a reliable iOS testing tool that runs UI tests using multiple simulators on a single machine

Stars3,208

Forks228

Last commit2 years ago

ViewInspector

Runtime introspection and unit testing of SwiftUI views

Stars2,628

Forks193