doc: 📝 document example of an docker-compose.yml file

✨ add man page

.dockerignore

@@ -0,0 +1,9 @@
+**/.env
+**/.dockerignore
+**/.docker-compose.debug.yml
+**/.docker-compose.yml
+**/.git
+**/.gitignore
+**/.gitchangelog.rc
+man/man.rst
+man/man-defs.rst

.gitignore

@@ -1 +1,2 @@
 .env*
+docker-compose*

CHANGELOG.md

@@ -1,10 +1,24 @@
 # Changelog
 
 
-## (unreleased)
+## 0.1.0 (2021-04-22)
 
 ### New
 
+* :sparkles: add Dockerfile. [Eduard Veit]
+
+* :sparkles: add loop mode. [Eduard Veit]
+
+* :sparkles: add support for Duck DNS as DynDNS2 provider. [Eduard Veit]
+
+* :sparkles: add support for deSEC as DynDNS2 provider. [Eduard Veit]
+
+* :sparkles: add completion. [Eduard Veit]
+
+  :sparkles: add man page
+
+* :sparkles: replace getopt with argbash. [Eduard Veit]
+
 * :sparkles: add interpretaton of status codes and act accordingly. [Eduard Veit]
 
 * :sparkles: make network interface configurable. [Eduard Veit]
@@ -13,7 +27,7 @@
 
 * :sparkles: add .gitchangelog.rc. [Eduard Veit]
 
-* :sparkles: add dynb. [Eduard Veit]
+* :sparkles: add dynb.sh. [Eduard Veit]
 
 ### Fix
 
@@ -23,14 +37,26 @@
 
 ### Documentation
 
+* :memo: document example of an docker-compose.yml file. [Eduard Veit]
+
+* :memo: document loop mode and dig as requirement. [Eduard Veit]
+
+* :memo: update example of .env in README.md. [Eduard Veit]
+
 * :memo: add CHANGELOG.md. [Eduard Veit]
 
-* :memo: add .env.example. [Eduard Veit]
+* :memo: add example.env. [Eduard Veit]
 
 * :memo: write README.md. [Eduard Veit]
 
 ### Other
 
+* :recycle: refactor: rename environment variables. [Eduard Veit]
+
+* :recycle: refactor, fix and debug error handling. [Eduard Veit]
+
+* :recycle: refactor main code. [Eduard Veit]
+
 * Initial commit. [EV21]
 
 

Dockerfile

@@ -0,0 +1,5 @@
+FROM alpine:latest
+RUN apk update && apk add bash curl jq bind-tools
+WORKDIR /usr/src/app
+COPY . .
+CMD /bin/bash /usr/src/app/dynb.sh

README.md

