Skip to content

Extensions and BLF ​

Extensions (busy lamp field, BLF) show whether colleagues' phones are idle, ringing or busy. Add watched extensions per account in config.toml or in Settings > Extensions.

Extensions shown as keysExtensions shown as keys
toml
[[account]]
# ... account settings ...

[[account.blf]]
uri = "1004"
label = "Support queue"
group = "Support"

Subscriptions use the SIP dialog event package. Entries are diffed by uri, so adding, removing and editing them is hot.

Views ​

[ui] blf_view selects the layout: keys (default), lamps or list. blf_group_by is account (default), group or none. Use / to focus the filter, which matches name, extension or group.

Click behaviour ​

SituationSettingDefault
Click an idle extensionblf_click: dial or prefill (fill the dial field)dial
Click during a callblf_click_in_call: menu, consult or blindmenu (consult, transfer or new call)
Click a ringing extensionblf_click_ringing: pickup or callpickup

Directed pickup ​

While an extension is ringing, clicking it can pick up that call, provided pickup is configured for the account or entry. Set pickup = "prefix" with pickup_prefix (for example **, giving **1004), or use pickup_target for queue codes. replaces (SIP Replaces) is experimental and not interop-verified; prefer prefix. Full rules: Directed pickup.

toml
[[account]]
pickup = "prefix"       # off | prefix | replaces
pickup_prefix = "**"

If keys look stale, check the subscription state: BLF subscription health.

Source-available under FSL-1.1-ALv2. Questions: oss@zyno.io