Skip to main content

A terminal tool to map IPs and domains with style.

Project description

🌍 YouGotMapped — IP Geolocation Mapper

Ever wondered where that weird IP pinging your router is actually from? Or maybe you're just nosy (respect). Either way — this script's for you.

YouGotMapped is a sassy little Python tool that:

  • Auto-fetches your IP (if you dare expose yourself)
  • Accepts any domain or IP you throw at it
  • Contacts the internet (politely) for geo intel
  • Drops a sweet, interactive map

✨ Features

  • Lookup IP addresses or domains like a pro hacker wannabe
  • Detects your public IP like "hi, it's me"
  • Maps exact-ish coordinates using ipinfo.io
  • Generates a live HTML map with red circle vibes
  • Dependency check? Yup — it acts like a cool installer
  • Quietly avoids private IPs (don’t be that guy)
  • Clean, modular CLI with argparse support

🛠️ Requirements

  • Python 3.7+
  • Packages: requests, folium, ... (or let the script install it for you!)
  • A totally-free IPINFO_TOKEN (get it here)

🚀 Run It Like a Legend

use pip !

pip install yougotmapped
# Clone the repo
git clone https://github.com/diputs-sudo/YouGotMapped.git
cd YouGotMapped

# Option 1: Set token temporarily
export IPINFO_TOKEN=your_ipinfo_token

# Option 2: Let the script prompt you and save it to .env

# Run the thing
$ python3 yougotmapped.py

Then follow the prompts like a civilized hacker. You can:

  • Press Enter to map your own IP (hello, paranoia)
  • Or enter someone else's... 👀 (just be cool about it)

🧪 What You Get

  • A readout of city, region, country, and more
  • A Google Maps-esque HTML file you can open in your browser
  • Optional delete at the end (for sneaky folks)

File: ip_geolocation_map.html

You can keep it. Frame it. Or trash it like a spy after a mission.


🔐 Security Hints

  • We only send your query to ipinfo.io — no creepy business
  • Private IPs are blocked because that’s just weird
  • API token is pulled from env vars (no hardcoded sins here)

🙋 Who Made This?

Created by a ghost.
No name, no trace, no problem.

Contact? Nah, we don’t do that here.
If it breaks, fix it yourself — you're clearly smart enough to run this.


⭐ Why Star This Repo?

Because it's:

  • Actually useful
  • Small but mighty
  • Funny
  • And you’re already here reading this — go on, click ⭐

This repo was cloned 30+ times before it even had a README. That’s how you know it slaps.

Thanks for checking this out. You got mapped! 🗺️

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

yougotmapped-1.0.1.tar.gz (12.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

yougotmapped-1.0.1-py3-none-any.whl (13.1 kB view details)

Uploaded Python 3

File details

Details for the file yougotmapped-1.0.1.tar.gz.

File metadata

  • Download URL: yougotmapped-1.0.1.tar.gz
  • Upload date:
  • Size: 12.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.9.22

File hashes

Hashes for yougotmapped-1.0.1.tar.gz
Algorithm Hash digest
SHA256 a06530067ee33a0a7a619cfc1794bf423257c9e4d00361f95dcd5f949624e21b
MD5 561e8c7339443bf3daaf4a6a186c83d5
BLAKE2b-256 5d9d2b317468fb94a47ae3057d52ffa869c249933f145cef207dcec23d6e9575

See more details on using hashes here.

File details

Details for the file yougotmapped-1.0.1-py3-none-any.whl.

File metadata

  • Download URL: yougotmapped-1.0.1-py3-none-any.whl
  • Upload date:
  • Size: 13.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.9.22

File hashes

Hashes for yougotmapped-1.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 8237d60f69e3636ea17bedab20116a09ae6b24198fe885bc7d67dafbacd06697
MD5 ce8a2833c1eeb6a2c0a74a86aa73f539
BLAKE2b-256 868639afd420f9a6bff5f05acfb22eb1e7dff90e7f009dcd899bcc23afaa34f8

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page