explaingit

yyx990803/telekinesis

Analysis updated 2026-07-17 · repo last pushed 2013-05-14

10JavaScriptAudience · developerComplexity · 2/5DormantSetup · easy

TLDR

Telekinesis simulates human touch gestures like taps, drags, and swipes in code, so you can automatically test touch-based apps without touching a device.

Mindmap

mindmap
  root((repo))
    What it does
      Simulates taps and drags
      Automates touch gestures
      Verifies app response
    Tech stack
      JavaScript
      Finger object API
    Use cases
      Test drawing apps
      Automate drag gestures
      Repeat touch tests
    Audience
      Developers
      QA teams
    Setup
      Create a finger object
      Define drag path
      Run callback on done

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Automatically test that a drawing app's brush responds to drag gestures

USE CASE 2

Run hundreds of repeated tap or swipe tests without manual touching

USE CASE 3

Verify touch-based UI features behave correctly across many paths

USE CASE 4

Replace manual QA touch testing with consistent scripted gestures

What is it built with?

JavaScript

How does it compare?

yyx990803/telekinesisagi-ruby/ai-gpt_image2-seedance_2.0-video-skillsgaearon/react-aux
Stars101010
LanguageJavaScriptJavaScriptJavaScript
Last pushed2013-05-142017-11-29
MaintenanceDormantDormant
Setup difficultyeasyeasyeasy
Complexity2/51/51/5
Audiencedevelopervibe coderdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 30min

README doesn't document all supported gesture types or framework integration.

In plain English

Telekinesis is a tool that simulates human touch gestures on a screen, like taps, drags, and swipes, so you can test mobile apps and web apps automatically without actually touching a device. Think of it like a robot hand that can touch your app the same way a real person would. When you're testing an app, instead of manually tapping and dragging on a phone over and over, you write code that tells Telekinesis where to tap and drag. It then performs those exact gestures so you can verify your app responds correctly. In the code example, a "finger" object is created, then told to drag from one spot on the screen to another, and run a callback when done. This is useful for developers and QA teams who need to test touch-based features repeatedly. For example, if you're building a drawing app and want to make sure the brush works when users drag their finger across the canvas, you could write a test using Telekinesis that automatically performs that drag gesture hundreds of times, or with dozens of different paths, without anyone manually touching the device. It's part of the broader category of test automation, replacing manual, repetitive work with code that does it consistently and fast. The project is fairly minimal based on the README provided, it doesn't explain all the gesture types it supports or how to integrate it into a testing framework. But the core idea is straightforward: it bridges the gap between automated testing and real user behavior by programmatically simulating the touches and gestures that actual users would do.

Copy-paste prompts

Prompt 1
Show me how to create a finger object and simulate a drag gesture with Telekinesis.
Prompt 2
Help me write a test that repeats a swipe gesture across different paths.
Prompt 3
Explain how Telekinesis's gesture simulation compares to manually testing on a device.
Prompt 4
Walk me through integrating Telekinesis into a touch-app test suite.

Frequently asked questions

What is telekinesis?

Telekinesis simulates human touch gestures like taps, drags, and swipes in code, so you can automatically test touch-based apps without touching a device.

What language is telekinesis written in?

Mainly JavaScript. The stack also includes JavaScript.

Is telekinesis actively maintained?

Dormant — no commits in 2+ years (last push 2013-05-14).

How hard is telekinesis to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is telekinesis for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.