https://github.com/Advaith3600/PowerToys-Run-Currency-Converter
PowerToys Run plugin which will convert real and crypto currencies.
https://github.com/Advaith3600/PowerToys-Run-Currency-Converter
convert-currencies converter cryptocurrency currency-conversion powertoys powertoys-run powertoys-run-plugin
Last synced: 24 days ago
JSON representation
PowerToys Run plugin which will convert real and crypto currencies.
- Host: GitHub
- URL: https://github.com/Advaith3600/PowerToys-Run-Currency-Converter
- Owner: Advaith3600
- License: mit
- Created: 2024-01-17T18:53:03.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-05-02T07:52:46.000Z (29 days ago)
- Last Synced: 2025-05-02T08:45:15.038Z (29 days ago)
- Topics: convert-currencies, converter, cryptocurrency, currency-conversion, powertoys, powertoys-run, powertoys-run-plugin
- Language: C#
- Homepage:
- Size: 4.4 MB
- Stars: 208
- Watchers: 6
- Forks: 10
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-powertoys-run-plugins - CurrencyConverter - Convert traditional and cryptocurrency with the latest exchange rates. (Plugins)
README
# Currency Converter
[](https://github.com/hlaueriksson/awesome-powertoys-run-plugins)
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](https://github.com/advaith3600/powertoys-run-currency-converter/releases).
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](https://github.com/advaith3600/powertoys-run-currency-converter/releases).
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](https://cdn.jsdelivr.net/gh/fawazahmed0/currency-api@1/latest/currencies.json) 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](https://github.com/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](https://www.exchangerate-api.com/)**
- Updates: The ExchangeRateAPI is updated frequently throughout the day. You can read more about it [here](https://www.exchangerate-api.com/#pricing).
- 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](https://currencyapi.com)**
- Updates: The CurrencyAPI is updated frequently throughout the day. You can read more about it [here](https://currencyapi.com/pricing/).
- 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.