ip2e/README.md

85 lines
2.6 KiB
Markdown
Raw Normal View History

2021-04-03 18:52:01 +02:00
ip2e - Receive your public IP (dynamic) by email when it is renewed.
====================================================================
### Tools:
2024-05-01 10:59:22 +02:00
* [ip2e-daemon.py](https://git.q3aql.dev/q3aql/ip2e/src/branch/master/src/ip2e-daemon.py) - Daemon to control & send by email your public IP.
* [ip2e-log.py](https://git.q3aql.dev/q3aql/ip2e/src/branch/master/src/ip2e-log.py) - Tool to see the log file when daemon is running.
* [ip2e-config.py](https://git.q3aql.dev/q3aql/ip2e/src/branch/master/src/ip2e-config.py) - Tool to create a valid configuration file.
2021-04-03 18:52:01 +02:00
### Downloads:
2022-10-22 17:18:20 +02:00
* [ip2e-1.3.2-all.deb](https://drive.proton.me/urls/DVPCQ4208C#NxETtIilTDBF)
* [ip2e-1.3.2-all.rpm](https://drive.proton.me/urls/DVPCQ4208C#NxETtIilTDBF)
* [ip2e-1.3.2.tar.bz2](https://drive.proton.me/urls/DVPCQ4208C#NxETtIilTDBF)
* [ip2e-1.3.2.tar.gz](https://drive.proton.me/urls/DVPCQ4208C#NxETtIilTDBF)
2021-04-03 18:52:01 +02:00
_Dependence: `python3`._
### Installation:
* **Unix systems (GNU/Linux,BSD,etc..):**
* Open the terminal and type the following comands:
```shell
2024-05-01 10:59:22 +02:00
$ git clone https://git.q3aql.dev/q3aql/ip2e.git
2021-04-03 18:52:01 +02:00
$ cd ip2e
$ sudo make install
````
_Note: You must install `git` previously._
* **Mac OS X:**
* Open the terminal and type the following comands:
```shell
2024-05-01 10:59:22 +02:00
$ git clone https://git.q3aql.dev/q3aql/ip2e.git
2021-04-03 18:52:01 +02:00
$ cd ip2e
$ sudo make -f Makefile.OSX
````
_Note: You must install `git` previously._
* **Windows:**
* Install Python 3.x from https://www.python.org/.
2022-10-22 17:18:20 +02:00
* Download `ip2e` from [here](https://gitlab.com/q3aql/ip2e/-/archive/master/ip2e-master.zip).
2021-04-03 18:54:11 +02:00
* Unzip the package in your system. For example in `C:\Program Files\`.
2021-04-03 18:52:01 +02:00
* Double click on `Install.cmd`.
### How to use:
* **Create a valid configuration file:**
* First, you must create the configuration file needed to run `ip2e` correctly.
To do this, run the tool called `ip2e-config.py`:
```shell
$ ip2e-config.py
````
* **Run the daemon:**
* When are configured the necessary data of the email sender & receiver, you can
run the tool called `ip2e-daemon.py`:
```shell
$ ip2e-daemon.py
````
* When daemon is running you can see the log file running the `ip2e-log.py` tool:
```shell
$ ip2e-log.py
````
### Images (Screenshots):
2024-05-01 10:59:22 +02:00
<img src="https://git.q3aql.dev/q3aql/ip2e/raw/branch/master/img/ip2e-command.png" width="700" />
2021-04-03 18:52:01 +02:00
### External links:
* [Python3 homepage](https://www.python.org/downloads/)