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.
• Extensive Alias Support – Recognizes 500+ currency aliases including:
  • Colloquial terms (bucks, quid, greenbacks)
  • City references (mumbai → INR, tokyo → JPY)
  • Regional variations and common misspellings
  • Fractional units (paisa, cents, pence)
  • Historical references and slang terms

  The comprehensive aliases.json file maps all these variations to their standard currency codes.

• 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

Installation & Setup

Manual Installation

1. Download or git clone this repository.
2. 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

3. 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

(All hotkeys can be remapped – see Customization).

Examples

How It Works

File Hierarchy

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

📦inline-currency-converter-using-AutoHotKey-master
 ┣ 📂data
 ┃ ┗ 📜exchange_rates.json                    # contains exchange rates data
 ┃ ┗ 📜aliases.json                           # contains currency aliases
 ┣ 📂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

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.