Skip to content

User Guide

Tomy Hsieh edited this page Feb 20, 2023 · 13 revisions

Overview

There are currently 4 methods to trigger Coinc's main conversion interface:

  • In Alfred, type the keyword cur along with the query (Recommended, supports hints and settings)
  • In Alfred, type the keyword coinc, then press
  • In Alfred, type the query, then choose the fallback search (Setup required)
  • With Hotkey, follow this guide to set it up

Query

Introduction

Query is compose of two arguments:

  • [value]: must be a decimal number, commas (,) will be ignored
  • [currency]: can be either code (USD, JPY,...) or alias ($, ¥,...). For alias mapping, see Currencies

Queries are position-insensitive. Besides the cur keyword, arguments in the following methods can be typed in any order. Namely, the following queries all yield the same results:

  • cur 5 GBP CAD
  • cur 5 CAD GBP
  • cur GBP 5 CAD
  • cur CAD 5 GBP
  • cur GBP CAD 5
  • cur CAD GBP 5

Usage

  • cur: Convert between all favorite currencies and base currency with 1 unit based on ORIENTATION config
FROM_FAV DEFAULT TO_FAV
cur-FROM_FAV cur-DEFAULT cur-TO_FAV
  • cur [value]: Convert between all favorite currencies and base currency with [value] unit based on ORIENTATION config
FROM_FAV DEFAULT TO_FAV
cur 5-FROM_FAV cur 5-DEFAULT cur 5-TO_FAV
  • cur [currency]: Convert between [currency] and base currency with 1 unit

    cur TWD
  • cur [value] [currency]: Convert between [currency] and base currency with [value] unit

    cur 5 TWD
  • cur [currency_1] [currency_2]: Convert between [currency_1] and [currency_2] with 1 unit

    cur TWD HKD
  • cur [value] [currency_1] [currency_2]: Convert between [currency_1] and [currency_2] with [value] unit

    cur 5 TWD HKD

Copying Results

  • Press or ⌘-C on the converted item to copy the value
  • Press ⌥-⏎ on converted item to copy value along correspond symbol

Setting & Help Methods

  • cur-add: Add a new currency to the favorite list
  • cur-rm: Remove a currency from the favorite list
  • cur-arr: Arrange orders of the favorite list cur-arr
  • cur-ref: Refresh Currency List & Rates (This happens automatically in the background, this is just a manual trigger)
  • cur-alias and cur-unalias: Setting custom mapping between characters and currency, see Customized Trigger for details
  • cur-help: Show a list of example usage or opens up this repository
Clone this wiki locally