Skip to content

A web-based Braille translator that converts text to Braille and vice versa, supporting file uploads, downloads, and accessibility-friendly features.

License

Notifications You must be signed in to change notification settings

pakelcomedy/Braille-Translator

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

34 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Braille Translator Website

A simple and accessible web-based Braille translation tool. This project allows users to:

  • Convert standard text to Braille (Unicode and graphical 6-dot form)
  • Convert Braille Unicode back to plain text
  • Translate between English and Indonesian
  • Upload .txt or .pdf documents for translation
  • Download the translation results
  • Enable High Accessibility Mode for better visual clarity

🌐 Live Demo

Text To Braille


📁 Project Structure


braille-translator-website/
├── index.html                  # Main page: Text → Braille
├── pages/
│   ├── reverse.html            # Braille → Text
│   ├── upload.html             # Upload document for translation
│   └── learn.html              # Learn Braille (education)
├── css/
│   └── styles.css              # Styling for all pages
├── js/
│   ├── convert.js              # Logic for text → Braille
│   ├── reverse.js              # Logic for Braille → text
│   ├── upload.js               # File reader and document parsing
│   ├── download.js             # Download helper functions
│   ├── accessibility.js        # Toggle high-contrast mode
│   └── translate.js            # Logic for English ↔ Indonesian translation
├── img/
│   ├── braille-examples/       # Optional: Braille image assets
│   └── screenshot.png          # Screenshot of the live interface
├── assets/
│   └── lang/
│       ├── en.json
│       └── id.json
├── data/
│   └── braille-map.json        # Optional: external character mapping
├── README.md                   # Project documentation
└── LICENSE                     # License info


🚀 Features

  • 🔤 Translate any typed text to Braille in real time
  • 🔄 Reverse translator: Braille to text
  • 🌐 Translate English to Indonesian and vice versa
  • 📁 Upload .txt / .pdf and auto-process to Braille
  • 💾 One-click download for results
  • ♿ Accessibility mode: high contrast, larger fonts

📷 Screenshot

Screenshot (260) Screenshot (261) Screenshot (262) Screenshot (263) Screenshot (264) Screenshot (265)


📦 Setup & Usage

No build tools or frameworks required.
Simply clone or download the repository, then open index.html (and other HTML files in pages/) in a modern browser. For best results, host via GitHub Pages or Netlify.

  1. Clone the repo
   git clone https://github.com/pakelcomedy/Braille-Translator.git
   cd braille-translator-website
  1. Open in Browser

    • Double-click index.html (Text → Braille).
    • Navigate to reverse.html to convert Braille back to plain text.
    • Navigate to upload.html to upload .txt or .pdf files.
    • Navigate to learn.html to see educational resources about Braille.
  2. Using Translation (English ↔ Indonesian)

    • On any editor page (e.g., index.html), select “English → Indonesian” or “Indonesian → English” from the language dropdown.
    • Type or paste text, then click Translate. The translated text appears in the output area. You can then convert that to Braille or vice versa as needed.
  3. Enable High Accessibility Mode

    • Click the “Accessibility” toggle (usually a button or switch icon).
    • The interface will switch to high-contrast colors and larger fonts for better readability.
  4. Download Results

    • After translation or Braille conversion, click the Download button.
    • Choose .txt or .pdf format. The file will be generated client-side and automatically downloaded.

📝 To-Do / Improvements

  • Support for Grade 2 Braille contractions
  • Multilingual support beyond English/Indonesian (e.g., Spanish, French, Bahasa)
  • OCR integration for scanned documents
  • Dark mode toggle (in addition to high-contrast mode)

📜 License

MIT


🤝 Contributing

Pull requests are welcome! For major changes or feature requests, please open an issue first to discuss what you’d like to change.


🙏 Acknowledgments

Inspired by the need for accessible learning tools for the visually impaired. Built with ❤️ using HTML, CSS, and JavaScript.


Releases

No releases published

Packages

No packages published