Shortcut to Everything

An open-source kit to optimize your developer workflow

script kit

App Launcher

Search for an app then launch it

Book Search

Use Open Library API to search for books

Center App

Center the frontmost app

Giphy

Search giphy. Paste link.

Resize an Image

Select an image in Finder. Type option + i to resize it.

Browse Reddit from Script Kit

// Menu: App Launcher
// Description: Search for an app then launch it
// Author: John Lindquist
// Twitter: @johnlindquist

let createChoices = async () => {
  let apps = await fileSearch("", {
    onlyin: "/",
    kind: "application",
  })

  let prefs = await fileSearch("", {
    onlyin: "/",
    kind: "preferences",
  })

  let group = path => apps =>
    apps
      .filter(app => app.match(path))
      .sort((a, b) => {
        let aName = a.replace(/.*\//, "")
        let bName = b.replace(/.*\//, "")

        return aName > bName ? 1 : aName < bName ? -1 : 0
      })

  return [
    ...group(/^\/Applications\/(?!Utilities)/)(apps),
    ...group(/\.prefPane$/)(prefs),
    ...group(/^\/Applications\/Utilities/)(apps),
    ...group(/System/)(apps),
    ...group(/Users/)(apps),
  ].map(value => {
    return {
      name: value.split("/").pop().replace(".app", ""),
      value,
      description: value,
    }
  })
}

let appsDb = await db("apps", async () => ({
  choices: await createChoices(),
}))

let app = await arg("Select app:", appsDb.choices)
let command = `open -a "${app}"`
if (app.endsWith(".prefPane")) {
  command = `open ${app}`
}
exec(command)

Download Script Kit for macOS:

Intel

Apple Sillicon

video course

Script Kit Showcase for Optimizing Your Everyday Workflows – by John Lindquist

Get Up and Running with Script Kit →

9 lessons24m

What is Script Kit?

How often do you avoid scripting something because it takes too much effort?

Script Kit makes it easy to create and run scripts that solve your daily problems. Create a new script from the prompt then your script opens in the editor of your choice. Write a few lines of JavaScript. Then run the script from the prompt.

Simply put, Script Kit helps you script away the friction of your day.

Key Features

▪︎Launch the prompt from anywhere as part of your flow
▪︎Add keyboard shortcuts with comments://Shortcut: opt a
▪︎Prompt for input with:await arg("First name")
▪︎Prompt for environment vars:await env("GITHUB_TOKEN")
▪︎Load npm libraries:await npm("sharp")
▪︎Share scripts directly from the prompt
▪︎Launch scripts from a Stream Deck button
▪︎Scripts behave the same in your terminal

Learn more

Script Kit includes a built-in tutorial and myriad examples are available on our discussions pages:

Featured Scripts

app-launcher

by John Lindquist

Search for an app then launch it

// Menu: App Launcher
// Description: Search for an app then launch it
// Author: John Lindquist
// Twitter: @johnlindquist

let createChoices = async () => {
  let apps = await fileSearch("", {
    onlyin: "/",
    kind: "application",
  })

  let prefs = await fileSearch("", {
    onlyin: "/",
    kind: "preferences",
  })

  let group = path => apps =>
    apps
      .filter(app => app.match(path))
      .sort((a, b) => {
        let aName = a.replace(/.*\//, "")
        let bName = b.replace(/.*\//, "")

        return aName > bName ? 1 : aName < bName ? -1 : 0
      })

  return [
    ...group(/^\/Applications\/(?!Utilities)/)(apps),
    ...group(/\.prefPane$/)(prefs),
    ...group(/^\/Applications\/Utilities/)(apps),
    ...group(/System/)(apps),
    ...group(/Users/)(apps),
  ].map(value => {
    return {
      name: value.split("/").pop().replace(".app", ""),
      value,
      description: value,
    }
  })
}

let appsDb = await db("apps", async () => ({
  choices: await createChoices(),
}))

let app = await arg("Select app:", appsDb.choices)
let command = `open -a "${app}"`
if (app.endsWith(".prefPane")) {
  command = `open ${app}`
}
exec(command)

book-search

by John Lindquist

Use Open Library API to search for books

// Menu: Book Search
// Description: Use Open Library API to search for books
// Author: John Lindquist
// Twitter: @johnlindquist

let query = await arg('Search for a book title:')

//This API can be a little slow. Wait a couple seconds
let response = await get(`http://openlibrary.org/search.json?q=${query}`)

let transform = ({title, author_name}) =>
  `* "${title}" - ${author_name?.length && author_name[0]}`

let markdown = response.data.docs.map(transform).join('\n')

inspect(markdown, 'md')

center-app

by John Lindquist

Center the frontmost app

// Menu: Center App
// Description: Center the frontmost app
// Author: John Lindquist
// Twitter: @johnlindquist

let { workArea, bounds } = await getActiveScreen()

let { width, height } = workArea
let { x, y } = bounds
let padding = 100

let top = y + padding
let left = x + padding
let right = x + width - padding
let bottom = y + height - padding

setActiveAppBounds({
  top,
  left,
  right,
  bottom,
})

giphy-search

by John Lindquist

Search giphy. Paste link.

// Menu: Giphy
// Description: Search giphy. Paste link.
// Author: John Lindquist
// Twitter: @johnlindquist

let download = await npm("image-downloader")
let queryString = await npm("query-string")

let GIPHY_API_KEY = await env("GIPHY_API_KEY", {
  hint: md(
    `Get a [Giphy API Key](https://developers.giphy.com/dashboard/)`
  ),
  ignoreBlur: true,
  secret: true,
})

let search = q =>
  `https://api.giphy.com/v1/gifs/search?api_key=${GIPHY_API_KEY}&q=${q}&limit=10&offset=0&rating=g&lang=en`

let { input, url } = await arg(
  "Search giphy:",
  async input => {
    if (!input) return []
    let query = search(input)
    let { data } = await get(query)

    return data.data.map(gif => {
      return {
        name: gif.title.trim() || gif.slug,
        value: {
          input,
          url: gif.images.original.url,
        },
        preview: `<img src="${gif.images.downsized.url}" alt="">`,
      }
    })
  }
)

let formattedLink = await arg("Format to paste", [
  {
    name: "URL Only",
    value: url,
  },
  {
    name: "Markdown Image Link",
    value: `![${input}](${url})`,
  },
  {
    name: "HTML <img>",
    value: `<img src="${url}" alt="${input}">`,
  },
])

setSelectedText(formattedLink)

image-resize

by John Lindquist

Select an image in Finder. Type option + i to resize it.

// Menu: Resize an Image
// Description: Select an image in Finder. Type option + i to resize it.
// Author: John Lindquist
// Twitter: @johnlindquist
// Shortcut: opt i

let sharp = await npm("sharp")

let imagePath = await getSelectedFile()

let width = Number(await arg("Enter width:"))

let metadata = await sharp(imagePath).metadata()

let newHeight = Math.floor(
  metadata.height * (width / metadata.width)
)

let lastDot = /.(?!.*\.)/
let resizedImageName = imagePath.replace(
  lastDot,
  `-${width}.`
)

await sharp(imagePath)
  .resize(width, newHeight)
  .toFile(resizedImageName)

by John Lindquist

Browse Reddit from Script Kit

// Menu: Reddit
// Description: Browse Reddit from Script Kit
// Author: John Lindquist
// Twitter: @johnlindquist

let Reddit = await npm("reddit")

let envOptions = {
  ignoreBlur: true,
  hint: md(
    `[Create a reddit app](https://www.reddit.com/prefs/apps)`
  ),
  secret: true,
}

let reddit = new Reddit({
  username: await env("REDDIT_USERNAME"),
  password: await env("REDDIT_PASSWORD"),
  appId: await env("REDDIT_APP_ID", envOptions),
  appSecret: await env("REDDIT_APP_SECRET", envOptions),
  userAgent: `ScriptKit/1.0.0 (https://scriptkit.com)`,
})

let subreddits = [
  "funny",
  "aww",
  "dataisbeautiful",
  "mildlyinteresting",
  "RocketLeague",
]

subreddits.forEach(sub => {
  onTab(sub, async () => {
    let url = await arg(
      "Select post to open:",
      async () => {
        let best = await reddit.get(`/r/${sub}/hot`)

        return best.data.children.map(({ data }) => {
          let {
            title,
            thumbnail,
            url,
            subreddit_name_prefixed,
            preview,
          } = data

          let resolutions =
            preview?.images?.[0]?.resolutions
          let previewImage =
            resolutions?.[resolutions?.length - 1]?.url

          return {
            name: title,
            description: subreddit_name_prefixed,
            value: url,
            img: thumbnail,
            ...(previewImage && {
              preview: md(`
![${title}](${previewImage})

### ${title}          
                `),
            }),
          }
        })
      }
    )

    exec(`open "${url}"`)
  })
})