IP tracing and GeoIP mapping userscript for OmeTV with face analysis and static map previews.
Highlights
- 🛰️ IP lookups via IPInfo
- 🗺️ Static map previews via Geoapify
Quick Install
- Install Violentmonkey from https://violentmonkey.github.io/get-it/
- Click this raw URL to install the userscript: https://raw.githubusercontent.com/nom0x0nk/OmeTrace/main/ometrace.user.js
Violentmonkey will open and prompt you to install.
- After installation, edit the userscript and set your
IPINFO_API_KEYandGEOAPIFY_API_KEYconstants. - Visit https://ome.tv — the overlay appears when a WebRTC connection is established.
Features
- 🔎 Capture public IP from WebRTC candidates and fetch geo info
- 🗺️ Show static map with marker and open full map on click
- 🧑🦱 Draw optional face boxes and show age/gender estimates
- 🔒 Streamer Mode to redact IP in UI
Demo
![]() |
![]() |
API Keys
-
IPInfo (IP lookups):
- Open https://ipinfo.io/signup and create an account.
- Log in and open your dashboard at https://ipinfo.io/dashboard.
- Find and copy the API Token shown on the dashboard.
- Paste that token into the
IPINFO_API_KEYconstant inometrace.user.js. - Example token format from the script:
c8d4712fa90b63.
-
Geoapify (static maps):
- Open https://myprojects.geoapify.com/register and create an account.
- In the Geoapify dashboard, add a new project ("Create project" / "Add new project").
- Open the project and copy the API key from the project's API Keys section.
- Paste that key into the
GEOAPIFY_API_KEYconstant inometrace.user.js. - Example key format from the script:
3f8a1c7d9b2e4f6a5c8d1b7e3f2a9c40.
Notes & Links
- The userscript loads Face-API for optional detection and uses IPInfo + Geoapify for location and maps.
- Source script: ometrace.user.js


