⚡ Speed Typing Master

Un jeu interactif pour améliorer votre vitesse de frappe et votre précision !

📋 Description

Speed Typing Master est un jeu de dactylographie complet qui vous aide à taper plus vite en affichant des phrases aléatoires à reproduire le plus rapidement possible. Le jeu calcule votre vitesse en mots par minute (WPM) et votre taux de précision.

🆕 Nouveau : Mode Progression Mot par Mot !

Le jeu utilise maintenant un système de progression mot par mot :

• Tapez un mot → il devient vert ✅
• Passez automatiquement au mot suivant
• Le mot actuel est surligné pour vous guider 📍
• Plus fluide et satisfaisant qu'avant !

✨ Fonctionnalités

🎯 Fonctionnalités de Base

• Affichage de phrases aléatoires : Phrases en anglais et français
• Chronométrage précis : Mesure le temps exact de frappe
• Calcul du score :
  • Vitesse en mots par minute (WPM)
  • Taux de précision (% de caractères corrects)
• Feedback visuel en temps réel :
  • Texte vert quand correct
  • Texte rouge quand incorrect
• Sauvegarde des scores : Historique de vos performances

🎨 Interface Graphique

• 4 Thèmes visuels :

  • 🌙 Dark Mode : Fond sombre moderne
  • ☀️ Light Mode : Interface claire et lumineuse
  • 💚 Neon : Style cyberpunk avec néon vert
  • 🟤 Retro : Ambiance vintage

• Interface intuitive avec tkinter

• Animations et transitions fluides

• Affichage centralisé des textes

🔊 Effets Sonores

• Son de succès : Quand vous complétez une phrase
• Son d'erreur : Quand vous tapez incorrectement
• Son des touches : Feedback auditif subtil (optionnel)
• Support pygame pour des sons de meilleure qualité

🎮 Modes de Jeu

1. Mode Practice (Entraînement)

   • Une phrase à la fois
   • Résultats détaillés après chaque phrase
   • Pas de limite de temps
   • Idéal pour s'améliorer progressivement

2. Mode Challenge

   • 60 secondes pour taper le maximum de phrases
   • Score cumulatif
   • Compétition contre soi-même
   • Intensité maximale !

📊 Niveaux de Difficulté

• Easy (Facile) : Phrases courtes et simples
• Medium (Moyen) : Phrases avec ponctuation
• Hard (Difficile) : Phrases longues et complexes

🌍 Support Multilingue

• Anglais : Phrases variées en anglais
• Français : Phrases en français (facile et moyen)

🏆 Système de Classement

• Meilleur WPM : Record de vitesse
• Meilleure précision : Record de précision
• Historique : Dernières 50 parties sauvegardées
• Statistiques détaillées :
  • Date et heure
  • WPM, précision, temps
  • Difficulté et mode de jeu
  • Langue utilisée

🚀 Installation

Prérequis

• Python 3.7 ou supérieur
• tkinter (généralement inclus avec Python)

Installation Standard

# Cloner ou télécharger le projet
cd ColinceMethodToTextFast

# Installer les dépendances (optionnel pour les sons)
pip install -r requirements.txt

# Lancer le jeu
python typing_game.py

Installation avec Effets Sonores (Recommandé)

Pour profiter des meilleurs effets sonores :

pip install pygame numpy

Le jeu fonctionnera sans pygame, mais avec des sons système basiques.

🎯 Comment Jouer

1. Lancer le jeu : python typing_game.py

2. Configurer vos préférences :

   • Choisissez la difficulté (Easy, Medium, Hard)
   • Sélectionnez la langue (English, French)
   • Choisissez un thème (Dark, Light, Neon, Retro)
   • Sélectionnez le mode (Practice, Challenge)

3. Démarrer :

   • Cliquez sur "Start Game"
   • Une phrase s'affiche

4. Taper mot par mot :

   • Le premier mot est surligné en bleu (mot actuel)
   • Tapez exactement ce mot
   • Le texte devient vert si correct, rouge si incorrect
   • Quand le mot est correct → il devient vert, le champ se vide
   • Le mot suivant se surligne automatiquement
   • Continuez jusqu'à compléter toute la phrase
   • Écoutez les sons de feedback à chaque mot !

