https://github.com/mews/braille-images

A python app that converts images to text using braille characters
https://github.com/mews/braille-images

image-processing image-processing-python python tkinter tkinter-python

Last synced: 5 months ago
JSON representation

A python app that converts images to text using braille characters

• Host: GitHub
• URL: https://github.com/mews/braille-images
• Owner: Mews
• License: gpl-3.0
• Created: 2024-05-05T18:37:07.000Z (about 2 years ago)
• Default Branch: main
• Last Pushed: 2024-05-07T22:11:23.000Z (about 2 years ago)
• Last Synced: 2024-05-07T23:24:20.459Z (about 2 years ago)
• Topics: image-processing, image-processing-python, python, tkinter, tkinter-python
• Language: Python
• Homepage:
• Size: 10.5 MB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          

# Braille Image Generator

![Logo](https://i.ibb.co/1rR3qGw/braille-images.png)

#### A python app that converts images to text using braille characters, such as

```

⠀⠀⠀⠀⠀⠀⠀⠀⠀⠤⠶⠾⠿⠿⠿⠿⠿⠿⠶⠦⠄⠀⠀⠀⠀⠀⠀⠀⠀⠀

⠀⠀⠀⠀⠀⠀⠀⠀⠾⠿⠛⠛⠿⠿⠿⠿⠿⠿⠿⠿⠿⠧⠀⠀⠀⠀⠀⠀⠀⠀

⠀⠀⠀⠀⠀⠀⠀⠸⠿⠧⠀⠀⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠀⠀⠀⠀⠀⠀⠀⠀

⠀⠀⠀⠀⠀⠀⠀⠸⠿⠿⠷⠾⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠀⠀⠀⠀⠀⠀⠀⠀

⠀⠀⠀⠀⠀⠀⠀⠈⠛⠛⠛⠛⠛⠛⠛⠿⠿⠿⠿⠿⠿⠿⠀⠀⠀⠀⠀⠀⠀⠀

⠀⠀⠤⠶⠶⠶⠶⠶⠶⠶⠶⠶⠾⠾⠿⠿⠿⠿⠿⠿⠿⠿⠀⠰⠶⠶⠶⠦⠀⠀

⠀⠾⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠀⠸⠿⠿⠿⠿⠧⠀

⠸⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠀⠸⠿⠿⠿⠿⠿⠆

⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠏⠀⠾⠿⠿⠿⠿⠿⠇

⠿⠿⠿⠿⠿⠿⠿⠿⠿⠟⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛⠁⠀⠼⠿⠿⠿⠿⠿⠿⠿

⠿⠿⠿⠿⠿⠿⠿⠟⠁⠠⠤⠶⠶⠶⠶⠶⠶⠶⠶⠶⠶⠿⠿⠿⠿⠿⠿⠿⠿⠿

⠿⠿⠿⠿⠿⠿⠿⠀⠰⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠇

⠸⠿⠿⠿⠿⠿⠿⠀⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠁

⠀⠻⠿⠿⠿⠿⠿⠀⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠋⠀

⠀⠀⠙⠻⠿⠿⠟⠀⠿⠿⠿⠿⠿⠿⠿⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛⠋⠁⠀⠀

⠀⠀⠀⠀⠀⠀⠀⠀⠿⠿⠿⠿⠿⠿⠷⠤⠤⠤⠤⠤⠤⠤⠀⠀⠀⠀⠀⠀⠀⠀

⠀⠀⠀⠀⠀⠀⠀⠀⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠛⠛⠿⠿⠀⠀⠀⠀⠀⠀⠀⠀

⠀⠀⠀⠀⠀⠀⠀⠀⠿⠿⠿⠿⠿⠿⠿⠿⠿⠇⠀⠀⠸⠿⠀⠀⠀⠀⠀⠀⠀⠀

⠀⠀⠀⠀⠀⠀⠀⠀⠘⠿⠿⠿⠿⠿⠿⠿⠿⠿⠶⠶⠿⠏⠀⠀⠀⠀⠀⠀⠀⠀

⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠉⠛⠛⠛⠻⠿⠛⠛⠛⠋⠁⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀

```

# Features

- A fully featured GUI to visualize the output and make changes live

    - ![GUI](https://i.ibb.co/ysPDnZG/Screenshot-2024-05-05-185401.png)

- A command line interface available via `py braille-images-main`

## Usage

> Before using the app, you must install its dependencies by running `pip install -r requirements.txt`

To open the GUI simply open the `run.cmd` file, or alternatively run `py main.py`

To use the command line interface run `py braille-images-main -h` for info on how to use it

If you have any issues using the app feel free to [open an issue](https://github.com/Mews/braille-images/issues/new) or contact me through [my discord!](https://discord.com/users/467268976523739157)