Skip to content
 
 

Repository files navigation

Tinycast

tinycast-cn 是面向中文用户的分支:完成了全量简体中文界面汉化,为中文应用名新增全拼与首字母搜索, 并基于上游发布版本构建 Universal(arm64 + x86_64)安装包。产品名仍为 Tinycast

brew trust --tap conversun/tinycast-cn   # 第三方 tap 需要先信任
brew tap conversun/tinycast-cn
brew install --cask tinycast-cn

后续 brew upgrade --cask tinycast-cn 即可更新。装成 Tinycast.app,与上游 tinycasttinycast-sequoia 两个 cask 占用同一路径,因此三者互斥,只能装其一。

A tiny, fully native macOS launcher — the essentials, without the bloat.

Join the Tinycast Discord Hire me — iabueammar@gmail.com License: AGPL-3.0

Tinycast command palette

Around 3 MB on disk and under 100 MB of RAM — no Electron, no telemetry, no background CPU churn. Just SwiftUI + AppKit with zero dependencies. It's fast because there's nothing to it.

It also runs Raycast extensions — the real ones, rendered as native SwiftUI. No Node.js, no browser: JavaScriptCore ships with macOS, so that costs no extra binary size.

Features

  • App launcher — fuzzy-search and launch anything, pin favorites, see what's running, quit an app or every app at once.
  • Custom commands — run named shell commands through fuzzy search or their own global hotkeys.
  • Calculator — do math, unit, live currency and crypto conversions inline, right in the palette.
  • Clipboard history — text and images, searchable, pasted back into the app you were using.
  • Snippets — reusable Markdown templates with dynamic placeholders, arguments, nested references and optional keyword expansion.
  • Global hotkey — one shortcut summons the palette from anywhere.
  • Per-app hotkeys — bind a key to an app; press it to toggle (focus/hide).
  • Raycast extensions — run the ones you already have natively, rendered as SwiftUI.

Install

brew trust --tap conversun/tinycast-cn   # required for third-party taps
brew tap conversun/tinycast-cn
brew install --cask tinycast-cn

Updates come the usual way: brew upgrade --cask tinycast-cn. The app has no built-in updater and makes no network call of its own unless you turn on currency conversion.

This is the Chinese build, installed as Tinycast.app — the same path the upstream tinycast and tinycast-sequoia casks own, so the cask conflicts with both. Pick one, or install the upstream tinycast@beta alongside it (that one is Tinycast Beta.app).

Tinycast is self-signed. Installing via Homebrew clears the macOS quarantine flag for you automatically on every install and update, so there's nothing to run. (If you download the DMG directly from Releases instead, clear it once: xattr -dr com.apple.quarantine "/Applications/Tinycast.app".)

Permissions

Accessibility — needed when Tinycast pastes or expands text into another app, and the only permission snippet keyword expansion needs. You're prompted when you first use a feature that needs it; grant access in System Settings → Privacy & Security → Accessibility. Snippets ship disabled, and keystrokes are matched locally, never stored and never sent anywhere.

Using it

  1. Open Settings → General and record a global shortcut to summon Tinycast.
  2. Press it anywhere → the palette floats in. Type to filter, to launch.
  3. Tab switches between Apps and Clipboard; ↑/↓ move, Esc dismisses.
  4. Settings → Shortcuts — search an app or custom command and record a global shortcut.
  5. Settings → Snippets — enable the feature, then create templates with expansion keywords.

Building from source

See docs/development.md for the toolchain, build, packaging, release and website workflows. docs/ indexes everything else — architecture, engineering standards, the design system and one document per feature.

Contributing

Important

Open an issue before you write code — this is mandatory. Get the bug or the feature agreed on first; discussing it in the issue (or on Discord) is strongly encouraged. A PR with no agreed issue behind it gets closed however good the patch is, and the work is wasted. Typo and docs-only fixes are the one exception.

Read CONTRIBUTING.md first — it covers the memory budget every PR is held to, the before/after video requirement for visual changes, and why features get declined. Every PR fills in the pull request template. Security issues go through SECURITY.md, not the issue tracker.

Questions, ideas, or just want to follow along? Join the Discord.

License

AGPL-3.0

About

Tinycast — a tiny, fully native macOS launcher, hotkeys, and clipboard history

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages