Skip to content

Repository files navigation

Fuwa app icon

Fuwa

Keep the window you need in front.

Official website · View releases · 简体中文

Latest release CI status on main MIT license

macOS 14+

Fuwa keeps the window you need on top of other apps on your Mac. Keep a reference image, document, or tutorial visible while you work, without switching back and forth. The pinned view lets clicks pass through to the app underneath.

Full feature tour

109 seconds · 4K · 60 fps · English female narration. Draft a shot list from a brief, keep tutorial settings in view, compare references, and write design notes beside an image.

fuwa-full-tour-en-4k.mp4

Real native interactions use English Fuwa UI and public sample documents, with Chinese and English narration and captions. Finder controls retain the system's Chinese language. Capture notes describe the recording-copy adaptations; watch the Chinese version.

Use

  1. Launch Fuwa and bring the target window to the front.
  2. Press ⌥⌘P to pin it. Press the shortcut again while the same source is in front to unpin.
  3. Manage pins and live or frozen state from the menu bar.

Features

  • Pin multiple windows and freeze frames.
  • Support for application windows and system previews of images and documents.
  • Customizable keyboard shortcut.
  • Mirrors pass mouse input through; Reveal Source activates and raises the real source window.
  • Window pixels and metadata stay on your computer, with no uploads, analytics, or telemetry.
  • Check, download, and install Ed25519-verified updates from Settings. No automatic background checks or installs.

Requirements

  • macOS 14 or later; the release archive includes arm64 (Apple silicon) and x86_64 (Intel). Physical Intel Mac acceptance is still pending.
  • Screen Recording permission, requested only on the first pin attempt.
  • Accessibility permission, requested only for Reveal Source.

Install

Download Fuwa-<version>.zip from GitHub Releases, extract it, and move Fuwa.app to /Applications. Every public package has a matching .sha256 file:

cd ~/Downloads
shasum -a 256 -c "Fuwa-<version>.zip.sha256"

Replace <version> with the actual version number. Versions v0.1.4 and earlier need one manual upgrade to v0.1.5 or later. After that, select Check for Updates in Fuwa Settings. Fuwa accepts only its fixed GitHub feed and packages verified by the embedded public key; verification failure never falls back to unsigned installation.

The macOS package uses the project's maintained local signing identity, not Apple Developer ID signing or notarization. If macOS blocks it, verify the source and SHA-256 and follow Apple's instructions, rather than weakening system security.

Build from source

Fuwa uses Swift, SwiftUI/AppKit, ScreenCaptureKit, and Sparkle.

git clone https://github.com/yuxino/fuwa.git
cd fuwa
./scripts/setup-local-signing.sh
./scripts/install-app.sh

Platform scope

Fuwa is now maintained for macOS only. Windows development and releases have ended. Existing Windows release files and Git history remain available as unsupported archives; future macOS releases will not provide Windows installers or update feeds.

Fuwa displays a mirror, not a change to another app's real window level. It does not bypass operating-system security boundaries or protected-content restrictions.

Privacy · Contributing · Security · Independent implementation

License

MIT © 2026 yuxino and Fuwa contributors

About

Always-on-top live window mirrors for macOS, with click-through and Finder Quick Look. 窗口悬浮镜像与快速查看置顶。

Topics

Resources

Contributing

Security policy

Stars

68 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages