██╗      ██████╗ ██╗    ██╗██╗  ██╗███████╗██╗   ██╗
██║     ██╔═══██╗██║    ██║██║ ██╔╝██╔════╝╚██╗ ██╔╝
██║     ██║   ██║██║ █╗ ██║█████╔╝ █████╗   ╚████╔╝
██║     ██║   ██║██║███╗██║██╔═██╗ ██╔══╝    ╚██╔╝
███████╗╚██████╔╝╚███╔███╔╝██║  ██╗███████╗   ██║
╚══════╝ ╚═════╝  ╚══╝╚══╝ ╚═╝  ╚═╝╚══════╝   ╚═╝
              ██████╗ ████████╗ █████╗ ██╗     ██╗  ██╗███████╗██████╗
              ██╔════╝╚══██╔══╝██╔══██╗██║     ██║ ██╔╝██╔════╝██╔══██╗
              ╚█████╗    ██║   ███████║██║     █████╔╝ █████╗  ██████╔╝
               ╚═══██╗   ██║   ██╔═���██║██║     ██╔═██╗ ██╔══╝  ██╔══██╗
              ██████╔╝   ██║   ██║  ██║███████╗██║  ██╗███████╗██║  ██║
              ╚═════╝    ╚═╝   ╚═╝  ╚═╝╚══════╝╚═╝  ╚═╝╚══════╝╚═╝  ╚═╝

intercept · capture · archive



lowkeystalker is a browser extension that silently intercepts Tinder's internal API traffic, surfaces full profile data in a sleek overlay, and auto-archives everything — JSON and photos — straight to your local machine.


[!TIP]

  • 🚀 **Add Firefox Addon or Extension ** [ADD NOW]

◈  Features


Capability Details
🕸️ API Interception Hooks directly into Tinder's recommendation endpoint — zero scraping, zero clicking
🪟 Live Overlay Non-intrusive panel renders Bio, Location, Job, Age, and more — right on the page
💾 Auto-Download Profile JSON + full-res images saved automatically to your Downloads folder
📁 Custom Paths Set your own subfolder name from the overlay — no config files needed
🔁 Auto-Fetch Re-polls recommendations every 60 seconds so you never miss a profile
🖥️ Local Viewer Flask-based companion app to browse all captured profiles with carousel UI

◈  Installation


  🦊  Firefox  (Recommended)

From the Add-on Store

https://addons.mozilla.org/en-GB/firefox/addon/lowkeystalker/

Click Add to Firefox — done.


Manual / Developer Install

1.  Download or clone this repository
2.  Navigate to:  about:debugging#/runtime/this-firefox
3.  Click         "Load Temporary Add-on..."
4.  Select        manifest.json  from the project root

  🟡  Chrome

1.  Download and extract the source
2.  Navigate to:  chrome://extensions/
3.  Enable        Developer Mode  (top-right toggle)
4.  Click         "Load Unpacked"
5.  Select        the extracted project folder

◈  How It Works


  tinder.com                      lowkeystalker
  ──────────                      ─────────────
  [ API call ] ──── intercept ──▶ [ parse payload ]
                                         │
                              ┌──────────┴──────────┐
                              ▼                     ▼
                       [ overlay UI ]        [ auto-download ]
                         name · bio           profile.json
                         job · location       images/ ──▶ *.jpg
                         age · school

◈  Usage


1 — Log in to Tinder

Open tinder.com and sign in as usual.

2 — Find the Overlay

A dark panel labelled lowkeystalker appears at the bottom-right corner of your screen.

3 — Browse Normally

Swipe or scroll profiles. The extension captures data passively — no interaction required.

4 — Check Your Downloads

Files land in:

~/Downloads/Tinder Data/
└── <name>_<profile_id>/
    ├── <profile_id>.json      ← full profile payload
    └── images/
        ├── 01.jpg
        ├── 02.jpg
        └── ...

5 — View Downloaded Profiles

Use the companion viewer script → tinder_data_viewr.py

# 1. Download the viewer
curl -O https://gist.githubusercontent.com/h9zdev/9ccb7d9999ddca2ebbc397ee2e133626/raw/tinder_data_viewr.py

# 2. Open the file and set your data path (line 6)
DATA_DIR = "/home/<you>/Downloads/Tinder Data"      # Linux / macOS
DATA_DIR = r"C:\Users\<you>\Downloads\Tinder Data"  # Windows

# 3. Install dependency & run
pip install flask
python tinder_data_viewr.py

# 4. Open in your browser
http://127.0.0.1:5050

Renders a searchable sidebar of every captured profile — photo carousel, bio, descriptors, and prompts.

6 — Customize the Folder

Type a new folder name in the overlay's input field — takes effect immediately. Make sure DATA_DIR in the viewer script matches your chosen folder name.


◈  Project Structure


lowkeystalker/
├── manifest.json          # Extension manifest (MV2)
├── background.js          # API interception & download logic
├── content.js             # Overlay injection & UI rendering
├── popup.html / popup.js  # Extension popup (if applicable)
└── icons/
    └── ...

◈  Disclaimer


[!WARNING] This project is provided for educational purposes only. Usage may violate Tinder's Terms of Service. You are solely responsible for how you use this tool. Always respect user privacy.


◈  License


Released under the MIT License — use it, fork it, study it.



built quiet. runs quiet.