Skip to content

DahamSathmina/ODS_Singlish_Converter-Base_on_python

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

124 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ODS Singlish Converter

A powerful tool that converts Singlish into Sinhala Unicode script
© 2025 Daham Sathmin.

License Button Python Button

💡 What it does

ODS Singlish Converter converts Singlish into Sinhala Unicode text.
Example: kohomadhaකොහොමද.

This project supports a web UI (Flask) and desktop, or a Chrome extension.


✅ Key Features

  • Real-time Singlish → Sinhala conversion
  • Web UI built with Python & Flask
  • Lightweight and easy to extend
  • Ready for packaging into a desktop app (PyInstaller) or browser extension

DeskTop preview

UI Screenshot


🧰 Tech Stack

  • Backend & conversion logic: Python
  • Web framework: Flask
  • Frontend: HTML, CSS, JavaScript
  • Optional packaging: PyInstaller for desktop builds

🚀 Getting Started

Prerequisites

  • Python 3.13+
  • Recommended: virtual environment

Installation

git clone https://github.com/DahamSathmina/ODS_Singlish_Converter-Base_on_python.git
cd ODS_Singlish_Converter-Base_on_python
python -m venv venv
# Activate the virtual environment:
# Linux / macOS
source venv/bin/activate
# Windows (PowerShell)
venv\Scripts\Activate.ps1
# Or Windows (cmd)
venv\Scripts\activate

pip install -r requirements.txt

Usage — Web Version

python app.py

Open http://localhost:5000 in your browser, paste Singlish input, click Convert, and view the Sinhala output.


📁 Project Structure

├── app.py                  # Flask web application
├── converter.py            # Core Singlish -> Sinhala logic
├── requirements.txt        # Python dependencies
├── Demo/                   # Screenshots and visuals
│   ├── web-ui.png
│   ├── converted-text.png
│   └── web-ui-phone.png
├── static/                 # Front-end assets (css/js)
├── templates/              # HTML templates for the web UI
└── LICENSE                 # GPL-3.0 License

🤝 Contributing

Contributions are welcome! Ways to help:

  • Open issues for bugs or feature requests
  • Fork the repo and submit a pull request
  • Improve conversion accuracy and add tests
  • Add platform support (desktop packaging, mobile port)
  • Improve UI/UX and localization

When contributing, please follow these steps:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature-name)
  3. Make changes and add tests where applicable
  4. Open a pull request describing your changes

License

This project is licensed under the GNU General Public License v3.0.


Contact


Thank you for using ODS Singlish Converter! 🌟