https://github.com/guillermodotn/pppoe-retriever

A tool to extract PPPoE credentials from ISP-locked routers.
https://github.com/guillermodotn/pppoe-retriever

credentials isp pppoe python3

Last synced: 13 days ago
JSON representation

A tool to extract PPPoE credentials from ISP-locked routers.

• Host: GitHub
• URL: https://github.com/guillermodotn/pppoe-retriever
• Owner: guillermodotn
• License: mit
• Created: 2024-08-05T12:37:45.000Z (4 months ago)
• Default Branch: main
• Last Pushed: 2024-08-23T10:50:12.000Z (3 months ago)
• Last Synced: 2024-08-24T00:28:59.582Z (3 months ago)
• Topics: credentials, isp, pppoe, python3
• Language: Python
• Homepage:
• Size: 8.79 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# PPPoE Retriever

Python script designed to retrieve PPPoE (Point-to-Point Protocol over Ethernet) credentials from routers that are restricted or locked down by ISPs (Internet Service Providers). This tool is particularly useful for those who need to manage or reconfigure network settings but encounter difficulties accessing credentials due to ISP-imposed restrictions.

> **Note:** Limited to Ethernet WAN Routers

## Features

- **Retrieve PPPoE Credentials**: Extract PPPoE usernames and passwords from routers that are typically locked down by ISPs.

- **Support for Multiple Routers**: Works with various router models and ISPs, with support for additional models to be added in future updates.

- **User-Friendly**: Simple command-line interface (CLI) for ease of use.

- **Cross platform**: Works on Windows, Linux and MacOS

- **Self contain**: No installation or setup needed, Python frozen binaries available to download.

## Installation

No need to install, you can find frozen-binaries for Linux, Mac and Windows under the [release page](https://github.com/guillermodotn/pppoe-retriever/releases/latest).

## Usage

1. Connect the router WAN port to you computer using a Ethernet cable.

2. Identify the interface you have connected the router.

3. Download `pppoe-retrieval` script for your platform.

4. Run the program and allow it some time to complete its process.

    ```bash

    $ ./pppoe-retriever-ubuntu-latest -i 

    ```

    > On Linux, run it with root privileges.

For more information about how to use this script refer to: [PPPoE Credential Retrieval Tutorial](https://guillermodotn.github.io/posts/Retrieve_PPPoE_credentials/)

## Tested devices

If you have tested this tool on a device that is not listed below, please consider submitting an update with your new entry or creating an issue with the details of the device.

| Model               | ISP            | Firmware Version |

|---------------------|----------------|------------------|

| lowi-h500s          | lowi           | 1.0.0            |