Installing the command-line executable

Assuming you have Rust/Cargo installed, run this command in a terminal:

cargo install lngcnv

It will make the lngcnv command available in your PATH if you"ve allowed the PATH to be modified when installing Rust. cargo uninstall lngcnv uninstalls.

Back to the crate overview.

Readme

INTRODUCING LNGCNV

The acronym "lngcnv" may signify e.g., a "language converter", a "linguistic converter", or a "lenguaje convertido" (Spanish for "converted language").

lngcnv is capable of presenting the precise pronunciation of a phrase using the International Phonetic Alphabet (IPA). It can also translate between various dialects of a language and convert between different orthographic norms.

The program can accept input in the form of a word or text either directly through the command line or by being included in a file, such as a lengthy book. There is also a REPL (read-eval-print loop) mode available for interactive use.

Six modern and ancient languages, including a range of dialects, are currently supported.

The program"s source code and linguistic algorithms were created entirely from scratch and are distributed under the MIT License. lngcnv is written in Rust for high performance, code correctness, and ease of long-term development.

To display the International Phonetic Alphabet (IPA) characters accurately, it is recommended to use one of the following fonts: Charis SIL, Doulos SIL, or Gentium Plus. When showing IPA characters in the terminal, it is best to use the Unicode font Noto Sans Mono.

[keywords: foreign languages, language learning app, natural language processing]

SUPPORTED LANGUAGES

1. ENGLISH: pronunciation and orthography

– Pronunciation of American English (Chicago, IL; Dallas, TX)

– Pronunciation of Australian English (Canberra, ACT)

– Pronunciation of New Zealand English (Auckland, NZ-AUK)

– Transcribe using the spelling of American English

2. LATIN: pronunciation and orthography

– Reconstructed pronunciation of Classical Latin

– Transcribe using the ancient orthographic convention (pre-2nd century AD)

3. POLISH: three variants of pronunciation

– Pronunciation from Częstochowa, Małopolska Region

– Pronunciation from Toruń, Wielkopolska Region

– Pronunciation from Warszawa, Mazowsze Region

4. QUECHUA: pronunciation, dialect translation and orthography

– Pronunciation of Chanka/ Ayacucho Quechua (Wanta, PE)

– Translate from other Southern Quechua varieties into Ayacucho Quechua

– Transcribe between the trivocalic and pentavocalic orthographies

5. SPANISH: fifteen variants of pronunciation

– Pronunciation of Colombian Spanish (Arauca; Bogotá; Bucaramanga; Cali; Leticia; Medellín; Neiva; Pasto; Quibdó; Santa Marta)

– Pronunciation of Mexican Spanish (Ciudad de México)

– Pronunciation of Spanish of Spain (Bilbao; Cádiz; Madrid)

– Pronunciation of Uruguayan Spanish (Montevideo)

6. TIKUNA/ TICUNA: pronunciation and orthography

– Five variants of pronunciation (Río Cotuhé, CO; Cushillococha, PE; Nazareth, CO; Umariaçu, BR; Vila Betânia, BR)

– Four distinct orthographies (Brazil; Colombia; Peru–ILV; Peru–FORMABIAP)

USAGE

help-image

INSTALLATION ON LINUX

The current version of lngcnv (v1.10.1) has been verified to work properly on Fedora Linux 41.

METHOD 1 – USING CARGO

[Recommended for programmers]

1. To install lngcnv from crates.io, use the following cargo command:

cargo install lngcnv

The executable will be saved in the hidden .cargo/bin/ directory within your home directory.

2a. For easy access, you may want to copy the lngcnv file to either the /usr/bin/ or the ~/.local/bin/ directory. This can be done by following the instructions in Method 3 (3a, 3b, 3c).

2b. As an alternative, you can add the ~/.cargo/bin/ directory to your system"s PATH variable, which can be configured using rustup.

METHOD 2 – SNAP INSTALLATION

The software can be obtained through the Snap Store and installed with just one command:

sudo snap install lngcnv

METHOD 3 – UNIVERSAL LINUX BINARIES

1. To install lngcnv, first download the distro-independent binary from GitHub.

2. Then, make the file executable by running the command:

sudo chmod +x ./lngcnv

3a. On most Linux distributions, install lngcnv by copying the binary to /usr/bin/:

sudo cp lngcnv /usr/bin/

3b. For Fedora Silverblue / Kinoite, use this command:

sudo cp lngcnv /var/usrlocal/bin/

3c. As an alternative, consider installing locally in the ~/.local/bin/ directory:

cp lngcnv $HOME/.local/bin/

METHOD 4 – DISTRO-SPECIFIC PACKAGES

[Recommended for most users]

Distro-specific packages for .rpm and .deb-based Linux distributions are also available for download. To install lngcnv on different Linux distributions, follow these instructions:

Fedora Linux / RHEL / openSUSE:

sudo rpm -i lngcnv-1.10.1-1.x86_64.rpm

Fedora Silverblue / Kinoite:

rpm-ostree install lngcnv-1.10.1-1.x86_64.rpm

Ubuntu:

sudo dpkg -i lngcnv_1.10.1-1_amd64.deb

METHOD 5 – MANUAL COMPILATION

First, download and unpack the lngcnv source code from GitHub. Next, to build and install the program, use the command:

cargo build --release && sudo cp target/release/lngcnv /usr/bin/