#currency-converter #currency-exchange #currency #exchange #converter #coin

app coinvert

A fast and flexible command-line currency converter that provides historical exchange rates

2 releases

new 0.0.3 Mar 19, 2025
0.0.1 Mar 19, 2025

#202 in Command line utilities

Download history 254/week @ 2025-03-18

254 downloads per month

MIT license

19KB
181 lines

Release

Coinvert

A fast and flexible command-line currency converter that provides historical exchange rates.

Project Description

Coinvert is a Rust-based CLI tool for currency conversion that uses real-time exchange rates. It allows you to quickly convert between different currencies using the command line, supports historical exchange rates, and offers various output formats to fit your needs.

Features

  • Convert between 170+ currencies using their ISO-4217 codes
  • Exchange rates from exchange-api
  • Historical exchange rates lookup
  • Fast and efficient with minimal dependencies
  • Simple and intuitive command-line interface

Installation

Important: Coinvert currently only supports x86_64 architecture. It will not work on ARM-based systems (like Raspberry Pi or Apple Silicon M1/M2 without Rosetta).

Using Install Script (Linux and macOS)

The fastest way to install Coinvert on x86_64 systems is using our installation script:

curl -sSL https://raw.githubusercontent.com/hnrq/coinvert/main/install.sh | bash

This script will:

  • Automatically detect your operating system
  • Download the appropriate prebuilt binary for your system
  • Install it to /usr/local/bin/ (may require sudo permission)
  • Make it executable and ready to use

Using Cargo

If you have Rust installed, you can install Coinvert directly from crates.io:

cargo install coinvert

Manual Installation (Prebuilt Binaries)

If you prefer to manually install, you can download prebuilt binaries for x86_64 Linux and macOS from the releases page.

After downloading:

  1. Make the binary executable
  2. Move it to a directory in your PATH
chmod +x coinvert
sudo mv coinvert /usr/local/bin/

This method gives you control over the installation process and allows you to verify the binary before installation.

Usage

Basic Usage

Convert 100 USD to EUR:

coinvert 100 --from USD --to EUR

Or using short options:

coinvert 100 -f USD -t EUR

Historical Rates

Convert 100 USD to EUR using the exchange rate from a specific date:

coinvert 100 -f USD -t EUR --date 2023-01-15

Output Formats

Change the output format:

coinvert 100 -f USD -t EUR --format short

Available formats:

  • full (default): Shows full human-readable text with date and currency names
  • short: Shows only the conversion values

Examples

Convert 50 GBP to JPY:

coinvert 50 -f GBP -t JPY

Convert 75 EUR to CAD on January 1, 2022:

coinvert 75 -f EUR -t CAD -d 2022-01-01

Get short format output for 200 AUD to NZD:

coinvert 200 -f AUD -t NZD --format short

Get full format output for 100 USD to EUR:

coinvert 100 -f USD -t EUR --format full

Building from Source

Prerequisites

  • Rust toolchain (1.56.0 or later)
  • Cargo package manager

Build Steps

  1. Clone the repository:

    git clone https://github.com/username/coinvert.git
    cd coinvert
    
  2. Build the project:

    cargo build --release
    
  3. The binary will be available at target/release/coinvert

Technologies

Coinvert is built with:

  • Rust programming language
  • clap for command-line argument parsing
  • reqwest for HTTP requests
  • serde for serialization/deserialization

License

MIT

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Dependencies

~5–16MB
~212K SLoC