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
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
9de4178167555916d41985c3a2a2039e50779bfd247e1610d106ceb2b977cac5
|
|
| MD5 |
174c1206a66eee8ef8b82a8c795d3ddd
|
|
| BLAKE2b-256 |
8c44a9c63e8f2d8469ca579aa32187e026ec0a79da295976f0b5d551192dafb6
|
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b97037abc5249269cfa884152d891cc9d1248c11ca6a85e8b7df2e6d58deeefb
|
|
| MD5 |
a98faca465ce4e7569d27f69f374eb33
|
|
| BLAKE2b-256 |
b7acb220f3170aa92ff084a18f94e6fec67b885a2649784b7fb4a86e07973b65
|