Para desenvolvedores

API do Switchbar

O Switchbar tem uma API baseada em URL. Abra uma URL em um formato especial e o Switchbar entra em ação — enviando um link para o navegador ou cliente de e-mail certo, ou solicitando que você escolha um.

Como funciona

switchbar://open/<link>

Links da web e de e-mail
Passe qualquer link https://, http:// ou mailto:.
Suas regras valem
O link passa pelas suas regras e configurações de links, como um clique. Se nenhuma regra corresponder, o Switchbar pergunta onde abri-lo.
Sem codificação
Adicione o link como está depois de switchbar://open/, sem codificá-lo.

Exemplos

Terminal

# macOS
open "switchbar://open/https://example.com"
open "switchbar://open/mailto:hello@example.com"

# Windows
start "" "switchbar://open/https://example.com"

AppleScript

open location "switchbar://open/https://example.com"

JavaScript

window.location.href = "switchbar://open/https://example.com";

Swift

let url = URL(string: "switchbar://open/https://example.com")!
NSWorkspace.shared.open(url)

Compatível com URLs do Choosy

O Switchbar também abre links da API do Choosy, então scripts e ferramentas criados para o Choosy funcionam sem alterações.

x-choosy://open/
x-choosy://prompt.all/
x-choosy://prompt.running/
x-choosy://best.all/
x-choosy://best.running/