https://github.com/muhammad-noraeii/currencyconverter
A Simple Currency Converter, free to use
https://github.com/muhammad-noraeii/currencyconverter
converter css css3 currency currency-converter html html5 javascript js simple
Last synced: 2 months ago
JSON representation
A Simple Currency Converter, free to use
- Host: GitHub
- URL: https://github.com/muhammad-noraeii/currencyconverter
- Owner: Muhammad-Noraeii
- License: mit
- Created: 2025-01-14T18:42:55.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-02-02T20:14:35.000Z (4 months ago)
- Last Synced: 2025-02-02T21:20:31.413Z (4 months ago)
- Topics: converter, css, css3, currency, currency-converter, html, html5, javascript, js, simple
- Language: HTML
- Homepage:
- Size: 52.7 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Currency Converter Tool
This project is a simple and powerful online **Currency Converter Tool** that supports real-time exchange rates. It provides an interface in **English**, allowing users to easily convert between over 50 global currencies.
---
## 🌍 Supported Currencies
- **USD**: United States Dollar ($)
- **EUR**: Euro (€)
- **GBP**: British Pound (£)
- **JPY**: Japanese Yen (¥)
- **CHF**: Swiss Franc (CHF)
- **AUD**: Australian Dollar (A$)
- **CAD**: Canadian Dollar (C$)
- **NZD**: New Zealand Dollar (NZ$)
- **CNY**: Chinese Yuan (¥)
- **HKD**: Hong Kong Dollar (HK$)
- **SGD**: Singapore Dollar (S$)
- **INR**: Indian Rupee (₹)
- **RUB**: Russian Ruble (₽)
- **BRL**: Brazilian Real (R$)
- **ZAR**: South African Rand (R)
- **KRW**: South Korean Won (₩)
- **TRY**: Turkish Lira (₺)
- **MXN**: Mexican Peso (Mex$)
- **AED**: UAE Dirham (د.إ)
- **ARS**: Argentine Peso ($)
- **BDT**: Bangladeshi Taka (৳)
- **BHD**: Bahraini Dinar (.د.ب)
- **CLP**: Chilean Peso (CLP$)
- **COP**: Colombian Peso (COL$)
- **CZK**: Czech Koruna (Kč)
- **DKK**: Danish Krone (kr)
- **EGP**: Egyptian Pound (ج.م)
- **HUF**: Hungarian Forint (Ft)
- **IDR**: Indonesian Rupiah (Rp)
- **ILS**: Israeli Shekel (₪)
- **KWD**: Kuwaiti Dinar (د.ك)
- **MYR**: Malaysian Ringgit (RM)
- **NOK**: Norwegian Krone (kr)
- **PHP**: Philippine Peso (₱)
- **PKR**: Pakistani Rupee (₨)
- **PLN**: Polish Zloty (zł)
- **SAR**: Saudi Riyal (ر.س)
- **SEK**: Swedish Krona (kr)
- **THB**: Thai Baht (฿)
- **TWD**: Taiwan Dollar (NT$)
- **UAH**: Ukrainian Hryvnia (₴)
- **VND**: Vietnamese Dong (₫)
- **IRR**: Iranian Rial (ریال)
- **IQD**: Iraqi Dinar (د.ع)
- **LBP**: Lebanese Pound (ل.ل)
- **JOD**: Jordanian Dinar (د.ا)
- **OMR**: Omani Rial (ر.ع)
- **KZT**: Kazakhstani Tenge (₸)
- **QAR**: Qatari Riyal (ر.ق)
- **NGN**: Nigerian Naira (₦)
- **EEK**: Estonian Kroon (kr)
---
## 🛠 Features
- Real-time exchange rates with accurate data.
- Supports conversion for 50+ global currencies.
- Mobile-friendly and responsive design.
---
## 🚀 Installation
Follow these steps to set up the project:
1. Clone the repository:
```bash
git clone https://github.com/Muhammad.Noraeii/CurrencyConverter.git
```
2. Navigate to the **Src** directory:
```bash
cd Simple-Currency-Converter/Src
```
3. Open the desired file in your browser:
- Please open "index.html
That’s it! You can now start using the tool to convert currencies.
---
## 📂 Project Structure
```
currency-converter-tool/
├── Src/
│ ├── index.html # index of the tool
│ └── currency-converter.js # Script of tool
├── README.md # Documentation file
└── LICENSE # License information
```
---
## 🌟 How to Use
1. Open `index.html`
2. Enter the amount you want to convert.
3. Select the **source currency** (`From`).
4. Select the **target currency** (`To`).
5. Click the `Convert` button to get the result.
---
## 🤝 Contributing
We welcome contributions to improve the tool! Follow these steps:
1. Fork the repository.
2. Create a new branch for your feature:
```bash
git checkout -b feature/your-feature-name
```
3. Make your changes and commit them:
```bash
git commit -m "Add feature: your-feature-name"
```
4. Push to your fork:
```bash
git push origin feature/your-feature-name
```
5. Open a pull request on GitHub.
---
## 📄 License
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for more details.
---
## 📧 Contact
If you have any questions, feedback, or suggestions, feel free to contact us:
- **Email**: [email protected]
---
## ⭐ Acknowledgements
Special thanks to [ExchangeRate-API](https://www.exchangerate-api.com/) for providing real-time currency exchange data.