LaunchBar

LaunchBar is a macOS launcher and productivity utility. Protocol Launcher allows you to generate deep links for LaunchBar.

Usage

There are two ways to use this library:

• On-Demand import from subpaths enables tree-shaking and keeps bundles small.
• Full Import from the root package is convenient but includes all app modules.

Pick On-Demand for production builds; Full Import is fine for quick scripts or demos.

Select Installation Method

On-Demand

Recommended. Optimized for production.

Full Import

Convenient. Good for quick scripts.

URL Methods

The helpers below mirror LaunchBar's official URL Commands and Calculator documentation. The documented execute command only works in conjunction with LaunchBar Search Templates.

Large Type

On-Demand

import { largeType } from 'protocol-launcher/launchbar'

const url = largeType({
  string: 'LaunchBar 4.3',
})

const titleUrl = largeType({
  title: 'Large Type',
  string: 'Small Example',
})

const fontUrl = largeType({
  fontName: 'Times-Bold',
  string: 'Hello World',
})

Show Large Type Show Large Type With Title Show Large Type With Font

Select Item

On-Demand

import { select } from 'protocol-launcher/launchbar'

const fileUrl = select({
  file: '/Applications',
})

const urlItem = select({
  url: 'www.obdev.at',
})

const namedUrl = select({
  url: 'www.obdev.at',
  name: 'Objective Development',
})

const stringUrl = select({
  string: "Hello, I'm a text",
})

const abbreviationUrl = select({
  abbreviation: 'SAFARI',
})

Select Applications Folder Select URL Select Named URL Select Text Select Abbreviation

Execute Search Template Command

On-Demand

import { execute } from 'protocol-launcher/launchbar'

const singleArgumentUrl = execute({
  path: '/usr/local/bin/MyScript',
  argument: '*',
})

const argumentsUrl = execute({
  path: '/usr/bin/open',
  arguments: '-a "*"',
})

Calculate

On-Demand

import { calculate } from 'protocol-launcher/launchbar'

const url = calculate({
  expression: '2*sin(pi/4)^2',
})

const titleUrl = calculate({
  expression: '(1+sqrt(5))/2',
  title: 'Golden Ratio',
})

const resultUrl = calculate({
  expression: '(1+sqrt(5))/2',
  title: 'Golden Ratio',
  result: 'φ=@',
})

const templateUrl = calculate({
  argument: '*',
  expression: '(@-32)/1.8',
  title: '@°F =',
  result: '@°C',
})

const celsiusTemplateUrl = calculate({
  argument: '*',
  expression: '@*1.8+32',
  title: '@°C =',
  result: '@°F',
})

Calculate Expression Calculate With Title Calculate With Result Format

Hide LaunchBar

On-Demand

import { hide } from 'protocol-launcher/launchbar'

const url = hide()

Hide LaunchBar