Skip to content

jstubbins98-netize/Enchanted-learning

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 

Repository files navigation

Enchanted Learning

Educational Desktop Application for K-12 Classrooms

Enchanted Learning is an interactive educational software application designed to make learning engaging and accessible for students of all ages. Inspired by beloved 1990s educational software like Encarta, The Magic School Bus, and Carmen Sandiego, this application combines the charm of classic educational games with modern Wikipedia-powered content.


Table of Contents

  1. Overview
  2. System Requirements
  3. Installation
  4. Subject Browser
  5. Wikipedia Search
  6. Interactive Quizzes
  7. World Map Explorer
  8. Educational Games
  9. Classroom Integration Tips
  10. Technical Support

Overview

Enchanted Learning provides a safe, focused learning environment where students can explore educational content without the distractions of web browsers or social media. The application runs entirely on the local computer and requires only an internet connection for fetching Wikipedia articles.

Key Benefits for Educators

  • Distraction-Free Learning: Students stay focused on educational content
  • Curriculum Aligned: Covers core subjects including Science, Mathematics, History, Geography, Language Arts, Computer Science, Music, and Art
  • Self-Paced Exploration: Students can explore topics at their own speed
  • Gamified Learning: Educational games reinforce concepts through play
  • Progress Tracking: Quiz system with star ratings helps track student understanding
  • Safe Content: All content sourced from Wikipedia's educational articles
  • Accessibility Features: Text-to-speech support for articles helps struggling readers and visually impaired students

System Requirements

Requirement Specification
Operating System Windows 10+, macOS 10.14+, or Linux
RAM 2 GB minimum
Storage 50 MB for application
Display 1024 x 768 minimum resolution
Internet Required for Wikipedia content

Installation

Quick Setup (Recommended)

  1. Open a terminal or command prompt
  2. Navigate to the application folder
  3. Run the setup script:
./setup.sh

The setup script will automatically install all required components and compile the application.

Running the Application

After installation, launch Enchanted Learning:

./enchanted_learning

Or on systems with graphics compatibility needs:

LIBGL_ALWAYS_SOFTWARE=1 ./enchanted_learning

Subject Browser

The Subject Browser is the primary way students explore educational content. Upon launching the application, students are greeted with eight colorful subject cards representing major curriculum areas.

Available Subjects

Subject Description
Science Biology, Chemistry, Physics, Astronomy, Geology, Ecology
Mathematics Algebra, Geometry, Calculus, Statistics, Number Theory
History Ancient Civilizations, World Wars, Renaissance, Industrial Revolution
Geography Continents, Oceans, Mountains, Rivers, Climate, Countries
Language Arts Grammar, Literature, Poetry, Writing, Vocabulary
Computer Science Programming, Algorithms, Data Structures, AI, Internet
Music Instruments, Music Theory, Classical, Jazz, Orchestra
Art Painting, Sculpture, Renaissance Art, Modern Art, Photography

How Students Use the Subject Browser

  1. Click on a subject card from the home screen
  2. Browse the list of available topics within that subject
  3. Click on any topic to read the full Wikipedia article
  4. Use the scroll wheel to navigate through longer articles
  5. Click "Read Aloud" to have the article read to you (accessibility feature)
  6. Click "Back" to return to the topic list or press Escape to return home

Wikipedia Search

The Wikipedia Search feature allows students to explore any topic available on Wikipedia, extending learning beyond the predefined subject categories.

Using Wikipedia Search

  1. Click on the search bar in the top-right corner of the screen
  2. Type any topic of interest
  3. Press Enter or click the green search button
  4. If multiple articles match the search:
    • A selection menu appears with all matching results
    • Students click on the specific article they want to read
  5. If no results are found:
    • A message displays indicating no matches
    • Students can try different search terms

Educational Applications

  • Research Projects: Students can research topics for assignments
  • Curiosity-Driven Learning: Encourages students to explore topics that interest them
  • Cross-Curricular Connections: Students discover how subjects interconnect

Interactive Quizzes

The quiz system provides formative assessment opportunities while making learning fun through gamification.

