Home

Awesome

Alfred-Convert

Convert between different units offline in Alfred 3 & 4.

Alfred-Convert uses a built-in library for lightning-fast conversions.

You can also add your own custom units.

Note: Currency conversions do require occasional Internet connectivity to update exchange rates. Alfred-Convert will otherwise work just fine without an Internet connection.

<!-- MarkdownTOC autolink="true" bracket="round" depth="2" autoanchor="true" --> <!-- /MarkdownTOC -->

<a name="downloading"></a> Downloading

Download from GitHub releases.

Note: Version 3.7 and above only supports Alfred 4+. If you're still using Alfred 3, please download v3.6.2.

<a name="usage"></a> Usage

<a name="conversions"></a>

Conversions

NOTE: Only a limited number of fiat currencies are supported by default. Additional rates are only supported if you set a key for the openexchangerates.org API in the workflow's configuration sheet. You can sign up for a free account here. When you're signed up, copy the App ID from the email you receive or this page into the APP_KEY field in the configuration sheet.

If no destination unit is specified, any defaults you've saved will be used (that aren't the same as the source unit).

The syntax is simple: an optional context, the quantity, the unit you want to convert from then (optionally) the unit you want to convert to. For example:

Or with a context:

It doesn't matter if there is a space between the quantity and the units or not. Alfred-Convert will tell you if it doesn't understand your query or know the units.

Actioning an item (selecting it and hitting ) will copy it to the clipboard. Using ⌘+L will display the result in Alfred's large text window, ⌘+C will copy the selected result to the clipboard.

<a name="configuration"></a>

Configuration

The workflow is configured via the configuration sheet (the [𝒙] icon) in Alfred Preferences and via a couple of text files in its data directory.

Configuration sheet

Basic configuration is performed in the configuration sheet:

OptionMeaning
APP_KEYAPI key for openexchangerates.org.
COPY_UNITInclude unit when copying conversion result. Any value but 0 or empty turns this option on.
CURRENCY_DECIMAL_PLACESOverrides the default DECIMAL_PLACES setting for currency conversions.
DECIMAL_PLACESNumber of decimal places to show in results.
DECIMAL_SEPARATORCharacter to separate whole numbers and decimal fractions. Used for parsing input and generating output.
DYNAMIC_DECIMALSDynamically increase the number of decimal places (up to 10) so that the result is non-zero. Any value but 0 or empty turns this option on.
THOUSANDS_SEPARATORCharacter to delimit thousands Used for parsing input and generating output.
UPDATE_INTERVALHow often (in minutes) to update currency exchange rates.

Active currencies

By default, all supported fiat currencies (provided you've set APP_KEY in the configuration sheet) and a handful of the most popular cryptocurrencies are active.

Use Edit Active Currencies to open the list of active currencies in your default editor. Add the symbol for the currency you'd like to activate on a new line in this file.

You can use View All Supported Currencies to search for the currency you'd like to activate, then use ⌘C on the result to copy the symbol to the pasteboard.

Custom units

See Adding custom units.

<a name="supported-units"></a> Supported units

Currently, Alfred-Convert only supports the units understood by the underlying Pint library plus currencies and a handful of additional units.

You can add your own custom units to the workflow. If you think they'd be useful to everyone, please create a corresponding GitHub issue to request addition as a default unit or submit a pull request.

<a name="supported-currencies"></a>

Supported currencies

To convert, use the appropriate abbreviation for the relevant currencies, e.g. conv 100 eur gbp.

You can also view (and search) the list from within Alfred by using the keyword convinfo and choosing View All Supported Currencies.

All supported currencies.

<a name="adding-custom-units"></a>

Adding custom units

You can add your own custom units using the format defined by Pint. Add your definitions to the unit_definitions.txt file in the workflow's data directory.

To edit this file, enter convinfo in Alfred and select Edit Custom Units. The unit_definitions.txt file will open in your default text editor.

Please see the Pint documentation for the required format. See Pint's default unit definitions for examples.

<a name="releases"></a> Releases

See CHANGELOG for more information.

ReleaseDate
3.7.02020-02-20
3.6.22019-09-06
3.6.12019-05-30
3.6.02019-05-06
3.5.32019-01-26
3.5.22019-01-26
3.5.12018-01-13
3.52018-01-12
3.42017-12-26
3.3.12017-11-21
3.32017-11-20
3.2.22017-11-07
3.2.12017-11-04
3.22017-11-02
3.12017-11-02
3.02017-07-16
2.62017-06-15
2.52015-12-11
2.42015-11-28
2.32015-11-26
2.22015-07-16
2.1Never released
2.02014-12-26
1.22014-08-19
1.12014-08-09

<a name="thanks-copyright-licensing"></a> Thanks, copyright, licensing

All other code/media are released under the MIT Licence.