#+TITLE:   os/macos
#+DATE:    February 19, 2017
#+SINCE:   v1.3
#+STARTUP: inlineimages nofold

* Table of Contents :TOC_3:noexport:
- [[#description][Description]]
  - [[#module-flags][Module Flags]]
  - [[#maintainers][Maintainers]]
  - [[#plugins][Plugins]]
- [[#features][Features]]
  - [[#open-with-x]["Open with X"]]

* Description
This module provides extra functionality for macOS.

** Module Flags
This module provides no flags.

** Maintainers
This module has no dedicated maintainers

** Plugins
+ [[https://github.com/emacsorphanage/osx-trash][osx-trash]]
+ [[https://github.com/purcell/ns-auto-titlebar][ns-auto-titlebar]]

* Features
** "Open with X"
This module adds various macOS-specific launchers under the =SPC o= prefix (=C-c
o= for users with Evil disabled).

It also enables Keychain integration for =auth-source=. This is used by our [[file:../../../modules/app/irc/README.org][irc]]
and [[file:../../../modules/tools/magit/README.org][magit]]-forge modules, for instance.

To support GitHub Forge add an internet password like this to your keychain:
| Field    | Value                   |
|----------+-------------------------|
| Name     | api.github.com          |
| Kind     | Internet password       |
| Account  | <username>^forge        |
| Where    | https://api.github.com/ |
| Password | <token>                 |