Skip to main content

A terminal tool to map IPs and domains with style.

Reason this release was yanked:

outdated github pages

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/Zynk-dot/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.0.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.0-py3-none-any.whl (13.1 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: yougotmapped-1.0.0.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.0.tar.gz
Algorithm Hash digest
SHA256 9de4178167555916d41985c3a2a2039e50779bfd247e1610d106ceb2b977cac5
MD5 174c1206a66eee8ef8b82a8c795d3ddd
BLAKE2b-256 8c44a9c63e8f2d8469ca579aa32187e026ec0a79da295976f0b5d551192dafb6

See more details on using hashes here.

File details

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

File metadata

  • Download URL: yougotmapped-1.0.0-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.0-py3-none-any.whl
Algorithm Hash digest
SHA256 b97037abc5249269cfa884152d891cc9d1248c11ca6a85e8b7df2e6d58deeefb
MD5 a98faca465ce4e7569d27f69f374eb33
BLAKE2b-256 b7acb220f3170aa92ff084a18f94e6fec67b885a2649784b7fb4a86e07973b65

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