README
¶
Gomainr
Terminal cli app that checks the availability of domains for different configurations of keywords.
Installation
You need to have Go installed.
# go get github.com/MichaelThessel/gomainr
# gomainr
Usage
The main purpose of this tool is to find available domains for different keywords. I.e.:
- Keywords 1: foo bar
- Keywords 2: alice bob
- TLDs: com net
Will search for:
- fooalice.com
- fooalice.net
- baralice.com
- baralice.net
- foobob.com
- foobob.net
- barbob.com
- barbob.net
and return the available domain names.
Keywords 2 is optional, so you can just search for various domains among different TLDs.
You can save a session to a file and load it later again. This way you can view the results again without performing a new search. In addition this allows you to modify the keywords and repeat a search without typing the keywords all over again.
TLD Substitution
You can enable TLD substitution which will check if the end of your domain could be replaced by a TLD. I.e.:
fishnet - fish.net
Keyboard Shortcuts
| Shortcut | Action |
|---|---|
| CTRL+q | Quit |
| CTRL+/ | Search |
| UP, DOWN, TAB | Navigate |
| CTRL+j | Scroll result list down |
| CTRL+k | Scroll result list up |
| CTRL+r | Toggle TLD substitution |
| CTRL+s | Save session |
| CTRL+l | Load session |
API Keys
By default gomainr will use DNS to query for available domains. This will be sufficient in most cases. Sometimes DNS servers can be configured incorrectly and this will result in incorrect results. To get more precise results gomainr supports both the NameCheap.com and GoDaddy.com APIs. To do API based searches you need to obtain an API key from either service and add your credentials to the gomainr config file (make sure to disable the DNS source).
# $HOME/.gomainr/config
To be allowed to use the NameCheap API you need to fulfill certain conditions. It will also take up to 48 hours for NameCheap to activate your API access (if you ask nicely in the live chat they might do it right away though :). There are no restrictions for access to the GoDaddy API. Unless you already have a bunch of domains with NameCheap it's probably easiest to get a GoDaddy key.
Notes
To speed up consecutive searches and to keep things light on the APIs gomainr caches API request results for 24hrs. If you want to flush the cache for some reason you can delete the contents of this directory:
# $HOME/.gomainr/data
Thanks
This project utilizes the following 3rd party packages
Documentation
¶
There is no documentation for this package.
Source Files
Directories