Braillest Tooling

Table of Contents

• Welcome
• Getting Started
• Manifesto
• Usage
• Samples
• Embossing Process
• Repair Process
• Standard

Welcome

Howdy! 🤠 Welcome to the primary tooling repo of the Braillest project. This repo contains all the scripts needed to:

• Source sample books from the gutenberg press website and convert them into their standalone texts.
• Translate texts into braille while performing back translations to compare against.
• Perform formatting and pagination operations to comply with constraints of printing format.
• Generate the produced braille pages into mold STLs for slicing and printing.

Getting Started

1. Download and install Docker.
2. Clone this repo. git clone git@github.com:Braillest/tooling.git
3. Navigate to the root of the project in the terminal and run docker compose up -d
4. Enter the container docker exec -it braillest_tooling bash
5. Authenticate gh gh auth login. Follow the instructions to authenticate. Add PAT with the following permissions:

Administration: Read/Write
Contents: Read/Write
Metadata: Read
Pull requests: Read/Write

Manifesto

Usage

From within the container:

• Download books: python download_books.py

From the host at the root of the project:

• Generate molds: ./scripts/generate_all_page_molds.sh <text_file>

ex) ./scripts/generate_all_page_molds.sh "./data/1-texts/Dracula by Bram Stoker.txt"

Samples

Embossing Process

Print Universal Negative

Print Positive

Load Mold

Mold Sandwich

Calibrate Roller Press

Load Mold Sandwich

Remove Mold Sandwich

Remove Negative

Sample Result

Stack of Flyers

Repair Process

Sample

Damaged

Load Damaged Mold

Mold Sandwich Roller

Remove

Standard