Dla deweloperów

Switchbar API

Switchbar ma API oparte na adresach URL. Otwórz specjalnie sformatowany URL, a Switchbar natychmiast zacznie działać — wyśle link do odpowiedniej przeglądarki lub klienta e-mail albo poprosi Cię o wybór.

Jak to działa

switchbar://open/<link>
  • Linki internetowe i e-mail

    Przekaż dowolny link https://, http:// lub mailto:.

  • Obowiązują Twoje reguły

    Link przechodzi przez Twoje reguły i ustawienia linków, tak jak przy kliknięciu. Jeśli żadna reguła nie pasuje, Switchbar zapyta, gdzie go otworzyć.

  • Bez kodowania

    Dodaj link w niezmienionej postaci po switchbar://open/, bez kodowania.

Przykłady

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)

Działa z adresami URL Choosy

Switchbar otwiera też linki API Choosy, więc skrypty i narzędzia stworzone dla Choosy działają bez zmian.

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