Skip to content

kickingvegas/scrim

Repository files navigation

Scrim

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.

Features

  • 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.

Requirements

  • macOS 15.x (Sequoia)
  • Scrim is designed to work directly with the GNU Free Software Foundation version of Emacs 29.4+.
  • Your local setup of Emacs must run server to support org‑protocol://.
    • In addition, server must be setup to use a TCP socket.

Mac App Store

Scrim is available on the Mac App Store.

License

Scrim is GPLv3 licensed.

Acknowledgments

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.
  • wasamasa for their design notes on the emacsclient protocol.