search

pqrs-org / Tinkle

https://tinkle.pqrs.org
The Unlicense
83 stars 4 forks source link
macos

readme

Build Status License

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.

Tinkle

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.

accessibility access

For developers

How to build

System requirements to build Tinkle:

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.