Menu ▾ ▴

Tree [e40594] main /
 History

HTTPS git://
HTTPS access

File Date Author Commit
 asset 3 days ago Md. Yamin Hossain Md. Yamin Hossain [bba47c] Latest
 src 2 days ago Md. Yamin Hossain Md. Yamin Hossain [205045] latest
 .gitignore 3 days ago Md. Yamin Hossain Md. Yamin Hossain [a89262] update
 Dockerfile.linux-build 4 days ago Md. Yamin Hossain Md. Yamin Hossain [7d51b0] Update
 LICENSE 2026-02-08 Md. Yamin Hossain Md. Yamin Hossain [0afc13] Update
 README.md 2 days ago Md. Yamin Hossain Md. Yamin Hossain [e40594] update
 package-lock.json 3 days ago Md. Yamin Hossain Md. Yamin Hossain [a89262] update
 package.json 2 days ago Md. Yamin Hossain Md. Yamin Hossain [205045] latest

Read Me

LingoLearn Phonetics

LingoLearn helps students master English pronunciation using real voice output, IPA phonetics, and a built-in English–Bangla dictionary.

Image

Features

  • TTS – Hear words/phrases with system voices
  • IPA – Phonetic transcription (CMU Dict)
  • Bangla – English-to-Bangla meanings
  • Clipboard – Optional: speak/show IPA when you copy text
  • History – Recent words; settings for rate, volume, voice

Quick Start

git clone https://github.com/needyamin/lingoLearn-phonetics.git
cd lingoLearn-phonetics
npm install
npm start

Build

Platform Command Output
Windows (portable exe) npm run dist dist/LingoLearn Phonetics 1.0.0.exe
Linux (AppImage) npm run dist:linux:docker dist/LingoLearn Phonetics-1.0.0.AppImage

Linux AppImage (on Windows)

Use Docker. One command from project root:

npm run dist:linux:docker

Or manually:

docker build -f Dockerfile.linux-build -t tts-pronunciation-linux-builder .
docker run --rm -v "y:/Projects/lingoLearn-phonetics/dist:/app/dist" tts-pronunciation-linux-builder

Output: dist/LingoLearn Phonetics-1.0.0.AppImage (~101 MB). Requires Docker Desktop.

Alternatives: Enable Windows Developer Mode, or run PowerShell as Administrator, then npm run dist:linux. Or use GitHub Actions to build on Linux.

Using the Linux AppImage

  1. Download LingoLearn Phonetics-1.0.0.AppImage
  2. chmod +x "LingoLearn Phonetics-1.0.0.AppImage"
  3. ./"LingoLearn Phonetics-1.0.0.AppImage"

No install needed. Needs Linux kernel 3.10+, GLIBC 2.17+, X11 or Wayland.

Deploy the single .exe

  1. Build: npm run dist → creates dist/LingoLearn Phonetics 1.0.0.exe (single file, no installer).
  2. Share: Copy the .exe anywhere (USB, cloud, another PC). Users double‑click to run; no install needed.
  3. GitHub Releases (recommended):
  4. Repo → Releases → Create a new release (tag e.g. v1.0.0).
  5. Attach LingoLearn Phonetics 1.0.0.exe (and optionally LingoLearn Phonetics-1.0.0.AppImage).
  6. Publish. Users download the exe from the release page.

Auto-update

  • App: When a new release is published on GitHub Releases (tag e.g. v1.0.0), the app checks and can auto-download and install on quit.
  • Dictionaries: IPA and Bangla dictionary files are updated automatically from the repo when the app runs; no new app build needed for dict changes.

Tech

Electron · Web Speech API · CMU Pronouncing Dictionary · Bangla dictionary (asset)

License

ISC

MongoDB Logo MongoDB