Installation

Tara can be installed in 2 simple steps:

1. Install executable

If your desired platform isn't seen below, please open an issue.

2. Configure

Before the bot can be started successfully, it needs to be configured. Tara has an interactive setup subcommand, tara config init.

$ tara config init --help
tara-config-init 0.2.0
Create configuration files with a user-provided configuration

USAGE:
    tara config init

FLAGS:
    -h, --help    Prints help information

tara config init will create a configuration file in the appropriate location. If this needs to be modified it can be. The file's content's should be the same regardless of operating system, but the location in the file system will be different.

The configuration file should look similarly to below:

randomErrorMessage = false

[secrets]
# Discord bot token
token = "<DISCORD_TOKEN>"

# API key from currencyapi.com.
currencyApiKey = "<CURRENCYAPI.COM>" # Optional

All accepted keys:

• randomErrorMessage - This key allows for error messages to be selected randomly from a set loaded from a JSON document. If setting this key to true, it will look in the default locations for a error_messages.json file. If enabled and the file cannot be parsed (because it doesn't exist or is invalid), Tara will continue with the default error messages. Another choice is to set this to the path of the error messages file. A value of false will use a singular, static error message.

  The default location for the error messages file is system dependant.

  Linux

  Tara will look in these locations for an existing file.

  1. $XDG_CONFIG_HOME/Tara/error_messages.json or $HOME/.config/Tara/error_messages.json
  2. /etc/tara.d/error_messages.json

  macOS

  Tara will look here for an existing file: $HOME/Library/Application Support/com.github.El-Wumbus.Tara/error_messages.json

• direct_message_cooldown - This optional key is to set the minimum duration, in seconds, to allow between running commands in a direct message. The default is 3.

• secrets.token - The discord token can be aquired according to Building your first Discord app.

• secrets.currencyApiKey - The currencyApiKey is an optional key to enable the currency conversion feature. This can be aquired from currencyapi.com. The feature will, at most, refresh every six hours. This means the feature will never need a paid API key.

Using

Running

To start Tara, use the tara daemon command. If no errors or warnings occur, Tara's stdout and stderr will be blank. If Tara has a proper Discord token, then it's ready to use.

$ tara daemon --help
tara-daemon 0.2.0
Start Tara

USAGE:
    tara daemon [OPTIONS]

FLAGS:
    -h, --help    Prints help information

OPTIONS:
        --config <config>    Specify a configuration file to use instead of the default

Discord Commands