https://github.com/thebeastbhr/universal-converter
Universal Unit Converter is a Chrome Extension that instantly converts measurements and currencies by simply selecting text on any webpage.
https://github.com/thebeastbhr/universal-converter
browser-extension chrome-extension converter currency-converter manifest-v3 unit-converter
Last synced: 3 months ago
JSON representation
Universal Unit Converter is a Chrome Extension that instantly converts measurements and currencies by simply selecting text on any webpage.
- Host: GitHub
- URL: https://github.com/thebeastbhr/universal-converter
- Owner: TheBeastBHR
- License: other
- Created: 2025-06-24T00:09:10.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-06-27T10:16:40.000Z (4 months ago)
- Last Synced: 2025-06-27T10:35:25.971Z (4 months ago)
- Topics: browser-extension, chrome-extension, converter, currency-converter, manifest-v3, unit-converter
- Language: JavaScript
- Homepage:
- Size: 434 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Universal Converter - Chrome Extension
[](../../actions)
Instantly convert any unit or currency by simply selecting text on any webpage!
A powerful Chrome Extension that automatically detects and converts units in selected text, supporting length, weight, temperature, volume, area measurements, and **real-time currency conversions** with smart auto-sizing and dimension support.
## ✨ Key Features
- **Single-Selection Conversion** - Select individual measurements for precise, instant conversions
- **Real-Time Currency Conversion** - Live exchange rates for 150+ currencies with Arabic/Unicode symbol support
- **Smart Auto-Sizing** - Automatically chooses appropriate units (0.001m → 1mm)
- **Dimension Support** - Handles formats like "8ft × 4ft × 30in", "6m × 4m × 2.5m"
- **Auto-Save Settings** - Metric/Imperial presets with manual overrides
## 🚀 Quick Start
**Manual Installation**
1. Click on Code, Download ZIP (or get it from releases), Extract files.
2. **Open** `chrome://extensions/` in Chrome
3. **Enable** "Developer mode" (top right toggle)
4. **Click** "Load unpacked" and select the project folder
5. **Test** by selecting "30 cm" on any webpage → See "11.81 inches" popup
## 🧪 Testing & Development
For testing documentation, build instructions, and development setup:
**→ [See TESTING.md](tests/TESTING.md)**
**Quick Commands:**
```bash
npm test # Run all automated tests
npm run validate # Validate extension structure
npm run build # Build for distribution
```
## 📁 Project Structure
```
Universal Converter/
├── manifest.json # Extension configuration
├── background.js # Service worker
├── content.js # Main content script
├── content.css # Content script styles
├── package.json # Node.js dependencies
│
├── data/ # Conversion data
│ ├── conversion-data.js # Unit definitions & patterns
│ └── currency-mappings.js # Currency symbols & codes
│
├── utils/ # Core functionality
│ ├── unit-converter.js # Unit conversion logic
│ ├── currency-converter.js # Currency detection & conversion
│ ├── conversion-detector.js # Pattern matching & detection
│ ├── popup-manager.js # Popup positioning & display
│ ├── settings-manager.js # User preferences storage
│ └── build.js # Build script for distribution
│
├── settings-page/ # Extension settings UI
│ ├── settings.html # Settings interface
│ └── settings.js # Settings functionality
│
├── icons/ # Extension icons
│
├── tests/ # Test suite
│ ├── test-runner.js # Core unit tests
│ ├── test-suite.js # Additional tests
│ ├── validate-extension.js # Extension structure validation
│ ├── run-all-tests.js # Cross-platform test runner
│ ├── test.html # Browser test page
│ ├── area-test.html # Area conversion test page
│ └── TESTING.md # Testing documentation
│
└── .github/ # GitHub configuration
└── workflows/ # CI/CD automation
```
## 🔒 Privacy & Security
- **Minimal Permissions**: Only `activeTab` and `storage`
- **Uses Currency Data from an API**: this extension uses [Fawaz Exchange API](https://github.com/fawazahmed0/exchange-api).
- **No Data Collection**: Zero tracking or analytics
## 🤝 Contributing
1. Fork this repository
2. Create a feature branch
3. Make your changes and test thoroughly
4. Submit a pull request
See [TESTING.md](tests/TESTING.md) for development guidelines and testing procedures.
## 🙏 Credits & Acknowledgments
This project integrates currency conversion functionality from [Currency-Converter](https://github.com/adampawelczyk/Currency-Converter) by Adam Pawełczyk. The currency detection, symbol mapping, API's used and real-time exchange rate features are based on this open-source project.
## 📄 License
MIT License - Feel free to use, modify, and distribute.