Skip to content

h9zdev/Lowkeystalker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation


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

intercept · capture · archive


Firefox Add-on Version License


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.


◈  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.

About

Intercepts and displays Tinder profile details directly on-page in a clean, searchable interface. Automatically captures profile data, downloads profile photos, stores bios, interests, prompts, and metadata, then exports everything into structured JSON files for analysis, archiving, or OSINT workflows.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors