Files
echolot/web/public/index.html
T
mrambossekandClaude Fable 5 14e5fad1b2 engine: downstream MTU and downstream train in the measurement document
Three facts the client cannot produce alone, kept deliberately separate:
mtu.pmtud_down (largest datagram that arrives unfragmented — meaningful only
because the server sets DF), mtu.frag_delivery (whether larger ones arrive once
fragmentation is allowed), and train.udp_downstream (loss, reordering and
arrival spacing in the download direction, which a round trip cannot separate
from upstream loss).

ServerMeasurement now runs them on the same ProbeSession as the echo train. It
had to: a fresh session restarts client-side sequence numbers and the server's
anti-replay window discards the lot, so the re-primed source is never recorded
and every granted send goes to a socket that has already closed. That produced
four confidently-wrong FAILED tests and a RED verdict on a healthy network.

Live against fmr: path MTU 1500, fragments to 4000, 100/100 downstream, GREEN.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-08-01 10:54:38 +02:00

327 lines
14 KiB
HTML

<!doctype html>
<!-- SPDX-FileCopyrightText: 2026 Echolot contributors
SPDX-License-Identifier: GPL-3.0-or-later -->
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Echolot — measure, don't guess</title>
<meta name="description" content="Free Android app for detecting and debugging local network issues: rogue DHCP, broken IPv6 RAs, MTU black holes, multicast loss, lying DNS. No root required.">
<meta property="og:title" content="Echolot">
<meta property="og:description" content="Measure, don't guess. F/OSS Android network diagnostics — no root required.">
<meta property="og:url" content="https://echo-lot.app/">
<meta property="og:image" content="https://echo-lot.app/assets/social-preview.png">
<meta name="theme-color" media="(prefers-color-scheme: dark)" content="#071522">
<meta name="theme-color" media="(prefers-color-scheme: light)" content="#F2F6F7">
<link rel="icon" href="/assets/icon.svg" type="image/svg+xml">
<link rel="icon" href="/assets/icon.png" type="image/png" sizes="512x512">
<link rel="apple-touch-icon" href="/assets/icon.png">
<style>
/* Branding: teal is always the instrument (links, brackets, controls);
the single amber point is the finding (the focused node, the version
readout). Dark = the instrument's own display; light = the same tokens
on paper. Palette from assets/branding/. */
:root {
color-scheme: dark;
--bg-0: #0C2130; /* top of page */
--bg-1: #071522; /* abyss — page floor, panel ground */
--tile: #0E2433; /* raised surfaces */
--foam: #E8F4F2; /* primary text */
--slate: #7DA2AC; /* secondary text */
--caption:#5E8B96; /* mono captions, from the banner */
--grid: #10303F; /* hairlines */
--rest: #1E4A5C; /* the network, at rest */
--teal: #35E0C4; /* instrument */
--on-teal:#04212B; /* text on teal */
--amber: #FFB454; /* the finding */
--mono: "Cascadia Code", "SF Mono", Consolas, "Liberation Mono", Menlo, monospace;
--sans: "Segoe UI", system-ui, -apple-system, "Helvetica Neue", Arial, sans-serif;
}
@media (prefers-color-scheme: light) {
:root {
color-scheme: light;
--bg-0: #F2F6F7;
--bg-1: #E4ECEF;
--tile: #EBF1F3;
--foam: #1B3540; /* ink, from wordmark-on-light */
--slate: #47656F;
--caption:#5E8B96;
--grid: #C4D3D8;
--rest: #9FB8C1;
--teal: #0E9384; /* instrument, printable contrast */
--on-teal:#F5FBFA;
--amber: #C77413; /* finding ink */
}
}
* { box-sizing: border-box; margin: 0; }
html { scroll-behavior: smooth; }
body {
font-family: var(--sans);
color: var(--foam);
background: linear-gradient(var(--bg-0), var(--bg-1) 70%);
min-height: 100vh;
line-height: 1.6;
-webkit-font-smoothing: antialiased;
}
a { color: var(--teal); text-decoration-thickness: 1px; text-underline-offset: 3px; }
a:hover { text-decoration-thickness: 2px; }
:focus-visible { outline: 2px solid var(--teal); outline-offset: 3px; border-radius: 2px; }
.col { max-width: 46rem; margin: 0 auto; padding: 0 1.25rem; }
/* Graduated rule: the tick motif from the banner, vertical. Fixed left
margin, desktop only, purely decorative. */
.rule {
position: fixed; top: 0; bottom: 0; left: 0; width: 3.5rem;
border-right: 1px solid var(--grid);
display: none;
}
@media (min-width: 72rem) { .rule { display: block; } }
.rule::after {
content: ""; position: absolute; right: 0; top: 0; bottom: 0; width: .4rem;
background: repeating-linear-gradient(to bottom, var(--rest) 0 1.5px, transparent 1.5px 60px);
}
header.hero { padding: 4.5rem 0 3rem; }
.wordmark { display: block; height: 30px; width: auto; }
h1 {
font-size: clamp(1.9rem, 5vw, 3rem);
font-weight: 650; letter-spacing: -.02em; line-height: 1.15;
margin: 1.75rem 0 .75rem; max-width: 30ch;
}
.hero p.lede { color: var(--slate); max-width: 52ch; font-size: 1.05rem; }
.hero p.lede strong { color: var(--foam); font-weight: 600; }
/* Focus panel: the signature, straight from the mark. The network at rest,
one node under examination — teal brackets are the instrument, the amber
point is the finding. */
figure.focus {
margin: 2.5rem 0 0; border: 1px solid var(--grid); border-radius: 4px;
background: var(--tile);
position: relative; overflow: hidden;
}
.focus svg { display: block; width: 100%; height: auto; }
.focus .rest-node { fill: var(--rest); }
.focus .bracket { fill: none; stroke: var(--teal); stroke-width: 3; stroke-linecap: round; stroke-linejoin: round; }
.focus .finding { fill: var(--amber); }
.focus .halo { fill: none; stroke: var(--amber); stroke-width: 2; opacity: .3; }
.focus .readout { font-family: var(--mono); font-size: 11px; fill: var(--slate); }
.focus .readout .flag { fill: var(--amber); }
.focus .lead { stroke: var(--grid); stroke-width: 1; }
.focus figcaption {
position: absolute; top: .5rem; left: .75rem;
font-family: var(--mono); font-size: .65rem; color: var(--caption);
}
@keyframes examine { 0%, 100% { opacity: .3; } 50% { opacity: .1; } }
.focus .halo { animation: examine 3.2s ease-in-out infinite; }
@media (prefers-reduced-motion: reduce) {
.focus .halo { animation: none; }
html { scroll-behavior: auto; }
}
section { padding: 3.5rem 0 0; }
.eyebrow {
font-family: var(--mono); font-size: .7rem; letter-spacing: .25em;
text-transform: uppercase; color: var(--teal);
}
h2 { font-size: 1.35rem; font-weight: 650; margin: .5rem 0 1rem; letter-spacing: -.01em; }
section > .col > p { color: var(--slate); max-width: 58ch; }
section p + p { margin-top: .8rem; }
section p strong { color: var(--foam); font-weight: 600; }
/* Sounding table: what it actually measures — real content, mono, no icons */
table.soundings {
width: 100%; border-collapse: collapse; margin-top: 1.5rem;
font-size: .9rem;
}
.soundings td {
padding: .55rem .75rem .55rem 0; border-top: 1px solid var(--grid);
vertical-align: top;
}
.soundings td:first-child {
font-family: var(--mono); font-size: .8rem; white-space: nowrap;
color: var(--foam); padding-right: 1.25rem;
}
.soundings td:last-child { color: var(--slate); }
.tiers { display: flex; gap: .5rem; flex-wrap: wrap; margin-top: 1.25rem; }
.tier {
font-family: var(--mono); font-size: .75rem;
border: 1px solid var(--grid); border-radius: 3px; padding: .35rem .6rem;
color: var(--slate);
}
.tier b { color: var(--teal); font-weight: 600; }
/* Install */
.release {
font-family: var(--mono); font-size: .8rem; color: var(--slate);
margin-top: 1.25rem;
}
.release b { color: var(--amber); font-weight: 600; }
.buttons { display: flex; gap: .75rem; flex-wrap: wrap; margin: 1rem 0 1rem; }
.btn {
display: inline-block; padding: .7rem 1.3rem; border-radius: 4px;
font-weight: 600; text-decoration: none; font-size: .95rem;
}
.btn.primary { background: var(--teal); color: var(--on-teal); }
.btn.primary:hover { filter: brightness(1.08); }
.btn.ghost { border: 1px solid var(--grid); color: var(--foam); }
.btn.ghost:hover { border-color: var(--slate); }
.note {
font-size: .85rem; color: var(--slate);
border-left: 2px solid var(--teal); padding-left: .9rem; max-width: 52ch;
}
.checksum { font-family: var(--mono); font-size: .75rem; color: var(--slate); margin-top: 1rem; }
footer {
margin-top: 4.5rem; padding: 2rem 0 3rem;
border-top: 1px solid var(--grid);
font-size: .85rem; color: var(--slate);
}
footer .col { display: flex; gap: 1.5rem; flex-wrap: wrap; justify-content: space-between; }
</style>
</head>
<body>
<div class="rule" aria-hidden="true"></div>
<header class="hero">
<div class="col">
<picture>
<source srcset="/assets/wordmark-on-dark.svg" media="(prefers-color-scheme: dark)">
<img class="wordmark" src="/assets/wordmark-on-light.svg" alt="echolot" width="125" height="30">
</picture>
<h1>Measure, don't guess.</h1>
<p class="lede">Free Android diagnostics for the layer where networks actually break.
<strong>Echolot</strong> takes the failure you can feel and pins it to a fact you can show —
<strong>no root required</strong>. Built for people who know what a neighbor table is.</p>
<figure class="focus">
<figcaption>focus · dhcp.rogue_detect · tier:app</figcaption>
<svg viewBox="0 0 720 240" role="img" aria-label="A grid of network nodes at rest; one node is framed by viewfinder brackets, highlighted as a finding: two DHCP servers answered the same DISCOVER">
<!-- the network, at rest -->
<g class="rest-node">
<circle cx="120" cy="60" r="3"/><circle cx="240" cy="60" r="3"/><circle cx="360" cy="60" r="3"/><circle cx="480" cy="60" r="3"/><circle cx="600" cy="60" r="3"/>
<circle cx="120" cy="120" r="3"/><circle cx="480" cy="120" r="3"/><circle cx="600" cy="120" r="3"/>
<circle cx="120" cy="180" r="3"/><circle cx="240" cy="180" r="3"/><circle cx="360" cy="180" r="3"/><circle cx="480" cy="180" r="3"/><circle cx="600" cy="180" r="3"/>
</g>
<!-- one node, under examination -->
<circle class="halo" cx="240" cy="120" r="11"/>
<circle class="finding" cx="240" cy="120" r="5"/>
<g class="bracket">
<path d="M 222 111 V 102 H 231"/>
<path d="M 249 102 H 258 V 111"/>
<path d="M 258 129 V 138 H 249"/>
<path d="M 231 138 H 222 V 129"/>
</g>
<!-- the readout -->
<line class="lead" x1="262" y1="120" x2="296" y2="120"/>
<g class="readout">
<text x="304" y="112">DISCOVER → 2 OFFERs</text>
<text x="304" y="130">192.168.1.1 gw · <tspan class="flag">192.168.1.223 — who is this?</tspan></text>
</g>
</svg>
</figure>
</div>
</header>
<section id="what">
<div class="col">
<p class="eyebrow">What it measures</p>
<h2>Signal bars lie. Timings don't.</h2>
<p>Most wifi apps show you signal strength and call it a diagnosis. The failures that ruin
home and office networks live deeper: a second DHCP server nobody admits to, IPv6 router
advertisements gone wrong, an MTU black hole that only eats large packets, multicast dying
quietly at the AP, a resolver answering differently than it should.</p>
<table class="soundings">
<tr><td>dhcp.rogue_detect</td><td>Who is answering DISCOVER — and is it more than one box?</td></tr>
<tr><td>ipv6.ra_audit</td><td>Router advertisements: lifetimes, flags, prefixes that shouldn't be there</td></tr>
<tr><td>mtu.blackhole</td><td>Path MTU probing — find the packet size where the network goes silent</td></tr>
<tr><td>local.mdns_discover</td><td>Does multicast actually survive your AP? What's announcing itself?</td></tr>
<tr><td>dns.canary</td><td>Compare answers against reference records — catch rewriting resolvers</td></tr>
<tr><td>trace.errqueue</td><td>Traceroute without root, straight from the kernel error queue</td></tr>
</table>
<p style="margin-top:1rem">Every run separates <strong>what was observed</strong> from
<strong>what it means</strong>, and exports as JSON — so the evidence survives the argument.</p>
</div>
</section>
<section id="tiers">
<div class="col">
<p class="eyebrow">Privilege tiers</p>
<h2>No root required. More access if you have it.</h2>
<p>Everything above runs as a plain app. Pair once over wireless ADB with
<a href="https://shizuku.rikka.app/">Shizuku</a> and Echolot additionally reads neighbor
tables, RA-installed routes, and DHCP client logs — still no root. Every result records
which tier produced it.</p>
<div class="tiers">
<span class="tier"><b>app</b> — no setup, the bulk of it</span>
<span class="tier"><b>shizuku</b> — wireless ADB pairing, in v1</span>
<span class="tier">root — future module</span>
</div>
</div>
</section>
<section id="install">
<div class="col">
<p class="eyebrow">Install</p>
<h2>Get Echolot</h2>
<p class="release" id="release" hidden></p>
<div class="buttons">
<a class="btn primary" id="dl-btn" href="/apk">Download APK</a>
<a class="btn ghost" href="/fdroid">F-Droid</a>
</div>
<p class="note" id="prerelease-note"><strong>Pre-release.</strong> The capability prober is
running on real hardware; the production app is under construction. These links go live with
the first release — until then they loop back here. No mailing list, no tracker: check back,
or watch the <a href="/source">repository</a>.</p>
<p class="checksum" id="checksum">releases will ship with sha256sums + a signing key you can pin</p>
</div>
</section>
<footer>
<div class="col">
<span>GPL-3.0-or-later · protocol &amp; schema docs CC-BY-4.0</span>
<span><a href="/source">source</a> · no analytics, no cookies, no third-party requests</span>
</div>
</footer>
<script>
// Release readout: asks this site's own Worker (/api/latest, which proxies the
// Gitea "latest release" API, edge-cached). Progressive enhancement — with no
// JS, no network, or no release yet, the static pre-release copy above stands.
(async () => {
let rel;
try {
const res = await fetch("/api/latest");
if (!res.ok) return;
rel = await res.json();
} catch { return; }
if (!rel || !rel.available) return;
const line = document.getElementById("release");
const ver = document.createElement("b");
ver.textContent = rel.version;
line.append("» latest ", ver);
const date = (rel.published_at || "").slice(0, 10);
if (date) line.append(" · " + date);
if (rel.apk && rel.apk.size) {
line.append(" · " + (rel.apk.size / 1048576).toFixed(1) + " MiB");
}
line.hidden = false;
document.getElementById("prerelease-note").hidden = true;
if (rel.sha256) {
const c = document.getElementById("checksum");
c.textContent = "";
const a = document.createElement("a");
a.href = "/apk.sha256";
a.textContent = "sha256";
c.append(a, " · verify before you sideload");
}
})();
</script>
</body>
</html>