Tinkle

Tinkle is a macOS app which appends a visual effect for the focused window changes.
It helps finding the focused window when you switched it by keyboard shortcuts.

Download

You can download from https://tinkle.pqrs.org/.

Supported systems

macOS 11 Big Sur or later.

Required privilege

Tinkle requires accessibility features in order to detect the focused window changes.

---

For developers

How to build

System requirements to build Tinkle:

• macOS 11.0+
• Xcode 13+
• Command Line Tools for Xcode
• XcodeGen
• create-dmg

Steps

1. Get source code by executing a following command in Terminal.app.

   git clone --depth 1 https://github.com/pqrs-org/Tinkle.git
   cd Tinkle
   git submodule update --init --recursive --depth 1

2. Find your codesign identity if you have one.
   (Skip this step if you don't have your codesign identity.)

   security find-identity -p codesigning -v | grep 'Developer ID Application'

   The result is as follows.

   1) 8D660191481C98F5C56630847A6C39D95C166F22 "Developer ID Application: Fumihiko Takayama (G43BCU2T37)"
   

   Your codesign identity is 8D660191481C98F5C56630847A6C39D95C166F22 in the above case.

3. Set environment variable to use your codesign identity.
   (Skip this step if you don't have your codesign identity.)

   export PQRS_ORG_CODE_SIGN_IDENTITY=8D660191481C98F5C56630847A6C39D95C166F22

4. Build a package by executing a following command in Terminal.app.

   make package

   Tinkle-*.dmg will be generated.

   Note: If you don't have codesign identity, the dmg works only on your machine.

Update/Add effects

The project uses Metal's compute shaders to create effects, which are stored in src/Share/metal. To preview these effects, the project includes a tool called ShaderViewer. This tool allows you to conveniently review and modify the shaders.