PowerToys-Run-Currency-Converter advaith

Currency Converter

PowerToys Run plugin which will convert real and crypto currencies.

Installation

There are multiple ways to install the Currency Converter plugin for PowerToys:

Method 1: Manual Installation

1. Download the latest release of the Currency Converter from the releases page.
2. Extract the zip file's contents to your PowerToys modules directory (usually %LOCALAPPDATA%\Microsoft\PowerToys\PowerToys Run\Plugins).
3. Restart PowerToys to complete the installation process.

Method 2: Executable File

1. Download the executable file for the Currency Converter plugin from the releases page.
2. Run the executable file and follow the installation instructions.
3. Restart PowerToys.

Method 3: Using Winget

1. Open a command prompt or PowerShell window.
2. Run the following command: winget install advaith.CurrencyConverterPowerToys.
3. Wait for the installation to complete.
4. Restart PowerToys.

Please note that you only need to exit PowerToys when updating the Currency Converter plugin. Choose the method that suits your preference and enjoy using the Currency Converter plugin in PowerToys!

Usage

$$ 100 inr to usd
$$ eur 100 in usd

$$ $100
$$ 100R$
$$ 100€
$$ 100₽
$$ ₹100
$$ $100 to eur
$$ 100$ to euro

Changing / Removing prefix

You can change the $$ prefix from the settings page. To use this plugin without any prefix just check the "Include in global result" checkbox. With that option checked, you can use this plugin without any prefix like

1 eur to usd

Aliasing

To make currency conversions more convenient, you can use aliasing to assign custom names to currencies. For example, you can alias "dollar" to "usd".

To set up aliasing, follow these steps:

1. Locate the configuration file alias.json in %LOCALAPPDATA%\Microsoft\PowerToys\PowerToys Run\Settings\Plugins\Community.PowerToys.Run.Plugin.CurrencyConverter.
2. Open the alias.json file in a text editor.
3. Add an entry for each alias you want to create. Each entry should have the format "alias": "currency_code". For example, to alias "dollar" to "usd", add the following entry: "dollar": "usd".
4. Save the alias.json file.

Please note that when creating aliases, ensure that the alias key does not contain any numbers or spaces.

Once you have set up the aliases, you can use them in your currency conversions. For example, instead of typing $$ 100 usd to eur, you can simply type $$ 100 dollar to euro.

If you are getting an error saying the alias file is not found, try closing PowerToys and opening it again. If the issue persists, you may need to download a newer version of the Currency Converter plugin and reinstall it.

Crypto and other currencies

This plugin also converters real currencies to crypto currencies and vice versa. Refer here for the full list of available conversions.

Example Usage:

$$ 1 btc to usd

Quick Conversions

You can swiftly convert from your local currency to another currency simply by typing the number. The settings allow you to change both the local and all other currencies.

$$ 102.2

Output formatting and precision

The plugin supports two modes of output:

1. Short Text: The output will only contain the target currency.
2. Full Text: The output will contain both the source and target currencies.

The plugin outputs values using dynamic precision. This means that if a value is less than 1, the number of non-zero decimals displayed will be exactly as the system configuration.

Mathematical Calculations

You can input mathematical expressions, and the plugin will evaluate them using the BODMAS rule. The permitted operations are + (addition), - (subtraction), * (multiplication), and / (division). The use of brackets is also supported.

Conversion API

This plugin internally uses various APIs for the latest conversion rates:

1. Default: fawazahmed0/exchange-api

   • This API is refreshed every day at midnight.
   • It is free and unlimited, and therefore no API key is required.
   • Important: Do not change from the default unless it is absolutely necessary. The default API provides reliable daily updates and does not require any additional setup.

2. ExchangeRateAPI

   • Updates: The ExchangeRateAPI is updated frequently throughout the day. You can read more about it here.
   • Free Tier: Offers a free tier that allows for 1,500 requests per month.
   • Note: This API does not support cryptocurrency conversions.
   • Details: Please refer to the CurrencyAPI documentation for specific details on update frequency, pricing, and supported features.

3. CurrencyAPI

   • Updates: The CurrencyAPI is updated frequently throughout the day. You can read more about it here.
   • Details: Please refer to the CurrencyAPI documentation for specific details on update frequency, pricing, and supported features.

Please Note: None of the APIs mentioned above are directly associated with this plugin. If you wish to use any other API for conversion rates or have suggestions for new APIs, please open a pull request (PR) to propose adding it to the plugin.