When Captee is first installed, you will need to enable the permission to let it be included in the Share menu. The following steps illustrate how to enable Captee for the Share menu.

1. Select Edit Extensions… from the macOS Share menu. This will launch macOS Settings and raise a pop-up window.

There are no actions to be done in the pop-up. Press the Done button at the bottom of the pop-up window to dismiss it.

2. Select Added extensions.

A pop-up window showing 3rd-party extensions that can be enabled for sharing is raised. Captee should be listed with its Sharing checkbox unchecked.

3. Enable the checkbox for Sharing for Captee and select Done to dismiss the pop-up window.

Success! Captee is now enabled in the macOS Share menu.

Chrome puts the macOS Share menu in the top-level menu bar File > Share. Some history on why it was put there: 465302 - Introduce system Share menu item on OS X - chromium

Sharing selected text is long-standing request on the Chromium team. Ticket here: 916291 - Add Share to context menu on macOS - chromium

Captee supports translating styled text (for example bold, italic, code, underline, strikethrough) and lists to Markdown or Org markup. Headers however are not supported, as macOS does not provide this information in formatted text that is exchanged through the clipboard.

Captee can share a link or content directly to Emacs through the use of Org Protocol. Org Protocol is a means for external applications to share content and trigger actions to Emacs Org Mode via a URL scheme.

To capture selected text via org-protocol you’ll need to define a capture template on the Emacs side first before you use Captee. Here’s an example capture template using the key "a" that uses the placeholders described in the Org capture protocol.

1
2
3
4
5
6

(setq org-capture-templates
      '(
        ("a" "Captee Capture" entry
         (file+headline "~/org/captee.org" "Captee Captures")
         "* %:description\n%:annotation\n%i\n%?" :empty-lines 1)
        ))

Template placeholders you can use in a capture template are as follows:

Learn more about capture templates at the official Org website.

At current (2023-05-05) only builds which use the Mitsuharu Yamamoto fork of Emacs will support Org Protocol natively. Native Org Protocol support means that support for handling the custom URL scheme org-protocol:// is configured and code-signed into the Emacs app bundle.

Known builds of Emacs that support Org Protocol natively are available at the following links:

• MacPorts
• Homebrew

Out of the box, Emacs Plus does not directly support Org Protocol URL handling on macOS. This is a known issue as described in the following ticket.

Enable org-protocol support out of the box · Issue #285 · d12frosted/homebrew-emacs-plus

A core feature to Captee is its ability to be in the macOS Share menu. Apps in the Share menu must be app sandboxed, effectively requiring that such apps be distributed on the App Store. However, app sandboxing also effectively prevents Captee from supporting Org Protocol via emacsclient because emacsclient operates outside of Captee's sandbox.