Untuk pengembang

API Switchbar

Switchbar memiliki API berbasis URL. Buka URL yang diformat secara khusus dan Switchbar langsung beraksi — mengirim tautan ke browser atau klien email yang tepat, atau meminta kamu memilih salah satunya.

Cara kerjanya

switchbar://open/<link>
  • Tautan web dan email

    Berikan tautan https://, http://, atau mailto: apa pun.

  • Aturan Anda berlaku

    Tautan melewati aturan dan pengaturan tautan Anda, sama seperti saat diklik. Jika tidak ada aturan yang cocok, Switchbar menanyakan di mana harus membukanya.

  • Tanpa encoding

    Tambahkan tautan apa adanya setelah switchbar://open/, tanpa melakukan encoding.

Contoh

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)

Kompatibel dengan URL Choosy

Switchbar juga membuka tautan API Choosy, jadi skrip dan alat yang dibuat untuk Choosy berfungsi tanpa perubahan.

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