🤟 DGS — German Sign Language Trainer

Translations: Deutsch · Français · Español · 繁體中文 · ไทย · Tagalog

---

A browser-based training app for the German Sign Language (DGS) finger alphabet — letters A–Z, umlauts (Ä, Ö, Ü, ß), digraphs (CH, SCH), and numbers 0–9.

Features

• Learn — Browse all signs with multiple views (signer perspective, front view, one-handed)
• Quiz — Identify signs shown at random; tracks correct/wrong answers and streaks
• Spell — Type any word and see it spelled out in DGS signs
• Progress — Visual overview of your accuracy per letter/number
• Multi-language UI — German, English, French, Spanish, Traditional Chinese, Thai, Tagalog
• No repeats — Quiz uses a shuffle queue so you won't see the same sign twice in a row
• Mobile optimized — Responsive layout that adapts when the on-screen keyboard opens

How to Run

Option 1: Open locally (no server needed)

Just open index.html in any modern browser:

firefox index.html
# or
google-chrome index.html
# or double-click the file in your file manager

All image paths are relative — everything works from the filesystem via file://.

Option 2: Quick local server (Python)

cd dgs-trainer/
python3 -m http.server 8080
# → http://localhost:8080

Option 3: Web server

Copy the entire dgs-trainer/ directory to your web root:

cp -r dgs-trainer/ /var/www/html/dgs-trainer/

Then visit http://yourserver/dgs-trainer/.

Works with any static file server — Apache, Nginx, Caddy — or push to any static hosting provider (GitHub Pages, Netlify, etc.). No build step required.

Where Progress is Stored

Progress (quiz scores per letter) is saved in your browser's localStorage under the key dgs_progress. The selected language is stored under dgs_lang.

This means:

• ✅ Progress persists across page reloads and browser restarts
• ✅ No server-side storage or accounts needed
• ⚠️ Progress is per browser — a different browser or device starts fresh
• ⚠️ Clearing browser data / localStorage will reset your progress
• 🗑️ You can also reset progress from the Progress tab in the app

Directory Structure

dgs-trainer/
├── index.html                          # Main app
├── LICENSE                             # MIT License
├── README.md                           # This file (English)
└── lang/                               # Languages, signs & translated READMEs
    ├── en.js, de.js, fr.js, …          # Language files (one per language)
    ├── README.de.md, README.fr.md, …   # Translated READMEs
    └── f-alpha-gross-beidseitig/       # Sign images
        └── clean/                      # Clean versions used by the trainer
            ├── a.gif                   # Front/observer view
            ├── a-view.gif              # Signer's own view
            ├── 0.gif … 9.gif           # Numbers (front view)
            └── …

Mobile Support

Fully responsive design optimized for 5" phones:

• Compact layout adapts to small screens
• When the on-screen keyboard opens, the quiz switches to a side-by-side layout (sign left, controls right) so everything stays visible
• Buttons are reordered with Check closest to the keyboard for easy tapping
• Header and settings bar auto-hide to maximize space
• Works in both portrait and landscape orientation

Sign Views Explained

View	Description	Best for
🙋 Signer view	What you see looking at your own hands	Practicing signing
👀 Front view	What someone facing you would see	Reading/recognizing signs

Browser Support

Any modern browser (Chrome, Firefox, Edge, Safari). No dependencies, no build tools, no frameworks.

License

This project is licensed under the MIT License.