Installing add-ons

Find add-ons in the Add-on Store in Settings, or load one from a folder on your Mac. Either way, Ledge checks the package and asks you before it runs anything.

From the Store

  1. Open Ledge's Settings and choose Add-on Store. Ledge fetches the published catalogue.
  2. Browse All add-ons, or narrow the list with Media or System in the Browse column. You can also type in Search add-ons in the toolbar.
  3. Choose Install beside the add-on, or on the featured card.
  4. Ledge downloads the add-on's files and checks each one against the SHA-256 hash in the catalogue. If a file doesn't match, nothing is installed.
  5. Ledge shows who made the add-on and asks you to trust it. Choose Install to finish.

The add-on then appears under Add-ons in the Settings sidebar, where you set it up. Its button in the Store changes to Installed.

To fetch the catalogue again, open the ••• menu in the toolbar and choose Refresh catalog. If the catalogue can't be reached, the Store says so, and add-ons you've already installed can still be removed.

An add-on's page

Choose an add-on's name to open its page. It shows:

  • Developer, Category and Availability, such as whether it's free and which macOS it needs
  • Installs, which says “Not available” for now. Ledge will only show a count once installs can be verified, never downloads standing in for them
  • Preview: screenshots and a motion demo, checked against the catalogue before they're shown
  • Description: what it does, how to set it up and what it can't do
  • Send feedback, which opens the developer's page for feedback in your browser

Choose ‹ All add-ons to go back to the list.

From your Mac

Choose Load Add-on… at the bottom of the Browse column, or in the ••• menu, and pick a .ledgeaddon folder. This is how you try an add-on you're building. Ledge checks the manifest, the executable and the icon, then asks you to trust it, just as it does for the Store.

Setting up Spotify Likes

  1. Install Spotify Likes from the Store.
  2. Open Add-ons → Spotify Likes in Settings.
  3. Enter the Client ID of a Spotify developer app, and add the exact Redirect URI Ledge shows to that app in Spotify's developer dashboard.
  4. Connect your account. Spotify opens in your browser and sends you back to Ledge.
  5. Play a song in Spotify, and use the heart in Ledge's player to like it or unlike it.

Ledge handles the sign-in and keeps your Spotify credentials in the Keychain. It asks Spotify only for permission to read and change your library.

Removing an add-on

In Add-on Store, choose Installed in the Browse column, then Remove beside the add-on.