/botovh

:robot: Is your domain name already taken? Tell BotOVH to grab it for you when it becomes available for registration.

Primary LanguagePythonMIT LicenseMIT

BotOVH

BotOVH is a tiny bot I wrote for my personnal needs.

Is your domain name already taken? Tell BotOVH to grab it for you when it becomes available for registration.

Requirements

Installation

1. Install BotOVH using pip

pip install botovh

BotOVH automatically installs the following dependencies:

2. Create an OVH API application

To interact with the OVH APIs, BotOVH needs to identify itself using an application_key and an application_secret. To get them, you need to register your application.

Once created, you will obtain an application key and an application secret.

3. Configure BotOVH

Create an botovh.conf configuration file at :

  • Windows : C:\Users\<YOUR_WINDOWS_USERNAME>\.botovh\botovh.conf

  • Linux / Mac : /etc/botovh.conf

Here is how the configuration file looks like :

OVH API

[OVH]
ENDPOINT=ovh-eu
APPLICATION_KEY=<YOUR_APPLICATION_KEY>
APPLICATION_SECRET=<YOUR_APPLICATION_SECRET>
; Use 'botovh --key' to request your OVH consumer key.
CONSUMER_KEY=<YOUR__CONSUMER_KEY>

Email notification

[SMTP]
; Send email notification.
HOST=<SMTP_SERVER_ADDRESS>
PORT=465
USER=<YOUR_SMTP_USER>
PASSWORD=<YOUR_SMTP_PASSWORD>
SEND_FROM=<SEND_EMAIL_FROM>
SEND_TO=<SEND_EMAIL_TO>

Usage

Request a new OVH consumer key:

$ botovh -k

$ botovh --key

Basic usage:

$ botovh example.com fakedomain.org

Specify a file containing the domain names you want to check:

$ botovh -f /path/to/file.txt

$ botovh --file /path/to/file.txt

Specify your preferred payment method:

Payment methods: bankAccount, creditCard, fidelityAccount, ovhAccount or paypal.

$ botovh -p paypal

$ botovh --payment creditCard

Disable console logging using the --quiet argument:

$ botovh example.com fakedomain.org --quiet

Disable email notification using the --noemail argument:

$ botovh example.com fakedomain.org --noemail

Automate BotOVH

You can automate BotOVH to run daily using cron jobs or task scheduler depending on your system.

License

This code is released under a free software license and you are welcome to fork it.