Для разработчиков

API Switchbar

У Switchbar есть API на основе URL. Откройте специально сформированный URL, и Switchbar тут же начнёт работу — отправит ссылку в нужный браузер или почтовый клиент либо предложит выбрать один из них.

Как это работает

switchbar://open/<link>
  • Веб-ссылки и ссылки на почту

    Передайте любую ссылку https://, http:// или mailto:.

  • Действуют ваши правила

    Ссылка проходит через ваши правила и настройки ссылок, как при обычном клике. Если ни одно правило не подходит, Switchbar спросит, где её открыть.

  • Без кодирования

    Добавьте ссылку как есть после switchbar://open/, без кодирования.

Примеры

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)

Поддержка URL Choosy

Switchbar также открывает ссылки Choosy API, поэтому скрипты и инструменты для Choosy работают без изменений.

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

© 2026 WebCatalog, Inc.