@@ -11,6 +11,7 @@ IPv4 (A) and IPv6 (AAAA) record updates are supported.
 - [⚙ Configuration](#-configuration)
 - [🏃 Run](#-run)
 - [⏰ Cron](#-cron)
+- [⏰ docker](#-docker)
 <!-- /TOC -->
 
 ## ✨ Update Methods
@@ -18,27 +19,26 @@ The following update methods are currently implemented:
 
 ### APIs
 
-* INWX.com JSON-RPC-API  
+* INWX.com Domrobot JSON-RPC-API  
   Limitations:
   - minimum TTL is 300 (5 minutes)
 
 ### DynDNS2
 
 * INWX.com  
+* deSEC.io (dedyn.io)  
+* DuckDNS.org  
 * dynv6.com  
 
 ## 📦 Requirements
 
-* `curl` - The minimum requirement for running DynDNS2 operations
+* `curl` - The minimum requirement for all API requests.
+* `dig` - You can get it by installing `dnsutils` (debian/ubuntu/ArchLinux), `bind-utils` (CentOS/RHEL), `bind-tools` (Alpine)
 
-essential for APIs:
+also essential if you are using other APIs:
 
 * `jq` - Command-line JSON processor
 
-optional requirement:
-
-* `getopt` for CLI parameter handling from [util-linux](https://pkgs.org/download/util-linux)
-
 ## 🚀 Installation
 
 Download the latest release
@@ -52,30 +52,31 @@ If you want to add the script to you PATH, run :point_down:
 ```
 bash dynb.sh --link
 ```
-This convenience function only works if `util-linux` is installed on your system.
 
 ## ⚙ Configuration
 
 You can use a config in form of an `.env` file.
-Or if your system meets the relevant requirements you can use CLI parameters.
+Or you can just use CLI parameters.
 
 Create `.env` in the app root directory or at `~/.local/share/dynb/.env`.
 ```
-_dyn_domain=dyndns.example.com
+DYNB_DYN_DOMAIN=dyndns.example.com
 
-## service provider could be inwx
-_serviceProvider=inwx
+## service provider could be deSEC, duckdns, dynv6, inwx
+DYNB_SERVICE_PROVIDER=inwx
 
 ## update method options: domrobot, dyndns
-_update_method=domrobot
+DYNB_UPDATE_METHOD=domrobot
 
 ## ip mode could be either: 4, 6 or dual for dualstack
-_ip_mode=dual
+DYNB_IP_MODE=64
 
 ## If you are using the DomRobot RPC-API enter your credentials for the web interface login here
 ## If you are using the DynDNS2 protocol enter your credentials here
-_username=
-_password=
+DYNB_USERNAME=User42
+DYNB_PASSWORD=SuperSecretPassword
+## or use a token
+DYNB_TOKEN=
 ```
 
 ## 🏃 Run
@@ -97,7 +98,14 @@ dynb --ip-mode dualstack --update-method dyndns --provider inwx --domain dyndns.
 ```
 
 ## ⏰ Cron
-To automatically call the script you can use cron.
+
+To automatically call the script you can use either crontab or the script can also run in a loop mode.
+
+### loop mode
+
+Just use the parameter `--interval 60` or the environment variable `DYNB_INTERVAL=60` so the script will check every 60 seconds if it needs to do an update.
+
+### crontab
 
 execute :point_down:
 ```
@@ -108,3 +116,27 @@ then enter :point_down: to run dynb every five minutes.
 */5 * * * * $HOME/.local/bin/dynb >> $HOME/.local/share/dynb/dynb-cron.log
 ```
 Note, cron typically does not use the users PATH variable.
+
+## 🐟 docker
+
+This is an example of a `docker-compose.yml` file. If you are using IPv6 make sure the routing works properly with your docker container.
+```yaml
+version: '3.4'
+
+services:
+  dynb:
+    image: ev21/dynb
+    container_name: dynb
+    network_mode: host
+    build:
+      context: .
+      dockerfile: ./Dockerfile
+    environment:
+      - DYNB_DYN_DOMAIN=dyndns.example.com
+      - DYNB_SERVICE_PROVIDER=inwx
+      - DYNB_UPDATE_METHOD=dyndns
+      - DYNB_IP_MODE=64
+      - DYNB_USERNAME=User42
+      - DYNB_PASSWORD=SuperSecretPassword
+      - DYNB_INTERVAL=60
+```

_dynb.sh

@@ -0,0 +1,41 @@
+#!/bin/bash
+
+# Put this file to /etc/bash_completion.d/dynb.sh
+# needed because of Argbash --> m4_ignore([
+### START OF CODE GENERATED BY Argbash v2.10.0 one line above ###
+# Argbash is a bash code generator used to get arguments parsing right.
+# Argbash is FREE SOFTWARE, see https://argbash.io for more info
+
+_dynb_sh ()
+{
+	local cur prev opts base
+	COMPREPLY=()
+	cur="${COMP_WORDS[COMP_CWORD]}"
+	prev="${COMP_WORDS[COMP_CWORD-1]}"
+	all_long_opts="--version --link --reset --debug --update-method --ip-mode --domain --service-provider --username --password --token --interval --help "
+	all_short_opts="-v -l -r -m -i -d -s -u -p -t -h "
+	case "$prev" in
+		--update-method|-m|--ip-mode|-i|--domain|-d|--service-provider|-s|--username|-u|--password|-p|--token|-t|--interval)
+			COMPREPLY=( $(compgen -o bashdefault -o default -- "${cur}") )
+			return 0
+			;;
+		*)
+			case "$cur" in
+				--*)
+					COMPREPLY=( $(compgen -W "${all_long_opts}" -- "${cur}") )
+					return 0
+					;;
+				-*)
+					COMPREPLY=( $(compgen -W "${all_short_opts}" -- "${cur}") )
+					return 0
+					;;
+				*)
+					COMPREPLY=( $(compgen -o bashdefault -o default -- "${cur}") )
+					return 0
+					;;
+			esac
+	esac
+
+}
+complete -F _dynb_sh dynb.sh
+### END OF CODE GENERATED BY Argbash (sortof) ### ])

dynb.sh

@@ -10,33 +10,33 @@
 ## Configuration ##
 ###################
 
-_dyn_domain=
+#DYNB_DYN_DOMAIN=
 
-## service provider could be inwx
-_serviceProvider=
+## service provider could be deSEC, duckdns, dynv6, inwx
+#DYNB_SERVICE_PROVIDER=
 
 ## update method options: domrobot, dyndns
-_update_method=
+#DYNB_UPDATE_METHOD=
 
 ## ip mode could be either: 4, 6 or dual for dualstack
-_ip_mode=
+#DYNB_IP_MODE=
 
 ## If you are using the DomRobot RPC-API enter your credentials for the web interface login here
 ## If you are using the DynDNS2 protocol enter your credentials here
-_username=
-_password=
+#DYNB_USERNAME=
+#DYNB_PASSWORD=
 ## or use a token
-_token=
+#DYNB_TOKEN=
 
- ## TTL (time to live) for the DNS record
- ## This setting is only relevant for API based record updates (not DnyDNS2!)
- ## minimum allowed TTL value by inwx is 300 (5 minutes)
+## TTL (time to live) for the DNS record
+## This setting is only relevant for API based record updates (not DnyDNS2!)
+## minimum allowed TTL value by inwx is 300 (5 minutes)
 TTL=300
 
 ## The IP-Check sites (some sites have different urls for v4 and v6)
 ## Pro tip: use your own ip check server for privacy
 ## it could be as simple as that...
-## create an index.php with <?php echo $_SERVER['REMOTE_ADDR']; ?>
+## create an index.php with <?php echo $_SERVER'REMOTE_ADDR'; ?>
 _ipv4_checker=api64.ipify.org
 _ipv6_checker=api64.ipify.org
 
@@ -55,7 +55,6 @@ _new_IPv4=
 _new_IPv6=
 _dns_records=
 _main_domain=
-_has_getopt=
 _is_IPv4_enabled=false
 _is_IPv6_enabled=false
 _interface_str=
@@ -66,12 +65,242 @@ _response=
 _statusHostname=
 _statusUsername=
 _statusPassword=
-_version=0.0.1
+_version=0.1.0
 _userAgent="DynB/$_version github.com/EV21/dynb"
 _configFile=$HOME/.local/share/dynb/.env
 _statusFile=/tmp/dynb.status
-_debug=1
+_debug=0
+_minimum_looptime=60
+_loopMode=0
 
+# Created by argbash-init v2.10.0
+# Rearrange the order of options below according to what you would like to see in the help message.
+# ARG_OPTIONAL_BOOLEAN([version],[v],[outputs the client version],[off])
+# ARG_OPTIONAL_BOOLEAN([link],[l],[links to your script at ~/.local/bin/dynb],[off])
+# ARG_OPTIONAL_BOOLEAN([reset],[r],[deletes the client blocking status file],[off])
+# ARG_OPTIONAL_BOOLEAN([debug],[],[enables debug mode],[off])
+# ARG_OPTIONAL_SINGLE([update-method],[m],[choose if you want to use DynDNS2 or the DomRobot RPC-API],[])
+# ARG_OPTIONAL_SINGLE([ip-mode],[i],[updates type A (IPv4) and AAAA (IPv6) records],[])
+# ARG_OPTIONAL_SINGLE([domain],[d],[set the domain you want to update],[])
+# ARG_OPTIONAL_SINGLE([service-provider],[s],[set your provider in case you are using DynDNS2],[])
+# ARG_OPTIONAL_SINGLE([username],[u],[depends on your selected update method and your provider],[])
+# ARG_OPTIONAL_SINGLE([password],[p],[depends on your selected update method and your provider],[])
+# ARG_OPTIONAL_SINGLE([token],[t],[depends on your selected update method and your provider],[])
+# ARG_OPTIONAL_SINGLE([interval],[],[choose the seconds interval to run the script in a loop, minimum is 60],[])
+# ARG_HELP([DynB - dynamic DNS update script for bash])
+# ARGBASH_GO()
+# needed because of Argbash --> m4_ignore([
+### START OF CODE GENERATED BY Argbash v2.10.0 one line above ###
+# Argbash is a bash code generator used to get arguments parsing right.
+# Argbash is FREE SOFTWARE, see https://argbash.io for more info
+
+
+die()
+{
+	local _ret="${2:-1}"
+	test "${_PRINT_HELP:-no}" = yes && print_help >&2
+	echo "$1" >&2
+	exit "${_ret}"
+}
+
+
+begins_with_short_option()
+{
+	local first_option all_short_options='vlrmidsupth'
+	first_option="${1:0:1}"
+	test "$all_short_options" = "${all_short_options/$first_option/}" && return 1 || return 0
+}
+
+# THE DEFAULTS INITIALIZATION - OPTIONALS
+_arg_version="off"
+_arg_link="off"
+_arg_reset="off"
+_arg_debug="off"
+_arg_update_method=
+_arg_ip_mode=
+_arg_domain=
+_arg_service_provider=
+_arg_username=
+_arg_password=
+_arg_token=
+_arg_interval=
+
+
+print_help()
+{
+	printf '%s\n' "DynB - dynamic DNS update script for bash"
+	printf 'Usage: %s [-v|--(no-)version] [-l|--(no-)link] [-r|--(no-)reset] [--(no-)debug] [-m|--update-method <arg>] [-i|--ip-mode <arg>] [-d|--domain <arg>] [-s|--service-provider <arg>] [-u|--username <arg>] [-p|--password <arg>] [-t|--token <arg>] [--interval <arg>] [-h|--help]\n' "$0"
+	printf '\t%s\n' "-v, --version, --no-version: outputs the client version (off by default)"
+	printf '\t%s\n' "-l, --link, --no-link: links to your script at ~/.local/bin/dynb (off by default)"
+	printf '\t%s\n' "-r, --reset, --no-reset: deletes the client blocking status file (off by default)"
+	printf '\t%s\n' "--debug, --no-debug: enables debug mode (off by default)"
+	printf '\t%s\n' "-m, --update-method: choose if you want to use DynDNS2 or the DomRobot RPC-API (no default)"
+	printf '\t%s\n' "-i, --ip-mode: updates type A (IPv4) and AAAA (IPv6) records (no default)"
+	printf '\t%s\n' "-d, --domain: set the domain you want to update (no default)"
+	printf '\t%s\n' "-s, --service-provider: set your provider in case you are using DynDNS2 (no default)"
+	printf '\t%s\n' "-u, --username: depends on your selected update method and your provider (no default)"
+	printf '\t%s\n' "-p, --password: depends on your selected update method and your provider (no default)"
+	printf '\t%s\n' "-t, --token: depends on your selected update method and your provider (no default)"
+	printf '\t%s\n' "--interval: choose the seconds interval to run the script in a loop, minimum is 60 (no default)"
+	printf '\t%s\n' "-h, --help: Prints help"
+}
+
+
+parse_commandline()
+{
+	while test $# -gt 0
+	do
+		_key="$1"
+		case "$_key" in
+			-v|--no-version|--version)
+				_arg_version="on"
+				test "${1:0:5}" = "--no-" && _arg_version="off"
+				;;
+			-v*)
+				_arg_version="on"
+				_next="${_key##-v}"
+				if test -n "$_next" -a "$_next" != "$_key"
+				then
+					{ begins_with_short_option "$_next" && shift && set -- "-v" "-${_next}" "$@"; } || die "The short option '$_key' can't be decomposed to ${_key:0:2} and -${_key:2}, because ${_key:0:2} doesn't accept value and '-${_key:2:1}' doesn't correspond to a short option."
+				fi
+				;;
+			-l|--no-link|--link)
+				_arg_link="on"
+				test "${1:0:5}" = "--no-" && _arg_link="off"
+				;;
+			-l*)
+				_arg_link="on"
+				_next="${_key##-l}"
+				if test -n "$_next" -a "$_next" != "$_key"
+				then
+					{ begins_with_short_option "$_next" && shift && set -- "-l" "-${_next}" "$@"; } || die "The short option '$_key' can't be decomposed to ${_key:0:2} and -${_key:2}, because ${_key:0:2} doesn't accept value and '-${_key:2:1}' doesn't correspond to a short option."
+				fi
+				;;
+			-r|--no-reset|--reset)
+				_arg_reset="on"
+				test "${1:0:5}" = "--no-" && _arg_reset="off"
+				;;
+			-r*)
+				_arg_reset="on"
+				_next="${_key##-r}"
+				if test -n "$_next" -a "$_next" != "$_key"
+				then
+					{ begins_with_short_option "$_next" && shift && set -- "-r" "-${_next}" "$@"; } || die "The short option '$_key' can't be decomposed to ${_key:0:2} and -${_key:2}, because ${_key:0:2} doesn't accept value and '-${_key:2:1}' doesn't correspond to a short option."
+				fi
+				;;
+			--no-debug|--debug)
+				_arg_debug="on"
+				test "${1:0:5}" = "--no-" && _arg_debug="off"
+				;;
+			-m|--update-method)
+				test $# -lt 2 && die "Missing value for the optional argument '$_key'." 1
+				_arg_update_method="$2"
+				shift
+				;;
+			--update-method=*)
+				_arg_update_method="${_key##--update-method=}"
+				;;
+			-m*)
+				_arg_update_method="${_key##-m}"
+				;;
+			-i|--ip-mode)
+				test $# -lt 2 && die "Missing value for the optional argument '$_key'." 1
+				_arg_ip_mode="$2"
+				shift
+				;;
+			--ip-mode=*)
+				_arg_ip_mode="${_key##--ip-mode=}"
+				;;
+			-i*)
+				_arg_ip_mode="${_key##-i}"
+				;;
+			-d|--domain)
+				test $# -lt 2 && die "Missing value for the optional argument '$_key'." 1
+				_arg_domain="$2"
+				shift
+				;;
+			--domain=*)
+				_arg_domain="${_key##--domain=}"
+				;;
+			-d*)
+				_arg_domain="${_key##-d}"
+				;;
+			-s|--service-provider)
+				test $# -lt 2 && die "Missing value for the optional argument '$_key'." 1
+				_arg_service_provider="$2"
+				shift
+				;;
+			--service-provider=*)
+				_arg_service_provider="${_key##--service-provider=}"
+				;;
+			-s*)
+				_arg_service_provider="${_key##-s}"
+				;;
+			-u|--username)
+				test $# -lt 2 && die "Missing value for the optional argument '$_key'." 1
+				_arg_username="$2"
+				shift
+				;;
+			--username=*)
+				_arg_username="${_key##--username=}"
+				;;
+			-u*)
+				_arg_username="${_key##-u}"
+				;;
+			-p|--password)
+				test $# -lt 2 && die "Missing value for the optional argument '$_key'." 1
+				_arg_password="$2"
+				shift
+				;;
+			--password=*)
+				_arg_password="${_key##--password=}"
+				;;
+			-p*)
+				_arg_password="${_key##-p}"
+				;;
+			-t|--token)
+				test $# -lt 2 && die "Missing value for the optional argument '$_key'." 1
+				_arg_token="$2"
+				shift
+				;;
+			--token=*)
+				_arg_token="${_key##--token=}"
+				;;
+			-t*)
+				_arg_token="${_key##-t}"
+				;;
+			--interval)
+				test $# -lt 2 && die "Missing value for the optional argument '$_key'." 1
+				_arg_interval="$2"
+				shift
+				;;
+			--interval=*)
+				_arg_interval="${_key##--interval=}"
+				;;
+			-h|--help)
+				print_help
+				exit 0
+				;;
+			-h*)
+				print_help
+				exit 0
+				;;
+			*)
+				_PRINT_HELP=yes die "FATAL ERROR: Got an unexpected argument '$1'" 1
+				;;
+		esac
+		shift
+	done
+}
+
+parse_commandline "$@"
+
+# OTHER STUFF GENERATED BY Argbash
+
+### END OF CODE GENERATED BY Argbash (sortof) ### ])
+# [ <-- needed because of Argbash
+
+# The generated argbash help message does not look as nice as this:
 _help_message="$(cat << 'EOF'
 dynb - dynamic DNS update script for bash
 
@@ -100,6 +329,14 @@ dynb --ip-mode dual --update-method dyndns --service-provider inwx --domain dynd
 EOF
 )"
 
+function loopMode() {
+  if [[ $_loopMode -eq 1 ]]; then
+    return 0
+  else
+    return 1
+  fi
+}
+
 function debugMode() {
   if [[ $_debug -eq 1 ]]; then
     return 0
@@ -110,7 +347,7 @@ function debugMode() {
 
 function debugMessage() {
   if debugMode; then
-    echo "Debug: ${1}"
+    echo "Debug: $*"
   fi
 }
 
@@ -120,8 +357,8 @@ function echoerr() { printf "%s\n" "$*" >&2; }
 function getMainDomain() {
   request=$( echo "{}" | \
       jq '(.method="nameserver.list")' | \
-      jq "(.params.user=\"$_username\")" | \
-      jq "(.params.pass=\"$_password\")"
+      jq "(.params.user=\"$DYNB_USERNAME\")" | \
+      jq "(.params.pass=\"$DYNB_PASSWORD\")"
     )
 
   _response=$(curl --silent  \
@@ -129,7 +366,7 @@ function getMainDomain() {
       --user-agent "$_userAgent" \
       --header "Content-Type: application/json" \
       --request POST $_INWX_JSON_API_URL \
-      --data "$request" | jq ".resData.domains[] | select(inside(.domain=\"$_dyn_domain\"))"
+      --data "$request" | jq ".resData.domains[] | select(inside(.domain=\"$DYNB_DYN_DOMAIN\"))"
     )
   _main_domain=$( echo "$_response" | jq --raw-output '.domain'  )
 }
@@ -137,10 +374,10 @@ function getMainDomain() {
 function fetchDNSRecords() {
   request=$( echo "{}" | \
       jq '(.method="'nameserver.info'")' | \
-      jq "(.params.user=\"$_username\")" | \
-      jq "(.params.pass=\"$_password\")" | \
+      jq "(.params.user=\"$DYNB_USERNAME\")" | \
+      jq "(.params.pass=\"$DYNB_PASSWORD\")" | \
       jq "(.params.domain=\"$_main_domain\")" | \
-      jq "(.params.name=\"$_dyn_domain\")"
+      jq "(.params.name=\"$DYNB_DYN_DOMAIN\")"
     )
 
   _response=$( curl --silent  \
@@ -189,8 +426,8 @@ function updateRecord() {
   if [[ $IP != "" ]]; then
   request=$( echo "{}" | \
       jq '(.method="nameserver.updateRecord")' | \
-      jq "(.params.user=\"$_username\")" | \
-      jq "(.params.pass=\"$_password\")" | \
+      jq "(.params.user=\"$DYNB_USERNAME\")" | \
+      jq "(.params.pass=\"$DYNB_PASSWORD\")" | \
       jq "(.params.id=\"$ID\")" | \
       jq "(.params.content=\"$IP\")" | \
       jq "(.params.ttl=\"$TTL\")"
@@ -203,7 +440,7 @@ function updateRecord() {
       --request POST $_INWX_JSON_API_URL \
       --data "$request"
      )
-     echo -e "$(echo "$_response" | jq --raw-output '.msg')\n Domain: $_dyn_domain\n new IPv${1}: $IP"
+     echo -e "$(echo "$_response" | jq --raw-output '.msg')\n Domain: $DYNB_DYN_DOMAIN\n new IPv${1}: $IP"
   fi
 }
 
@@ -214,21 +451,34 @@ function dynupdate() {
   myipv6_str=myipv6
 
   INWX_DYNDNS_UPDATE_URL="https://dyndns.inwx.com/nic/update?"
-  NOIP_DYNDNS_UPDATE_URL="https://dynupdate.no-ip.com/nic/update?hostname=$_dyn_domain&"
-  DYNV6_DYNDNS_UPDATE_URL="https://dynv6.com/api/update?zone=$_dyn_domain&token=$_token&"
+  DESEC_DYNDNS_UPDATE_URL="https://update.dedyn.io/?"
+  DUCKDNS_DYNDNS_UPDATE_URL="https://www.duckdns.org/update?domains=$DYNB_DYN_DOMAIN&token=$DYNB_TOKEN&"
+  DYNV6_DYNDNS_UPDATE_URL="https://dynv6.com/api/update?zone=$DYNB_DYN_DOMAIN&token=$DYNB_TOKEN&"
 
-  if [[ $_serviceProvider == "inwx" ]]; then
-    dyndns_update_url=$INWX_DYNDNS_UPDATE_URL
-  fi
-  if [[ $_serviceProvider == "noip" ]] || [[ $_serviceProvider == "no-ip" ]]; then
-    dyndns_update_url=$NOIP_DYNDNS_UPDATE_URL
-  fi
-  if [[ $_serviceProvider == "dynv6" ]]; then
-    dyndns_update_url="${DYNV6_DYNDNS_UPDATE_URL}"
-    myip_str=ipv4
-    myipv6_str=ipv6
-  fi
+  case $DYNB_SERVICE_PROVIDER in
+    inwx* | INWX* )
+      dyndns_update_url=$INWX_DYNDNS_UPDATE_URL
+    ;;
+    deSEC* | desec* | dedyn* )
+      dyndns_update_url="${DESEC_DYNDNS_UPDATE_URL}"
+    ;;
+    dynv6* )
+      dyndns_update_url="${DYNV6_DYNDNS_UPDATE_URL}"
+      myip_str=ipv4
+      myipv6_str=ipv6
+    ;;
+    DuckDNS* | duckdns* )
+      dyndns_update_url="${DUCKDNS_DYNDNS_UPDATE_URL}"
+      myip_str=ipv4
+      myipv6_str=ipv6
+    ;;
+    * )
+    echoerr "$DYNB_SERVICE_PROVIDER is not supported"
+    exit 1
+    ;;
+  esac
 
+  # pre encode ip parameters
   if [[ $_is_IPv4_enabled == true ]] && [[ $_is_IPv6_enabled == true ]]; then
     dyndns_update_url="${dyndns_update_url}${myip_str}=${_new_IPv4}&${myipv6_str}=${_new_IPv6}"
   fi
@@ -239,22 +489,32 @@ function dynupdate() {
     dyndns_update_url="${dyndns_update_url}${myipv6_str}=${_new_IPv6}"
   fi
   debugMessage "Update URL was: $dyndns_update_url"
+
   ## request ##
-  if [[ $_serviceProvider == "dynv6" ]]; then
-    _response=$(curl --silent "$_interface_str" \
+  case $DYNB_SERVICE_PROVIDER in
+    inwx* | INWX* )
+      _response=$(curl --silent "$_interface_str" \
+      --user-agent "$_userAgent" \
+      --user "$DYNB_USERNAME":"$DYNB_PASSWORD" \
+      "${dyndns_update_url}" )
+    ;;
+    deSEC* | desec* | dedyn* )
+      _response=$(curl --silent "$_interface_str" \
+      --user-agent "$_userAgent" \
+      --header "Authorization: Token $DYNB_TOKEN" \
+      --get --data-urlencode "hostname=$DYNB_DYN_DOMAIN" \
+      "${dyndns_update_url}" )
+    ;;
+    dynv6* | duckDNS* | duckdns* )
+      _response=$(curl --silent "$_interface_str" \
         --user-agent "$_userAgent" \
         "${dyndns_update_url}"
       )
-  fi
-  if [[ $_serviceProvider == "inwx" || $_serviceProvider == "noip" ]]; then
-    _response=$(curl --silent "$_interface_str" \
-      --user-agent "$_userAgent" \
-      --user "$_username":"$_password" \
-      "${dyndns_update_url}" )
-  fi
+    ;;
+  esac
 
   case $_response in
-    good* )
+    good* | OK* | "addresses updated" )
       if [[ $_response == "good 127.0.0.1" ]]; then
         echoerr "Error: $_response: Request ignored."
         return 1
@@ -289,7 +549,7 @@ function dynupdate() {
       return 1
     ;;
     notfqdn )
-      echoerr "Error: $_response: Hostname $_dyn_domain is invalid"
+      echoerr "Error: $_response: Hostname $DYNB_DYN_DOMAIN is invalid"
       return 1
     ;;
     nohost )
@@ -335,7 +595,7 @@ function checkStatus() {
       fi
     ;;
     nohost | !yours )
-      if [[ "$_statusHostname" == "$_dyn_domain" && ( "$_statusUsername" == "$_username" || $_statusUsername == "$_token" ) ]]; then
+      if [[ "$_statusHostname" == "$DYNB_DYN_DOMAIN" && ( "$_statusUsername" == "$DYNB_USERNAME" || $_statusUsername == "$DYNB_TOKEN" ) ]]; then
         echoerr "Error: Hostname supplied does not exist under specified account, enter new login credentials before performing an additional request."
         return 1
       else
@@ -344,7 +604,7 @@ function checkStatus() {
       return 0
     ;;
     badauth | 401 )
-      if [[ "$_statusUsername" == "$_username" && "$_statusPassword" == "$_password" ]]; then
+      if [[ "$_statusUsername" == "$DYNB_USERNAME" && "$_statusPassword" == "$DYNB_PASSWORD" ]]; then
         echoerr "Error: Invalid username password combination."
         return 1
       else
@@ -396,27 +656,27 @@ function checkStatus() {
 function ipHasChanged() {
   if [[ ${1} == 4 ]]; then
     remote_ip=$(getRemoteIP 4 $_ipv4_checker)
-    if [[ $_update_method == domrobot ]]; then
+    if [[ $DYNB_UPDATE_METHOD == domrobot ]]; then
       dns_ip=$(getDNSIP A)
     else
-      dns_ip=$(dig @${_DNS_checkServer} in a +short "$_dyn_domain")
+      dns_ip=$(dig @${_DNS_checkServer} in a +short "$DYNB_DYN_DOMAIN")
     fi
   fi
   if [[ ${1} == 6 ]]; then
     remote_ip=$(getRemoteIP 6 $_ipv6_checker)
-    if [[ $_update_method == domrobot ]]; then
+    if [[ $DYNB_UPDATE_METHOD == domrobot ]]; then
       dns_ip=$(getDNSIP AAAA)
     else
-      dns_ip=$(dig @${_DNS_checkServer} in aaaa +short "$_dyn_domain")
+      dns_ip=$(dig @${_DNS_checkServer} in aaaa +short "$DYNB_DYN_DOMAIN")
     fi
   fi
 
   if [[ ${1} == 4 ]]; then
     _new_IPv4=$remote_ip
-    #echo "New IPv4: $_new_IPv4 old was: $dns_ip"
+    debugMessage "New IPv4: $_new_IPv4 old was: $dns_ip"
   else
     _new_IPv6=$remote_ip
-    #echo "New IPv6: $_new_IPv6 old was: $dns_ip"
+    debugMessage "New IPv6: $_new_IPv6 old was: $dns_ip"
   fi
 
   if [[ "$remote_ip" == "$dns_ip" ]]; then
@@ -426,69 +686,78 @@ function ipHasChanged() {
   fi
 }
 
-###############
-## arguments ##
-###############
+################
+## parameters ##
+################
 
-ARGS=
-if [[ $_has_getopt == "" ]] && [[ $(uname) == Linux ]]; then
-  ARGS=$(getopt --options "hvi:,d:,m:,s:,u:,p:,t:" --longoptions "help,version,link,ip-mode:,domain:,update-method:,service-provider:,username:,password:,token:,reset" -- "$@");
-fi
-eval set -- "$ARGS";
-unset ARGS
+function handleParameters() {
+  if [[ $_arg_version == "on" ]]; then
+    echo $_version
+    exit 0
+  fi
+  if [[ $_arg_link == "on" ]]; then
+    ln --verbose --symbolic "$(realpath "$0")" "$HOME/.local/bin/dynb"
+    exit 0
+  fi
+  if [[ $_arg_reset == "on" ]]; then
+    rm --verbose "$_statusFile"
+    exit 0
+  fi
+    if [[ $_arg_debug == "on" ]]; then
+    _debug=1
+  fi
+  if [[ $_arg_update_method != "" ]]; then
+    DYNB_UPDATE_METHOD=$_arg_update_method
+  fi
+  if [[ $_arg_ip_mode != "" ]]; then
+    DYNB_IP_MODE=$_arg_ip_mode
+  fi
+  if [[ $_arg_domain != "" ]]; then
+    DYNB_DYN_DOMAIN=$_arg_domain
+  fi
+  if [[ $_arg_service_provider != "" ]]; then
+    DYNB_SERVICE_PROVIDER=$_arg_service_provider
+  fi
+  if [[ $_arg_username != "" ]]; then
+    DYNB_USERNAME=$_arg_username
+  fi
+  if [[ $_arg_password != "" ]]; then
+    DYNB_PASSWORD=$_arg_password
+  fi
+  if [[ $_arg_token != "" ]]; then
+    DYNB_TOKEN=$_arg_token
+  fi
+  if [[ $_arg_interval != "" ]]; then
+    DYNB_INTERVAL=$_arg_interval
+  fi
 
-function processParameters() {
-  while true; do
-    case $1 in
-      -h | --help )
-        echo "$_help_message"
-        exit 0
-        ;;
-      -v | --version )
-        echo "$_version"
-        exit 0
-        ;;
-      --link )
-        ln --verbose --symbolic "$(realpath "$0")" "$HOME/.local/bin/dynb"
-        exit 0
-        ;;
-      -i | --ip-mode )
-        _ip_mode=$2
-        shift 2
-        ;;
-      -d | --domain )
-        _dyn_domain=$2
-        shift 2
-        ;;
-      -m | --update-method )
-        _update_method=$2
-        shift 2
-        ;;
-      -s | --service-provider )
-        _serviceProvider=$2
-        shift 2
-        ;;
-      -u | --username )
-        _username=$2
-        shift 2
-        ;;
-      -p | --password )
-        _password=$2
-        shift 2
-        ;;
-      -t | --token )
-        _token=$2
-        shift 2
-        ;;
-      --reset )
-        rm --verbose "$_statusFile"
-        exit 0
-        ;;
-      --)
-        shift
-        break
-    esac
-  done
+  if [[ -z $DYNB_INTERVAL ]]; then
+    _loopMode=0
+  elif [[ $DYNB_INTERVAL -lt _minimum_looptime ]]; then
+    DYNB_INTERVAL=$_minimum_looptime
+    _loopMode=1
+  else
+    _loopMode=1
+  fi
+    if [[ $_network_interface != "" ]]; then
+    _interface_str="--interface $_network_interface"
+  fi
+
+  if [[ $DYNB_IP_MODE == d* ]]; then
+    _is_IPv4_enabled=true
+    _is_IPv6_enabled=true
+  fi
+  if [[ $DYNB_IP_MODE == *4* ]]; then
+    _is_IPv4_enabled=true
+  fi
+  if [[ $DYNB_IP_MODE == *6* ]]; then
+    _is_IPv6_enabled=true
+  fi
+
+  if [[ $DYNB_DEBUG == true ]]; then
+    _debug=1
+  fi
+  return 0
 }
 
 ##################
@@ -504,26 +773,22 @@ function checkDependencies() {
   #   fi
   # done
   [[ -x $(command -v jq 2> /dev/null) ]] || {
-    if [[ $_update_method != dyndns* ]]; then
+    if [[ $DYNB_UPDATE_METHOD != dyndns* ]]; then
       echo "This script depends on jq and it is not available." >&2
       exit 1
     fi
   }
-  # maybe replace this with matejak/argbash
-  [[ -x $(command -v getopt 2> /dev/null) ]] || {
-    _has_getopt=false
-  }
 }
 
 function doUnsets() {
   unset _network_interface
   unset _DNS_checkServer
   unset _dns_records
-  unset _dyn_domain
+  unset DYNB_DYN_DOMAIN
   unset _has_getopt
   unset _help_message
   unset _INWX_JSON_API_URL
-  unset _ip_mode
+  unset DYNB_IP_MODE
   unset _ipv4_checker
   unset _ipv6_checker
   unset _is_IPv4_enabled
@@ -531,12 +796,62 @@ function doUnsets() {
   unset _main_domain
   unset _new_IPv4
   unset _new_IPv6
-  unset _password
-  unset _username
-  unset _serviceProvider
+  unset DYNB_PASSWORD
+  unset DYNB_USERNAME
+  unset DYNB_SERVICE_PROVIDER
   unset _version
 }
 
+function doUpdates() {
+  if [[ $DYNB_UPDATE_METHOD == "domrobot" ]]; then
+    getMainDomain
+    fetchDNSRecords
+    if [[ $_is_IPv4_enabled == true ]]; then
+      ipHasChanged 4
+      if [[ $? == 1 ]]; then
+        updateRecord 4
+      else
+        debugMessage "Skip IPv4 record update, it is already up to date"
+      fi
+    fi
+    if [[ $_is_IPv6_enabled == true ]]; then
+      ipHasChanged 6
+      if [[ $? == 1 ]]; then
+        updateRecord 6
+      else
+        debugMessage "Skip IPv6 record update, it is already up to date"
+      fi
+    fi
+  fi
+
+  if [[ $DYNB_UPDATE_METHOD == "dyndns" ]]; then
+    changed=0
+    if [[ $_is_IPv4_enabled == true ]]; then
+      ipHasChanged 4
+      (( changed += $? ))
+    fi
+    if [[ $_is_IPv6_enabled == true ]]; then
+      ipHasChanged 6
+      (( changed += $? ))
+    fi
+    if [[ $changed -gt 0 ]]; then
+      if checkStatus; then
+        debugMessage "checkStatus has no errors, try update"
+        if dynupdate; then
+          debugMessage "DynDNS2 update success"
+        else
+          debugMessage "Save new status after dynupdate has failed"
+          setStatus "$_response" "$(date +%s)" $(( _errorCounter += 1 )) "$DYNB_DYN_DOMAIN" "${DYNB_USERNAME}" "${DYNB_PASSWORD}${DYNB_TOKEN}"
+        fi
+      else
+        debugMessage "Skip DynDNS2 update, checkStatus fetched previous error."
+      fi
+    else
+      debugMessage "Skip DynDNS2 update, IPs are up to date"
+    fi
+  fi
+}
+
 #################
 ## MAIN method ##
 #################
@@ -561,68 +876,21 @@ function dynb() {
     source "$_statusFile"
   fi
 
-  if [[ $_has_getopt == "" ]] && [[ $(uname) == Linux ]]; then
-    processParameters "$@"
-  fi
-
-  if [[ $_network_interface != "" ]]; then
-    _interface_str="--interface $_network_interface"
-  fi
-
-  if [[ $_ip_mode == d* ]]; then
-    _is_IPv4_enabled=true
-    _is_IPv6_enabled=true
-  fi
-  if [[ $_ip_mode == *4* ]]; then
-    _is_IPv4_enabled=true
-  fi
-  if [[ $_ip_mode == *6* ]]; then
-    _is_IPv6_enabled=true
-  fi
+  handleParameters
 
   ## execute operations
 
-  if [[ $_update_method == "domrobot" ]]; then
-    getMainDomain
-    fetchDNSRecords
-    if [[ $_is_IPv4_enabled == true ]]; then
-      ipHasChanged 4
-      if [[ $? == 1 ]]; then
-        updateRecord 4
-      fi
-    fi
-    if [[ $_is_IPv6_enabled == true ]]; then
-      ipHasChanged 6
-      if [[ $? == 1 ]]; then
-        updateRecord 6
-      fi
-    fi
+
+  if loopMode; then
+    while checkStatus
+    do
+      doUpdates
+      sleep $DYNB_INTERVAL
+    done
+  else
+    doUpdates
   fi
 
-  if [[ $_update_method == "dyndns" ]]; then
-    changed=0
-    if [[ $_is_IPv4_enabled == true ]]; then
-      ipHasChanged 4
-      (( changed += $? ))
-    fi
-    if [[ $_is_IPv6_enabled == true ]]; then
-      ipHasChanged 6
-      (( changed += $? ))
-    fi
-    if [[ $changed -gt 0 ]]; then
-      if checkStatus; then
-        debugMessage "checkStatus has no errors"
-        if dynupdate; then
-          debugMessage "DynDNS2 update success"
-        else
-          debugMessage "Save new status after dynupdate has failed"
-          setStatus "$_response" "$(date +%s)" $(( _errorCounter += 1 )) "$_dyn_domain" "${_username}${_token}"
-        fi
-      else
-        debugMessage "Skip DynDNS2 update, checkStatus fetched previous error."
-      fi
-    fi
-  fi
   doUnsets
   return 0
 }
@@ -632,3 +900,5 @@ function dynb() {
 
   dynb "${@}"
   exit $?
+
+# ] <-- needed because of Argbash

example.env

@@ -1,7 +1,21 @@
-_dyn_domain=dyndns.example.com
-_serviceProvider=inwx
-_update_method=domrobot
-_ip_mode=dual
-_username=User42
-_password=SuperSecretPassword
-_token=
+###################
+## Configuration ##
+###################
+
+DYNB_DYN_DOMAIN=dyndns.example.com
+
+## service provider could be deSEC, duckdns, dynv6, inwx
+DYNB_SERVICE_PROVIDER=inwx
+
+## update method options: domrobot, dyndns
+DYNB_UPDATE_METHOD=domrobot
+
+## ip mode could be either: 4, 6 or dual for dualstack
+DYNB_IP_MODE=64
+
+## If you are using the DomRobot RPC-API enter your credentials for the web interface login here
+## If you are using the DynDNS2 protocol enter your credentials here
+DYNB_USERNAME=User42
+DYNB_PASSWORD=SuperSecretPassword
+## or use a token
+DYNB_TOKEN=

man/dynb.1

@@ -0,0 +1,114 @@
+.\" Man page generated from reStructuredText.
+.
+.TH MAN 1 "2021-04-21" "" ""
+.SH NAME
+man \- DynB - dynamic DNS update script for bash
+.
+.nr rst2man-indent-level 0
+.
+.de1 rstReportMargin
+\\$1 \\n[an-margin]
+level \\n[rst2man-indent-level]
+level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
+-
+\\n[rst2man-indent0]
+\\n[rst2man-indent1]
+\\n[rst2man-indent2]
+..
+.de1 INDENT
+.\" .rstReportMargin pre:
+. RS \\$1
+. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
+. nr rst2man-indent-level +1
+.\" .rstReportMargin post:
+..
+.de UNINDENT
+. RE
+.\" indent \\n[an-margin]
+.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.nr rst2man-indent-level -1
+.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
+..
+.SH SYNOPSIS
+.sp
+\fBman  [\-\-version] [\-\-link] [\-\-reset] [\-\-debug] [\-\-update\-method UPDATE\-METHOD] [\-\-ip\-mode IP\-MODE] [\-\-domain DOMAIN] [\-\-service\-provider SERVICE\-PROVIDER] [\-\-username USERNAME] [\-\-password PASSWORD] [\-\-token TOKEN] [\-\-interval INTERVAL] [\-\-help]\fP
+.SH DESCRIPTION
+.sp
+IPv4 (A) and IPv6 (AAAA) record updates are supported.
+.SH ARGUMENTS
+.INDENT 0.0
+.TP
+.B \-v\fP,\fB  \-\-version
+outputs the client version.
+[Default: off]
+.sp
+
+.TP
+.B \-l\fP,\fB  \-\-link
+links to your script at ~/.local/bin/dynb.
+[Default: off]
+.sp
+
+.TP
+.B \-r\fP,\fB  \-\-reset
+deletes the client blocking status file.
+[Default: off]
+.sp
+
+.TP
+.B \-\-debug
+enables debug mode.
+[Default: off]
+.sp
+
+.TP
+.BI \-m \ UPDATE\-METHOD\fR,\fB \ \-\-update\-method \ UPDATE\-METHOD
+choose if you want to use DynDNS2 or the DomRobot RPC\-API.
+.sp
+dyndns | domrobot
+.TP
+.BI \-i \ IP\-MODE\fR,\fB \ \-\-ip\-mode \ IP\-MODE
+updates type A (IPv4) and AAAA (IPv6) records.
+.sp
+4 | 6 | dual
+.TP
+.BI \-d \ DOMAIN\fR,\fB \ \-\-domain \ DOMAIN
+set the domain you want to update.
+.sp
+dyndns.example.com
+.TP
+.BI \-s \ SERVICE\-PROVIDER\fR,\fB \ \-\-service\-provider \ SERVICE\-PROVIDER
+set your provider in case you are using DynDNS2.
+.sp
+deSEC | duckdns | dynv6 | inwx
+.TP
+.BI \-u \ USERNAME\fR,\fB \ \-\-username \ USERNAME
+depends on your selected update method and your provider.
+.sp
+e.g. user42
+.TP
+.BI \-p \ PASSWORD\fR,\fB \ \-\-password \ PASSWORD
+depends on your selected update method and your provider.
+.sp
+e.g. SuperSecretPassword
+.TP
+.BI \-t \ TOKEN\fR,\fB \ \-\-token \ TOKEN
+depends on your selected update method and your provider.
+.sp
+YourProviderGivenToken
+.TP
+.BI \-\-interval \ INTERVAL
+choose the seconds interval to run the script in a loop, minimum is 60.
+.sp
+
+.TP
+.B \-h\fP,\fB  \-\-help
+Prints help.
+.sp
+
+.UNINDENT
+.SH AUTHOR
+Eduard Veit
+.\" Generated by docutils manpage writer.
+.

man/man-defs.rst

@@ -0,0 +1,35 @@
+
+.. |AUTHOR| replace:: Eduard Veit
+
+.. |VERSION| replace:: \
+
+.. |MAN_SECTION| replace:: 1
+
+.. |DESCRIPTION| replace::
+   IPv4 (A) and IPv6 (AAAA) record updates are supported.
+
+.. |OPTION_VERSION| replace:: \
+
+.. |OPTION_LINK| replace:: \
+
+.. |OPTION_RESET| replace:: \
+
+.. |OPTION_DEBUG| replace:: \
+
+.. |OPTION_UPDATE_METHOD| replace:: dyndns | domrobot
+
+.. |OPTION_IP_MODE| replace:: 4 | 6 | dual
+
+.. |OPTION_DOMAIN| replace:: dyndns.example.com
+
+.. |OPTION_SERVICE_PROVIDER| replace:: deSEC | duckdns | dynv6 | inwx
+
+.. |OPTION_USERNAME| replace:: e.g. user42
+
+.. |OPTION_PASSWORD| replace:: e.g. SuperSecretPassword
+
+.. |OPTION_TOKEN| replace:: YourProviderGivenToken
+
+.. |OPTION_INTERVAL| replace:: \
+
+.. |OPTION_HELP| replace:: \

man/man.rst

@@ -0,0 +1,88 @@
+
+.. include:: man-defs.rst
+
+
+===
+man
+===
+
+-----------------------------------------
+DynB - dynamic DNS update script for bash
+-----------------------------------------
+
+:Author: |AUTHOR|
+:Date:   2021-04-21
+:Version: |VERSION|
+:Manual section: |MAN_SECTION|
+
+
+SYNOPSIS
+========
+
+``man  [--version] [--link] [--reset] [--debug] [--update-method UPDATE-METHOD] [--ip-mode IP-MODE] [--domain DOMAIN] [--service-provider SERVICE-PROVIDER] [--username USERNAME] [--password PASSWORD] [--token TOKEN] [--interval INTERVAL] [--help]``
+
+
+DESCRIPTION
+===========
+
+|DESCRIPTION|
+
+
+ARGUMENTS
+=========
+
+-v, --version                                             outputs the client version.
+                                                          [Default: off]
+
+                                                          |OPTION_VERSION|
+
+-l, --link                                                links to your script at ~/.local/bin/dynb.
+                                                          [Default: off]
+
+                                                          |OPTION_LINK|
+
+-r, --reset                                               deletes the client blocking status file.
+                                                          [Default: off]
+
+                                                          |OPTION_RESET|
+
+--debug                                                   enables debug mode.
+                                                          [Default: off]
+
+                                                          |OPTION_DEBUG|
+
+-m UPDATE-METHOD, --update-method UPDATE-METHOD           choose if you want to use DynDNS2 or the DomRobot RPC-API.
+
+                                                          |OPTION_UPDATE_METHOD|
+
+-i IP-MODE, --ip-mode IP-MODE                             updates type A (IPv4) and AAAA (IPv6) records.
+
+                                                          |OPTION_IP_MODE|
+
+-d DOMAIN, --domain DOMAIN                                set the domain you want to update.
+
+                                                          |OPTION_DOMAIN|
+
+-s SERVICE-PROVIDER, --service-provider SERVICE-PROVIDER  set your provider in case you are using DynDNS2.
+
+                                                          |OPTION_SERVICE_PROVIDER|
+
+-u USERNAME, --username USERNAME                          depends on your selected update method and your provider.
+
+                                                          |OPTION_USERNAME|
+
+-p PASSWORD, --password PASSWORD                          depends on your selected update method and your provider.
+
+                                                          |OPTION_PASSWORD|
+
+-t TOKEN, --token TOKEN                                   depends on your selected update method and your provider.
+
+                                                          |OPTION_TOKEN|
+
+--interval INTERVAL                                       choose the seconds interval to run the script in a loop, minimum is 60.
+
+                                                          |OPTION_INTERVAL|
+
+-h, --help                                                Prints help.
+
+                                                          |OPTION_HELP|