A lightweight, system tray-based currency converter for Windows. Built with Tauri, Rust, and Vanilla JavaScript, it offers real-time exchange rates, cross-rate calculations, and a distraction-free user interface that lives quietly in your system tray. This small app is suitable for the digital nomad and freelancer which live in their motherland but get paid with different currencies such as USD or EUR.

• 🔑 Key Features
• 📱 Supported Currencies
• 💻 Tech Stack
• 🚀 Getting Started
• 📂 Project Structure
• 💡 Usage Examples
• 🎨 Customization Options
• 📄 License

• Lives quietly in your Windows system tray.
• Instant access with a single click or keyboard shortcut.

• Fetches the latest rates from the Frankfurter API.
• Automatic background updates (every 5 minutes) to ensure accuracy.

• Automatically calculates exchange rates between any two supported currencies.
• No need to convert to USD first; the app handles the math.

• Customize decimal precision (2, 3, or 4 decimal places) for accurate calculations.
• Auto-adjusts for currencies like JPY or KRW that typically don't use decimals.

• Built-in theme switcher to match your system or personal preference.
• Persists user preference across sessions.

• The converter window stays on top of other applications for quick reference during workflows.

Supports major global currencies including:

Core:
Frontend:

Ensure you have the following installed:

• Node.js (v16 or later)
• Rust (Latest stable version via rustup)
• C++ Build Tools for Windows (via Visual Studio Installer)

1. Clone the repository:

   git clone https://github.com/ObsCure9277/MiniCurrencyConverter.git
   cd MiniCurrencyConverter

2. Install frontend dependencies:

   npm install

3. Run in development mode:

   npm run tauri dev

   This will start the app with hot-reload enabled.

To create an optimized executable:

npm run tauri build

The output binary will be located in src-tauri/target/release/.

MiniCurrencyConverter/
├── src-tauri/           # Rust backend & Tauri configuration
│   ├── src/
│   │   ├── main.rs      # Application entry point
│   │   └── lib.rs       # Core commands & tray logic
│   ├── Cargo.toml       # Rust dependencies
│   └── tauri.conf.json  # Tauri app configuration
├── src/                 # Frontend assets
│   ├── index.html       # Main UI Layout
│   ├── main.js          # App logic, conversion, & events
│   ├── styles.css       # Styling & themes
│   └── assets/          # Icons and images
├── package.json         # Node scripts & dependencies
└── README.md            # This file

1. Click the tray icon to open the converter.
2. Enter an amount (e.g., 100).
3. Select your From currency (e.g., USD).
4. Select your To currency (e.g., EUR).
5. The result updates instantly as you type or change options.

1. Locate the decimal dropdown in the top-right corner.
2. Select .00, .000, or .0000.
3. All future conversions will use this precision preference.

1. Click the sun/moon icon in the top-right corner.
2. The app will switch between Light and Dark modes.
3. Your preference is saved automatically.

• Default Currency: Modify the init() function to change the startup currencies.
• Refresh Interval: Adjust the refreshTimer (default: 5 minutes) in init().

• Colors: Edit the :root variables to change the color scheme.
• Fonts: The app uses system fonts by default for performance and native feel.

This project is licensed under the MIT License - see the LICENSE file for details.

Made with ❤️ by ObsCure9277