tinycast README

The project's README from github.com/abue-ammar/tinycast. As one markdown file: README.md.

Tinycast

A tiny, fully native macOS launcher. One hotkey, everything you reach for all day, under 100 MB of RAM.

Latest release Swift 6.0 macOS 26 or later License: AGPL-3.0 Join the Tinycast Discord Support Tinycast

SwiftUI and AppKit, zero third-party dependencies, no Electron and no telemetry. It also runs real Raycast extensions, rendered as native SwiftUI. Free, open source, and staying that way.

For anything private, email [email protected].

Tinycast command palette

Support

Tinycast is free, and it stays that way. If it earns a place in your daily flow, a one-off tip helps keep it actively maintained. GitHub Sponsors isn't available in my country, so please support here:

Support Tinycast
Payments are handled securely by Polar.sh.

Features

Install

First, add the tap:

brew trust --tap abue-ammar/tinycast   # required for third-party taps
brew tap abue-ammar/tinycast

Then run the one line that matches your Mac:

Your Mac Install
Apple silicon, macOS 26 or newer brew install --cask tinycast
Intel, macOS 26 brew install --cask tinycast-universal

Not sure which you have? Apple menu → About This Mac. Homebrew checks too, and refuses the wrong one.

Want early builds? brew install --cask tinycast@beta puts Tinycast Beta.app beside the stable app, with its own settings and permissions. Apple silicon, macOS 26+.

Homebrew clears the macOS quarantine flag on every install and update, so there is nothing else to run. Downloading a DMG from Releases instead? Tinycast is self-signed, so clear the flag 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 that doesn't close an issue marked approved is closed automatically however good the patch is, and the work is wasted. Docs-only fixes are the one exception.

Tinycast's feature set is deliberately closed, and "another launcher has it" is not a reason on its own. Ask whether a feature is wanted before you ask for it.

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.

Star History

Star History Chart

License

AGPL-3.0

tinycast (abue-ammar/tinycast)

Searching Database…

这是什么?Tinycast 是一款小巧、完全原生的 macOS 启动器:按一个全局快捷键就能呼出一个面板,用来启动应用、查看剪贴板历史、使用文本片段、排列窗口等等——内存占用不到 100 MB。
这是我装在 Mac 上的应用,还是给开发者用的库?一款普通的 macOS 应用——用 SwiftUI 和 AppKit 构建,零第三方依赖,不用 Electron。它甚至能把 Raycast 扩展渲染成原生的 SwiftUI 界面。
我的 Mac 能运行它吗?只支持较新的 macOS:Apple 芯片需要 macOS 26 或更新版本,Intel 芯片在 macOS 26 上可通过 tinycast-universal 这个 cask 安装。Homebrew 会检查你的芯片类型,装错了会直接拒绝。
它需要特殊的系统权限吗?只需要一项:辅助功能(Accessibility),而且仅在 Tinycast 向其他应用粘贴或展开文字时才会用到——文本片段关键词展开是唯一需要该权限的功能。你第一次使用这类功能时会收到授权提示。
它会收集我的数据吗?没有任何遥测,文本片段的按键匹配完全在本地进行——不会存储,也不会发送到任何地方。AI 功能默认关闭,使用时需要你自己的密钥。
除了启动应用,它还有哪些功能?支持文字和图片的剪贴板历史、带动态占位符的 Markdown 文本片段、34 种 Rectangle 风格的窗口操作(半屏、四分之一、三分之一、Space 切换)、内置计算器(支持单位换算、实时汇率和加密货币换算)、快速链接、Apple 快捷指令、纯 Markdown 笔记、表情符号选择器、系统操作,以及从日历一键或自动加入会议。
AI 功能能做什么?你可以在面板里直接聊天,使用自己的 API 密钥或已登录的 AI 账号;快速操作还能在任何应用中对选中的文字纠错语法、改写、翻译或总结。所有 AI 功能默认都是关闭的。
有测试版渠道吗?有——运行 brew install --cask tinycast@beta 即可把 Tinycast Beta.app 安装在正式版旁边,两者拥有各自独立的设置和权限。
Creator
abue-ammar
Size
71.6 MB
Stars
8.7K
Age
3mo
Commits · 90 Days