Inline Currency Converter Using AutoHotKey

This README was generated by LLM and then edited by Aman.

Introduction

AutoHotkey Currency Instant Converter is a lightweight AutoHotkey (AHK) script that lets you convert currency amounts in-place inside any Windows application.
Just type an amount with a short currency expression like 4yentoinr, select it, and press Win + O. The script instantly replaces your selection with the correct conversion – e.g. ¥4 i.e. ₹2.37.

Ideal for writers, traders, and anyone juggling multiple currencies while working in editors, chats, emails, or web forms.

Features

In-Place Conversion – Converts the selected text and replaces it with the formatted result—no copy-paste dance required.
Flexible Notation – Accepts plain currency names or popular synonyms (e.g. yen, jpy).
there was only jpy and krw in the exchange rates file fetched from the api, yen and won are added manually.
Hotkey Driven – Default shortcut Win + O is easy to reach and unlikely to conflict with standard app shortcuts. It’s also customisable to any shortcut you prefer.
JSON-Based Rates – Reads live rates from exchange_rates.json; swap in your own feed or update values manually.
Exchange rates are fetched from coingecko, using this code and, unicodes are converted to the symbols using checkserp.
AHK v2 Codebase – Modern syntax, better Unicode handling, and cleaner function calls.
Open Source – Released under the MIT License. Fork it, learn from it, or integrate it into your own productivity suite.

Requirements

Component	Version	Notes
Windows	10 / 11	Administrator rights not required.
AutoHotkey	v2.0 or newer	https://www.autohotkey.com/download/
JSON Rates File	Included (`exchange_rates.json`)	Can be regenerated or swapped using coingecko, using this generate spec file from my other project.
(Optional) Git	Latest	For easy updates & contribution.

Installation & Setup

Manual Installation

Download or git clone this repository.
Double-click scripts\auto complete\currency conversion.ahk to activate the script.
You can also setup the ahk and the script folder location in run inline currency converter ahk.bat
Type 4yentoinr or 4yen, highlight it, press Win + O ➜ ¥4 i.e. ₹2.38 appears instantly.

Usage

Supported Input Pattern

converts from sourceCurrency to targetCurrency:

1
<number><sourceCurrency>to<targetCurrency>

converts from sourceCurrency to default currency:

1
<number><sourceCurrency>

Currency names: ISO codes(not case sensitive) (usd, inr).

Keyboard Shortcuts

Hotkey	Action
`Win + O`	Convert currently selected text.

(All hotkeys can be remapped – see Customization).

Examples

Before (select → Win+O)	After
780000won	₩780000 i.e. ₹48121.27
4yentoinr	¥4 i.e. ₹2.38
100usdtoeur	$100 i.e. €88.16
1500inrtogbp	₹1500 i.e. £13.03
75.47usdtowon	$75.47 i.e. ₩104686.94

How It Works

File Hierarchy

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
📦inline-currency-converter-using-AutoHotKey-master
 ┣ 📂data
 ┃ ┗ 📜exchange_rates.json                    # contains exchange rates data
 ┣ 📂scripts
 ┃ ┣ 📂auto complete
 ┃ ┃ ┗ 📜currency conversion.ahk              # contains code with main logic
 ┃ ┗ 📂lib
 ┃ ┃ ┗ 📜_JXON.ahk                            # library that parses json
 ┣ 📜global.ahk
 ┣ 📜issues.md
 ┣ 📜README.md
 ┣ 📜run inline currency converter ahk.bat

Exchange-Rate Logic

The value is rounded to two decimals (configurable) and formatted with the correct currency symbol.

(Full rate table ships in the JSON – fiat, crypto & precious metals.)

Customization

What	Where	Example
Hotkeys	`scripts\auto complete\currency conversion.ahk`	Change `#o::` to `^!c::` for `Ctrl+Alt+C` et cetera
Decimal Places	`currency conversion.ahk` at `Format("{1:.2f}`	`Format("{1:.4f}` for 4 decimal places

Author & Contact

Aman Rathore
- Website: amanr.me
- GitHub: @AmanRathoreP | @AmanRathoreM
- Telegram: @aman0864
- Email: aman.proj.rel@gmail.com
- LinkedIn: @amanrathorep
- Instagram: @aman__0864

Feel free to reach out if you have any questions, suggestions, or issues regarding the plugin.