Protocol Launcher

English

简体中文

English

简体中文

Appearance

Tembo ​

Tembo is a macOS file search app. Protocol Launcher allows you to generate Tembo URL scheme links.

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.

Notes ​

Houdah's official Tembo article documents the URL format as tembo2://search?query=[QUERY]&location=[LOCATION]&group=[GROUP]. The location and group parameters are optional additions to the search query, and location can be repeated to show multiple paths in Tembo's locations menu.

The group value is limited to Tembo's official values: APPLICATIONS, BOOKMARKS, CONTACTS, DIRECTORIES, CALENDAR, EVERNOTE, FONTS, IMAGES, MESSAGES, MOVIES, MUSIC, PDF, SOURCE, SYSTEM_PREFS, and XML.

The same official article also shows Alfred's custom search URL as tembo2://search?q={query}. Pass q instead of query only when you need that documented short parameter.

Start a Tembo search with query text.

On-Demand
ts
import { search } from 'protocol-launcher/tembo'

const url = search({
  query: 'Houdah Software',
})
Search

Search In Location ​

Start a Tembo search with a specific location.

On-Demand
ts
import { searchInLocation } from 'protocol-launcher/tembo'

const url = searchInLocation({
  query: 'Houdah Software',
  location: '~/Documents',
})
Search In Location

Search Multiple Locations ​

Pass an array to repeat Tembo's documented location parameter.

On-Demand
ts
import { searchInLocation } from 'protocol-launcher/tembo'

const url = searchInLocation({
  query: 'Houdah Software',
  location: ['~/Documents', '~/Desktop'],
  group: 'PDF',
})
Search Multiple Locations

Search Group ​

Start a Tembo search in one of the official groups.

On-Demand
ts
import { searchGroup } from 'protocol-launcher/tembo'

const url = searchGroup({
  query: 'Houdah Software',
  group: 'PDF',
})
Search Group

Alfred Short Query Parameter ​

Generate the official Alfred custom search form with q.

On-Demand
ts
import { search } from 'protocol-launcher/tembo'

const url = search({
  q: 'Houdah Software',
})
Alfred Search

Generated URLs ​

ts
search({ query: 'Houdah Software' })
// => 'tembo2://search?query=Houdah%20Software'

search({
  query: 'Houdah Software',
  location: '~/Documents',
  group: 'PDF',
})
// => 'tembo2://search?query=Houdah%20Software&location=~/Documents&group=PDF'

searchInLocation({
  query: 'Houdah Software',
  location: '~/Documents',
})
// => 'tembo2://search?query=Houdah%20Software&location=~/Documents'

searchInLocation({
  query: 'Houdah Software',
  location: ['~/Documents', '~/Desktop'],
  group: 'PDF',
})
// => 'tembo2://search?query=Houdah%20Software&location=~/Documents&location=~/Desktop&group=PDF'

searchGroup({
  query: 'Houdah Software',
  group: 'PDF',
})
// => 'tembo2://search?query=Houdah%20Software&group=PDF'

search({ q: 'Houdah Software' })
// => 'tembo2://search?q=Houdah%20Software'

Official Documentation ​