Quiz Features

  • Subject-Specific Questions: Quizzes are tailored to each subject area
  • Star Rating System: Students earn 1-3 stars based on performance
  • Immediate Feedback: Correct/incorrect answers shown instantly
  • Multiple Choice Format: Accessible for all reading levels
  • Unlimited Retakes: Students can practice until they master concepts

How to Access Quizzes

  1. Click "Take a Quiz" from the sidebar menu
  2. Select the subject area to be tested on
  3. Answer the multiple-choice questions
  4. View results and earned stars at the end
  5. Retry to improve scores or try a different subject

Suggested Classroom Uses

  • Bell Ringers: Quick quizzes to start class
  • Learning Stations: Rotate students through quiz stations
  • Assessment: Use as informal checks for understanding
  • Test Preparation: Review before formal assessments

World Map Explorer

The World Map Explorer provides an interactive geography experience where students learn about continents, countries, and world cultures.

Features

  • Interactive World Map: Visual representation of all continents
  • Click-to-Learn: Click on any continent to view detailed information
  • Geographic Facts: Population, area, notable features, and fun facts
  • Visual Learning: Color-coded continents for easy identification

Information Included for Each Region

  • Geographic location and boundaries
  • Population and area statistics
  • Major countries and capitals
  • Notable physical features (mountains, rivers, deserts)
  • Cultural and historical highlights

Classroom Integration

  • Geography Units: Supplement textbook learning with interactive exploration
  • Cultural Studies: Introduce students to world cultures
  • Current Events: Connect news stories to geographic locations
  • Virtual Field Trips: Explore regions students may never visit in person

Educational Games

Enchanted Learning includes four interactive, story-driven educational games designed to reinforce learning through immersive gameplay. Each game features a unique narrative, multiple activity types, and covers different subject areas.

Game Controls (All Games)

Key Action
1-4 Answer multiple choice questions
Arrow Keys Navigate ordering/selection activities
Enter Confirm selection
Space Continue to next activity
Left/Right Select options on victory screen

Scoring System

All games use the same grading scale:

  • A+: 80% or higher
  • B: 60-79%
  • C: 40-59%
  • D: Below 40%

Code Quest

Subject: Computer Science
Target Skills: Understanding compilation, programming concepts, logical sequencing

Storyline: You're a bit of code traveling through the compiler to become a running program! Navigate through each stage of the C++ compilation process.

5 Stages:

  1. Preprocessing - Learn about #include directives and macros
  2. Compilation - Understand how code becomes assembly
  3. Assembly - See how assembly becomes machine code
  4. Linking - Connect object files and libraries
  5. Execution - Run the final program

Activity Types:

  • Quiz: Multiple choice questions about compilation concepts
  • Typing: Type correct code snippets or commands
  • Ordering: Arrange compilation steps in the correct sequence
  • Bug Hunt: Identify false statements about the process

Educational Value:

  • Demystifies how programs are built
  • Introduces programming concepts early
  • Develops logical thinking
  • Prepares students for computer science studies

Math Detective

Subject: Mathematics
Target Skills: Arithmetic, word problems, pattern recognition, logical reasoning

Storyline: You're a rookie detective at the Detective Academy! Solve mysteries by using your math skills to crack cases and catch crooks.

5 Cases:

  1. The Missing Cookies - Addition and subtraction clues
  2. The Treasure Map - Multiplication and patterns
  3. The Secret Code - Division to decode messages
  4. The Geometry Heist - Area and perimeter calculations
  5. The Final Mystery - All skills combined

Activity Types:

  • Equation: Type numerical answers to math problems
  • Word Problems: Read scenarios and solve multi-step problems
  • Pattern Recognition: Find the next number in sequences (e.g., Fibonacci)
  • Logic Puzzles: Use multiple clues to deduce answers

Educational Value:

  • Makes math fun through storytelling
  • Applies math to real-world scenarios
  • Develops problem-solving strategies
  • Builds confidence with numbers

History Explorer

Subject: History / Social Studies
Target Skills: Historical knowledge, chronological thinking, cause and effect

