Skip to content

agnostic-ap/kitty-screen

 
 

Repository files navigation

Kitty Screen

中文说明 · Detailed Tutorial · GitHub · Download

Kitty Screen is a screen-break reminder desktop app built with Tauri + React. After you have been looking at the screen for a configured amount of time, a transparent animated cat appears on top of all your windows and stays until a countdown finishes — reminding you to look away and rest your eyes.

Looking for the browser extension version? → kitty-screen-extension

Kitty Screen app icon

Preview

Kitty Screen overlay preview 1 Kitty Screen overlay preview 2


Download

Download the latest build from GitHub Releases.

  • macOS: Kitty.Screen_x.x.x_universal.dmg
  • Windows: Kitty.Screen_x.x.x_x64-setup.exe

Customizing Your Own Cat

You can replace the built-in cat with any cat — real or AI-generated. The workflow:

  1. Prepare reference photos — collect clear photos of your cat from multiple angles.
  2. Generate 12 green-screen keyframes — use GPT-4o Image or Midjourney with your cat photos as identity references and assets/raw-furryball/001–012.png as pose guides.
  3. Generate two green-screen videos — use Runway Gen-4, Kling, or Sora.
  4. Convert to transparent resourcesbun run videos removes the green background via FFmpeg.
  5. Preview and tune — run the app and adjust chroma-key parameters if needed.

See TUTORIAL.md for step-by-step instructions with exact prompts and tool recommendations.

Prompt templates for image and video generation are in PROMPTS.md.


Development

Requirements

Commands

bun install          # install dependencies
bun run dev          # Vite dev server (frontend only)
bun run app:dev      # full Tauri desktop app
bun run videos       # generate transparent video resources from assets/
bun run build        # production build
bun run check        # format + typecheck + lint

Credits

Originally made by Elliot and his daughter "毛球" (a 4-year-old Norwegian Forest cat).

About

🐱 护眼提醒工具:长时间盯屏幕后,一只猫咪会出现并遮住屏幕。支持桌面版(macOS/Windows)和浏览器版,可替换成你自己的猫咪。

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • TypeScript 42.4%
  • JavaScript 28.6%
  • Rust 19.0%
  • CSS 9.7%
  • HTML 0.3%