5. Résultats :

   • En mode Practice : voir les résultats après chaque phrase
   • En mode Challenge : continuer jusqu'à la fin du temps

6. Leaderboard :

   • Cliquez sur "Leaderboard" pour voir votre historique
   • Vos meilleurs scores sont enregistrés automatiquement

📁 Structure du Projet

ColinceMethodToTextFast/
│
├── typing_game.py          # Programme principal du jeu
├── sound_effects.py        # Gestionnaire d'effets sonores
├── phrases.json            # Base de données de phrases
├── scores.json            # Sauvegarde des scores (créé automatiquement)
├── requirements.txt        # Dépendances Python
├── README.md              # Ce fichier
├── CHANGELOG.md           # Historique des modifications
├── QUICK_START.md         # Guide de démarrage rapide
├── LICENSE                # Licence MIT
├── run.sh                 # Launcher Mac/Linux
└── run.bat                # Launcher Windows

🎨 Personnalisation

Ajouter des Phrases

Modifiez le fichier phrases.json pour ajouter vos propres phrases :

{
  "easy": [
    "Votre phrase facile ici.",
    "Une autre phrase."
  ],
  "medium": [
    "Phrase de difficulté moyenne avec ponctuation."
  ],
  "hard": [
    "Une phrase longue et complexe pour tester votre vitesse et précision."
  ]
}

Modifier les Thèmes

Dans typing_game.py, cherchez la méthode setup_theme() pour personnaliser les couleurs :

self.themes = {
    "votre_theme": {
        "bg": "#couleur_fond",
        "fg": "#couleur_texte",
        "accent": "#couleur_accent",
        "success": "#couleur_succes",
        "error": "#couleur_erreur",
        "secondary": "#couleur_secondaire"
    }
}

📊 Métriques de Performance

WPM (Words Per Minute)

• Calcul : (nombre de mots / temps en secondes) × 60
• Indicateur principal de vitesse de frappe

Précision (Accuracy)

• Calcul : (caractères corrects / total caractères) × 100
• Mesure la qualité de la frappe

Score Challenge

• En mode Challenge : somme des WPM de toutes les phrases tapées
• Plus vous tapez de phrases rapidement, plus votre score est élevé

🎯 Conseils pour S'améliorer

1. Commencez facile : Débutez avec le niveau Easy
2. Posture : Gardez une bonne posture et position des mains
3. Regardez l'écran : Ne regardez pas le clavier
4. Régularité : Pratiquez régulièrement (10-15 min/jour)
5. Précision d'abord : Privilégiez la précision à la vitesse
6. Mode Challenge : Utilisez-le pour vous tester
7. Analysez vos stats : Identifiez vos points faibles

🐛 Dépannage

Le jeu ne démarre pas

• Vérifiez que Python 3.7+ est installé : python --version
• Vérifiez que tkinter est disponible : python -c "import tkinter"

Pas de sons

• Normal si pygame n'est pas installé
• Installez pygame : pip install pygame numpy

phrases.json introuvable

• Assurez-vous d'être dans le bon répertoire
• Le fichier phrases.json doit être dans le même dossier que typing_game.py

Erreur avec les scores

• Le fichier scores.json sera créé automatiquement
• Si problème persistant, supprimez scores.json (sera recréé)

🔄 Mises à Jour Futures Possibles

• Mode multijoueur en ligne
• Graphiques d'évolution de la vitesse
• Analyse des mots les plus souvent mal tapés
• Support de plus de langues (espagnol, allemand, etc.)
• Leaderboard en ligne
• Personnalisation complète de l'interface
• Mode "typing game" avec des obstacles
• Support des layouts de clavier (AZERTY, QWERTY, etc.)

📝 Licence

Ce projet est sous licence MIT. Vous êtes libre de l'utiliser, le modifier et le distribuer.

👨‍💻 Auteur

Créé avec ❤️ pour améliorer les compétences en dactylographie.

🙏 Remerciements

Merci d'utiliser Speed Typing Master ! N'hésitez pas à partager vos suggestions et commentaires.

---

Bonne frappe ! ⌨️✨