Trevohack / domain-hunter

A small app made to "hunt" domains that are about to be available.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

domain-hunter

A small app made to "hunt" domains that are about to be available.



Demo

Default: System Notification Center

Email Notification


Up & Running

  • Install nodejs if you don't have it.
  • Install PM2
npm install -g pm2
  • Clone repo
git clone git@github.com:robiXxu/domain-hunter.git
  • Navigate to domain-hunter directory
cd domain-hunter
  • Install dependencies
npm install 
  • Build
npm run build
  • Run
pm2 start dist/app.js
  • Monitoring
pm2 monit

Configure Notification

If you are running the app on your pc then you don't have to do anything.

If you want to receive notification via email:

  1. Duplicate .env-sample and rename the copy to .env
  2. Open .env and fill with your details:
  // Account used to send the mail. 
  // I don't recommend using your personal email account.
  // You can create a new google account 

  DOMAIN_HUNTER_EMAIL_USER="<youremail@example.com>"
  DOMAIN_HUNTER_EMAIL_PASS="<examplePassword>"
  
  // Target email - where you want to send the email. 
  // You can use as a target email your personal email address
  // I recommend you to add a +suffix (so you can group emails) | e.g. schiriac.robert+notice_domain_hunter@gmail.com
  DOMAIN_HUNTER_EMAIL_TO="<targetemail@example.com>"

NOTE: you can also export those env variables. ( add exports in your .bashrc | .zshrc | .whatever )


Up & Running Dev

  • Install nodejs or yarn if you don't have it.
  • Clone repo
git clone git@github.com:robiXxu/domain-hunter.git
  • Navigate to domain-hunter directory
cd domain-hunter
  • Install dependencies
npm install 
  • Run in dev
npm run dev

Dependencies

In package.json:


Todo

  • Ability to choose between push notification or email based notification ( maybe run on a Raspberry PI )
  • replace whois-json with a native implementation of whois in unix systems to avoid calls. (Will not work on Win)

About

A small app made to "hunt" domains that are about to be available.

License:MIT License


Languages

Language:TypeScript 98.8%Language:Python 1.2%