{"id":17675609,"url":"https://github.com/akashchouhan16/traceip","last_synced_at":"2025-05-12T21:23:55.913Z","repository":{"id":169451547,"uuid":"644927359","full_name":"akashchouhan16/traceip","owner":"akashchouhan16","description":"🧬 Go based CLI to geo locate IP addresses, list mx records and more.","archived":false,"fork":false,"pushed_at":"2023-07-18T07:39:03.000Z","size":329,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-01T03:41:42.294Z","etag":null,"topics":["go","go-cli","golang","hacktoberfest","hacktoberfest2024","traceip"],"latest_commit_sha":null,"homepage":"https://hub.docker.com/r/akashchouhan16/traceip","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/akashchouhan16.png","metadata":{"files":{"readme":"Readme.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-05-24T14:40:37.000Z","updated_at":"2024-10-07T04:26:39.000Z","dependencies_parsed_at":null,"dependency_job_id":"d4afa7ef-70d5-4fb7-8c70-07eab075ada5","html_url":"https://github.com/akashchouhan16/traceip","commit_stats":null,"previous_names":["akashchouhan16/traceip"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akashchouhan16%2Ftraceip","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akashchouhan16%2Ftraceip/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akashchouhan16%2Ftraceip/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akashchouhan16%2Ftraceip/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/akashchouhan16","download_url":"https://codeload.github.com/akashchouhan16/traceip/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253823893,"owners_count":21969930,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["go","go-cli","golang","hacktoberfest","hacktoberfest2024","traceip"],"created_at":"2024-10-24T07:22:52.355Z","updated_at":"2025-05-12T21:23:55.862Z","avatar_url":"https://github.com/akashchouhan16.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🧬 TraceIP\n\nA Command line tool built with **[Go](https://go.dev/ \"Go Lang\")** to perform geolocation lookups on IP addresses, list MX records, Name Servers (NS) and track the Canonical names for host servers.\n\nRetrieve information such as host, country, region, city, latitude, longitude and associated organisation with an IP address.\n\n```bash\n$ traceip\n```\n\n## 📜 Quick Setup\n\n\u003e **Learn more about go workspace and installation [here](https://go.dev/doc/tutorial/compile-install \"Visit go.dev docs\").**\n\n- Clone the GitHub repo: \n  - ```bash\n    $ git clone https://github.com/akashchouhan16/traceip.git\n    ```\n  - ```bash\n    $ cd traceip\n    ```\n- Install and compile traceip binary:\n  - ```go\n    $ go install \u0026\u0026 go build\n    ```\n- Run **traceip**:\n  - ```\n    $ traceip\n    ```\n* **System Prerequisites**: **Go 1.17** or above installed.\n\n\n---\n## 🐋 Run with Docker \n- Pull the base image for **traceip** from docker hub.\n  - ```shell\n    $ docker pull akashchouhan16/traceip\n    ```\n- Run as docker container.\n  - ```shell\n    $ docker run akashchouhan16/traceip\n    ```\n- **System Prerequisite:** **Docker runtime** installed locally.\n  \u003e **Note**: Incase any issue is faced with the setup, make sure the `GOPATH` is set to pwd and `go version` is updated. Refer the **[Go compilation guide](https://go.dev/doc/tutorial/compile-install \"Visit go.dev docs\").**\n\n---\n## 🧬 Preview: go build \u0026 run the traceip binary\n  ```shell\n  $ go build \u0026\u0026 traceip\n\n     \n   ======================================================\n  | ████████╗██████╗  █████╗  ██████╗███████╗ ██╗██████╗  |\n  | ╚══██╔══╝██╔══██╗██╔══██╗██╔════╝██╔════╝ ██║██╔══██╗ |\n  |    ██║   ██████╔╝███████║██║     █████╗   ██║██████╔╝ |\n  |    ██║   ██╔══██╗██╔══██║██║     ██╔══╝   ██║██╔═══╝  |\n  |    ██║   ██║  ██║██║  ██║╚██████╗███████╗ ██║██║      |\n  |    ╚═╝   ╚═╝  ╚═╝╚═╝  ╚═╝ ╚═════╝╚══════╝ ╚═╝╚═╝      |\n   ====================================================== \n  A command line tool for networking utility and geolocation lookups on IP addresses.\n \n\n  Usage:\n    traceip [command]\n\n  Available Commands:\n    cname       Perform look up for canonical name (cname) for a particular host.\n    completion  Generate the autocompletion script for the specified shell.\n    help        Help about any command.\n    mx          Perform MX Records look up for a particular host.\n    ns          Perform look up for Name Servers for a particular host.\n    trace       Geo locate an IPv4 or IPv6 with the trace command.\n\n    Flags:\n      -h, --help   help for traceip\n      -4, --ipv4   Enforce IPv4 geo tracing only {wip}\n      -6, --ipv6   Enforce IPv6 geo tracing only {wip}\n\n    Use \"traceip [command] --help\" for more information about a command.\n  ```\n\n## 🧬 CMD: trace `ip_address`\n**To perform geo location lookup on the IP address**\n  ```shell\n  $ traceip trace 45.32.39.145\n\n    Locating IP...\n\n    =====================================================================\n    +---+--------------+-----------------------------------+\n    | - | PARAMETERS   | VALUE                             |\n    +---+--------------+-----------------------------------+\n    | 1 | IP Address   | 45.32.39.145                      |\n    | 2 | City         | Ōi                                |\n    | 3 | Region       | Saitama                           |\n    | 4 | Country      | JP                                |\n    | 5 | Coordinates  | 35.6090,139.7302                  |\n    | 6 | Timezone     | Asia/Tokyo                        |\n    | 7 | Zip/Postal   | 140-8508                          |\n    | 8 | Organization | AS20473 The Constant Company, LLC |\n    +---+--------------+-----------------------------------+\n    =====================================================================\n  ```\n\n## 🧬 CMD: mx `host_name`\n**To list MX Records for a host**\n  ```shell\n  $ traceip mx cal.com\n\n    =====================================================================\n    MS Records for cal.com\n    +---+--------------------------+----------------+\n    | - | MX RECORD HOST           | MX RECORD PREF |\n    +---+--------------------------+----------------+\n    | 1 | aspmx.l.google.com.      |              1 |\n    | 2 | alt1.aspmx.l.google.com. |              5 |\n    | 3 | alt2.aspmx.l.google.com. |              5 |\n    | 4 | alt4.aspmx.l.google.com. |             10 |\n    | 5 | alt3.aspmx.l.google.com. |             10 |\n    +---+--------------------------+----------------+\n    =====================================================================\n  ```\n\n## 🧬 CMD: ns `host_name`\n**To list the Name Servers for a host**\n  ```shell\n  $ traceip ns cal.com\n\n    =====================================================================\n    Name Server(s) for cal.com\n    +---+---------------------------+\n    | - | NAME SERVER               |\n    +---+---------------------------+\n    | 1 | linda.ns.cloudflare.com.  |\n    | 2 | carter.ns.cloudflare.com. |\n    +---+---------------------------+\n    =====================================================================\n  ```\n\n## 🧬 CMD: cname `host_name`\n**To view the canonical name (CNAME) for a host**\n  ```shell\n  $ traceip cname telnet.io\n    =====================================================================\n    canonical name (CNAME) for telnet.io\n    +---+----------------+\n    | - | CANONICAL NAME |\n    +---+----------------+\n    | 1 | park.io.       |\n    +---+----------------+\n    =====================================================================\n  ```\n---\n\n## 🔖 Contributing\nIf you wish to contribute, feel free to reach out with ideas or questions for **traceip** or use the issues tab.\n- **[akash.c1500@gmail.com](mailto:akash.c1500@gmail.com \"Akash's Gmail\")**\n\n### License\nCopyright (c) **Akash Chouhan**. All rights reserved. Released under the **[MIT License](https://github.com/akashchouhan16/traceip/blob/master/LICENSE \"View License\")**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fakashchouhan16%2Ftraceip","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fakashchouhan16%2Ftraceip","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fakashchouhan16%2Ftraceip/lists"}