From 41d6d68ff3c92a3160aafb23f5dc50b15a319ac3 Mon Sep 17 00:00:00 2001
From: Victor Talpaert <victor.talpaert@gmail.com>
Date: Sat, 2 May 2026 16:43:42 +0200
Subject: [PATCH] reworked some meta data

---
 README.md          | 28 +++++++++++++++-------------
 webpage/index.html |  9 ++++++++-
 2 files changed, 23 insertions(+), 14 deletions(-)

diff --git a/README.md b/README.md
index c58ba4f..480ef37 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,6 @@
-# ESP-Scope
+# ESP-Scope — Web Oscilloscope for ESP32
+
+> Real-time analog signal visualization in any browser, served directly from an ESP32 over WiFi. Flash firmware in one click — no drivers or toolchain needed.
 
 ## Overview
 ESP-Scope is a web-based oscilloscope built using the ESP-IDF v5 framework. It allows users to visualize analog signals in real-time through a web browser. The project leverages the ESP32's ADC capabilities and serves a web interface for signal visualization. By default, one of the ESP pins generates a PWM signal, useful for debugging or generating configurable pulses.
@@ -9,18 +11,7 @@ It also contains a 3D design for a case for the Seeed XIAO ESP32C6.
 
 ![ESP-Scope web interface](screenshot.png)
 
-## Features
-- Real-time signal visualization on a web browser.
-- Adjustable sample rate (1-83333 Hz) and attenuation.
-- Crosshair functionality for precise measurements.
-- Adjustable trigger level.
-- Test PWM signal generation.
-- Reset functionality to clear settings and reload the interface.
-- Power off from the browser.
-
-## Getting Started
-
-### Quickstart — Flash without installing anything
+### Flash without installing anything
 
 Pre-built firmware binaries are available on the [Releases page](https://github.com/vtalpaert/esp-scope/releases/):
 - `esp-scope-esp32-merged.bin` — generic ESP32
@@ -34,6 +25,17 @@ Works with Chrome, Edge, or Opera. Select your firmware version, click **Install
 
 ---
 
+## Features
+- Real-time signal visualization on a web browser.
+- Adjustable sample rate (1-83333 Hz) and attenuation.
+- Crosshair functionality for precise measurements.
+- Adjustable trigger level.
+- Test PWM signal generation.
+- Reset functionality to clear settings and reload the interface.
+- Power off from the browser.
+
+## Getting Started
+
 ### Prerequisites
 - ESP32 development board.
 - [ESP-IDF](https://github.com/espressif/esp-idf) installed and configured.
diff --git a/webpage/index.html b/webpage/index.html
index 0b8f8da..6063eae 100644
--- a/webpage/index.html
+++ b/webpage/index.html
@@ -4,6 +4,13 @@
   <meta charset="UTF-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
   <title>ESP-Scope — Web Oscilloscope for ESP32</title>
+  <meta name="description" content="ESP-Scope is a web-based oscilloscope for the ESP32. Visualize analog signals in real-time from any browser. Flash firmware directly — no drivers or toolchain needed." />
+  <link rel="canonical" href="https://vtalpaert.github.io/esp-scope/" />
+  <meta property="og:title" content="ESP-Scope — Web Oscilloscope for ESP32" />
+  <meta property="og:description" content="Real-time analog signal visualization in your browser. Flash your ESP32 with one click — no drivers, no toolchain." />
+  <meta property="og:image" content="https://vtalpaert.github.io/esp-scope/screenshot.png" />
+  <meta property="og:url" content="https://vtalpaert.github.io/esp-scope/" />
+  <meta name="twitter:card" content="summary_large_image" />
   <script type="module" src="https://unpkg.com/esp-web-tools@10/dist/web/install-button.js?module"></script>
   <style>
     *, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
@@ -362,7 +369,7 @@
     <p class="description">Visualize analog signals in real-time through any web browser. No drivers, no software to install — just flash and go.</p>
     <a href="#flash" class="cta">Flash firmware</a>
     <div class="screenshot">
-      <img src="screenshot.png" alt="ESP-Scope web interface" />
+      <img src="screenshot.png" alt="ESP-Scope oscilloscope web interface showing a real-time waveform on an ESP32" />
     </div>
   </div>
 </header>