Storyline: You've discovered a mysterious time machine in your attic! Travel through history's greatest eras and learn what shaped our world.

5 Eras:

  1. Ancient Civilizations (3000 BCE - 500 CE) - Egypt, Greece, Rome
  2. Medieval Period (500 - 1400 CE) - Knights, feudalism, Crusades
  3. Renaissance (1400 - 1600 CE) - Art, science, exploration
  4. Modern Era (1600 - 1900 CE) - Revolutions, industry, democracy
  5. Contemporary (1900 - Present) - World wars, technology, space

Activity Types:

  • Quiz: Multiple choice about historical facts and figures
  • Timeline: Arrange events in chronological order
  • Cause & Effect: Match historical causes to their effects

Educational Value:

  • Creates historical context and connections
  • Develops chronological thinking
  • Shows how events influence each other
  • Makes history memorable through adventure

Cell Energy Quest

Subject: Biology
Target Skills: Cellular biology, scientific processes, biochemistry basics

Storyline: You've been shrunk to cellular size and must navigate through the mighty mitochondria! Learn how cells convert glucose into ATP energy.

5 Stages:

  1. Glycolysis - Glucose breakdown in the cytoplasm
  2. Pyruvate Oxidation - Entry into the mitochondria
  3. Krebs Cycle - The citric acid cycle in the matrix
  4. Electron Transport Chain - Building the proton gradient
  5. ATP Synthesis - Producing cellular energy

Activity Types:

  • Quiz: Multiple choice about cellular respiration concepts
  • Ordering: Arrange products and steps correctly
  • Error Finding: Identify false statements about the process

Educational Value:

  • Visualizes abstract biological concepts
  • Teaches fundamental biochemistry
  • Prepares students for advanced biology
  • Makes cellular processes memorable

Classroom Integration Tips

For Teachers

  1. Learning Centers: Set up Enchanted Learning as one station in a rotation
  2. Reward Time: Use game time as a reward for completed assignments
  3. Differentiation: Allow students to explore topics at their level
  4. Flipped Classroom: Assign topics for students to research before class discussion
  5. Assessment Support: Use quizzes for informal assessment data

For Administrators

  1. Computer Lab Installation: Deploy across multiple machines for class-wide use
  2. Curriculum Alignment: Map application content to state standards
  3. Professional Development: Train teachers on integration strategies
  4. Progress Monitoring: Observe student engagement and learning
  5. Parent Communication: Share application benefits in newsletters

Recommended Age Groups

Grade Level Best Features
K-2 World Map Explorer, Subject Browser basics
3-5 Math Detective, History Explorer, Subject Quizzes
6-8 All games, Wikipedia Search, Research projects
9-12 Code Quest, Cell Energy Quest, Computer Science topics

Technical Support

Common Issues and Solutions

Issue Solution
Application won't start Run ./setup.sh to reinstall dependencies
No content loading Check internet connection
Display issues Try running with LIBGL_ALWAYS_SOFTWARE=1 prefix
Slow performance Close other applications to free memory

Keyboard Shortcuts

Key Action
Escape Return to previous screen / Close menus
Enter Submit answers / Confirm selections
Mouse Wheel Scroll through content

Getting Help

For technical assistance or feature requests, please contact your IT administrator or refer to the technical documentation included with the application.


About Enchanted Learning

Enchanted Learning was designed with a simple goal: make learning magical again. By combining the nostalgic charm of classic educational software with modern content delivery, we aim to create an environment where students genuinely enjoy exploring new ideas.

The colorful, friendly interface reduces anxiety and encourages exploration. The game-based elements provide motivation without excessive competition. And the Wikipedia integration ensures content is always current and comprehensive.

We believe every student deserves access to engaging educational tools. Enchanted Learning is our contribution to that mission.


Enchanted Learning - Where Curiosity Meets Discovery

About

Enchanted Learning provides a safe, focused learning environment where students can explore educational content without the distractions of web browsers or social media. The application runs entirely on the local computer and requires only an internet connection for fetching Wikipedia articles.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors