Scrim is an Org Protocol proxy for Emacs on macOS.
With Scrim, 3rd party native apps can send links and text clippings to an Emacs Org file by simply opening a custom URL scheme (org‑protocol://).
Scrim is a native app that is designed to work with the security policies of macOS. No workarounds that involve relaxing security policy is required.
While Scrim can work with any program that is capable of generating an org‑protocol:// request, it is intended to work in tandem with Captee, a utility to share links and text clippings from the macOS Share Menu, which many native macOS apps support.
- Send links and text clippings to an Emacs Org file via Org Protocol.
- Open or create files on your local file system in Emacs via the
scrim://custom URL scheme. - Open Emacs Info pages (nodes) via the
scrim://custom URL scheme.- More info on the Scrim Protocol.
- macOS 15.x (Sequoia)
- Scrim is designed to work directly with the GNU Free Software Foundation version of Emacs 29.4+.
- The Mitsuharu Yamamoto fork (aka Emacs Mac App) has been modified to natively support
org‑protocol://. If you use this, you do not need Scrim.
- The Mitsuharu Yamamoto fork (aka Emacs Mac App) has been modified to natively support
- Your local setup of Emacs must run server to support
org‑protocol://.- In addition, server must be setup to use a TCP socket.
Scrim is available on the Mac App Store.
Scrim is GPLv3 licensed.
Much appreciation to the Org and Emacs development teams whose towering efforts this work builds upon.
Personal thanks goes out to:
- Mark Rowe and Helge Heß for improving my understanding of macOS security policy which was instrumental to implementing Scrim.
wasamasafor their design notes on the emacsclient protocol.