Skip to content

Latest commit

 

History

History
73 lines (50 loc) · 2.83 KB

README.md

File metadata and controls

73 lines (50 loc) · 2.83 KB
Raw

Odyssey

Tracing URL redirects has never been easier!

Python version Project version Codacy Grade

🚩 Use Cases

  • To see where an affiliate link ends up
  • To see what affiliate network is being used in this process
  • Ensure that your own redirects work correctly as intended to
  • To analyse suspicious URLs from various sources
  • To avoid being tracked by companies
  • To avoid being redirected to malicious websites
  • Discover how many times a site can redirect your request

To learn more about the uses of redirects, and what redirects are, please read this article.

✨ Requirements

  • A python installation above 3.8+, which you can download from the official python website here.

➡️ Installation

Please follow the instructions below.

  • Clone this repository
  • Then execute the command pip install -r requirements.txt

🎖️ Usage

Simply run the entrypoint script called run.py with an appropriate python command and then enter the URL you would like to trace.

> python run.py
[+] URL: https://example.com/test

📝 License

Odyssey - A piece of software that shows a traceroute of a URL redirect path Copyright (c) 2021-2022 IlluminatiFish

This program is free software; you can redistribute it and/or modify the code base under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but without ANY warranty; without even the implied warranty of merchantability or fitness for a particular purpose. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/

Acknowledgements

  • The developers of the modules used in this project
  • The developers of the IP-API website