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

1. Select Edit Extensions… from the macOS Share menu.

   Launch Safari. In the top of the window look for the Share toolbar icon as shown below.

   

   Tap on the toolbar icon and look for the menu item "Edit Extensions…" as shown below.

   

   Tap on "Edit Extensions…" to launch the macOS Settings app and raise a pop-up window titled Sharing shown in the next section.

2. Enable Captee in the Share Extension Preferences

   This menu lists the possible extensions to add to the Share Menu.

   

   Scroll down this window to find "Captee - Share Markup Link" and enable it as shown below.

   

3. Exit Settings

   Press the Done button at the bottom of the pop-up window to dismiss it, then quit the Settings app.

4. 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 links, 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.

Org Protocol is a custom URL scheme for Emacs Org Mode. With Org Protocol, apps external to Emacs can share content and trigger actions to an Org file via a URL scheme.

Worg is a resource for more info on Org Protocol.

For most Emacs users on macOS, the build of Emacs is the NS build which requires a 3^rd party solution to support Org Protocol. The Scrim utility app (sold separately) is such a solution.

Users of the Mitsuharu Yamamoto fork of Emacs do not need to setup an Org protocol scheme handler as this fork will natively handle Org protocol URL requests.

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.