Skip to content

Latest commit

Β 

History

History
83 lines (67 loc) Β· 3.16 KB

README.md

File metadata and controls

83 lines (67 loc) Β· 3.16 KB

⌨️ Windows Keyboard Event Monitoring Lab

⚠️ Educational & Authorized Security Research Only

πŸ”¬ Windows Security Research β€’ Python β€’ Windows API β€’ Keyboard Event Monitoring


🧬 About

A Python-based Windows security research project demonstrating how Python can interact with the Windows API to observe keyboard-event state.

The project uses ctypes and the Windows GetAsyncKeyState() API to examine virtual-key states, detect key transitions, convert selected keys into readable representations, buffer events, and demonstrate HTTP communication through a configured Discord webhook.


✨ Features

  • πŸͺŸ Windows API integration using Python ctypes
  • ⌨️ Virtual-key state monitoring
  • πŸ”„ Key press transition detection
  • 🧡 Background worker thread
  • πŸ”’ Thread-safe event buffering
  • πŸ“¦ JSON payload generation
  • 🌐 HTTP POST communication
  • 🐍 Python standard-library implementation
  • πŸ§ͺ Controlled cybersecurity research

πŸ› οΈ Technology Stack

Technology Purpose
🐍 Python 3 Main programming language
πŸͺŸ Windows API Keyboard-state interaction
ctypes Native Windows API access
threading Background processing
urllib.request HTTP communication
json Payload generation

πŸ” How It Works

          β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
          β”‚   Windows Keyboard  β”‚
          β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                     β”‚
                     β–Ό
          β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
          β”‚  GetAsyncKeyState() β”‚
          β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                     β”‚
                     β–Ό
          β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
          β”‚  Key State Tracking β”‚
          β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                     β”‚
                     β–Ό
          β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
          β”‚  Event Buffer       β”‚
          β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                     β”‚
                     β–Ό
          β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
          β”‚ Background Thread   β”‚
          β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                     β”‚
                     β–Ό
          β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
          β”‚  JSON / HTTP POST   β”‚
          β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