Skip to content

Installation & Setup

Tomy Hsieh edited this page Feb 21, 2023 · 23 revisions

Prerequisite

  • Alfred 5+ with Powerpack
  • Earlier versions are still available but will not be supported for long
    • If you have Alfred 4 or earlier, try version 2.0.0
    • If you're running on macOS 12.2 or earlier, try version 1.3.1

Installation

From Alfred Gallery (Suggested)

Note: The workflow is still under review. Please install it from the GitHub release at the moment.

  1. Go to the workflow page and click Install in Alfred
  2. You're all set. Continue to configure

Manual install from GitHub

  1. Install Python 3
    brew install python
    • Or install with however you like. Make sure it's version 3.9 or later and the executable is available in $PATH
    • If you have no idea what the previous lines mean, you should probably go with the Alfred Gallery way
  2. Download the latest version from Releases and double-click on Coinc.alfredworkflow to install
  3. You're all set, continue to configure

Configure

Setup the following config value in the workflow user configuration sheet. If you have trouble finding this, follow this official guide

Name Function Default
Open Exchange Rates App ID Credentials to acquire currency rates can be obtained at Open Exchange Rates for free by signing up for an account. (Don't worry, you can delete the account if you change your mind)
Base currency Your primary, daily-use currency USD
Update rates Threshold to trigger rates update in seconds 30 mins
Localization Localization for decimal separator, find one in this ICU list, normally looks like {language}_{COUNTRY} en_US
Conversion direction In what ways would you like the conversion works Both
Precision Round off position after decimal point 3

Optimize

This step is totally optional, but you might find some great examples to make Coinc best fit for you.

Fallback search

Configure Coinc as part of your default Alfred action. This can be helpful if you often forget to type the cur prefix.

Fallback search

Setting Hotkey

If you want to dispatch Coinc with a hotkey, you can set it up by double click on the workflow object.

Customized hotkey

Symbols Trigger

Execute the cur-index command, Coinc will create a bunch of alias trigger that match the currency symbols as you type

Symbols Trigger

Customized Trigger (Alias)

More often than not, different country has their notation for currency, and Coinc have you covered.

Use cur-alias <custom-alias> <currency-name-or-code> to add a custom mapping

Add alias

If you changed your mind, use cur-unalias <custom-alias> to remove the entry

PopClip integration

  1. Install PopClip and the Alfred extension
  2. Configure Fallback search

Combining with Customized Trigger, you can achieve conversion without typing, like this

PopClip integration