Configuration

Configuring Tweial is not that difficult. This page documents everything you need to do.

JRE

Tweial requires Java 8+. The Windows and Linux downloads come embedded with a Java 8 JRE, so Tweial does not depend on the system-level JRE to run.

However, if you want to override the JRE which comes embedded with Tweial, you can do so by editing, in the [TWEIAL_HOME]/bin/ directory, the start-tweial.sh, start-tweial.bat files.

Logging

See the Logging page for more information about configuring logging.

SMTP Account

Tweial needs the SMTP information for your email provider. Each email provider is different so how you get this information is up to you.

In the [TWEIAL_HOME]/conf/ directory, make a copy of email(example).properties as email.properties. Edit email.properties, adding your SMTP account details.

# 
# This file holds the information needed to access your email account.
# you should rename this file "email.properties" in order to get
# Tweial to find it.  If the "email.properties" file is not found when
# Tweial starts, the application will print an error message and exit.
#

# @SINCE 1.0.0.0
#  Value is either "true" or "false:
#  If "true" an SSL connection is used to connect to the SMTP server
#  If "false" an UN-ENCRYPTED connection is used to connect to the SMTP server
#
# @SINCE 1.1.6.0
#  Value is either "true" or "false:
#  If "true" an SSL connection is used to connect to the SMTP server
#  If "false" a TLS connection is used to connect to the SMTP server.
#
sslEnabled=true || false

# This is the name of the SMTP host machine.
host=smtp.somewhere.org

# This is the port number of the SMTP host machine.
# The same host may support both SSL and TLS but on
# different ports. So make sure your port number here
# matches with the 'sslEnabled' configuration above.
port=44

# This is what you use in the “username” field when
# you login. Typically this is the same as your email
# address, but this isn't always the case.
username=account

# This is what you use in the “password” field when
# you login. This value is CLEAR TEXT, so keep this
# properties file safe.
password=password

# This is the email address you want for the
# email's FROM field. Enter the value using
# the format shown below. Typically this is
# the email address for the account.
# WARNING: If you make this an email address other
# than the one for the account, the email may
# be immediately flagged as SPAM.
emailAddress=FIRSTNAME LASTNAME <ADDRESS@EMAIL.COM>

# This is the email address you want for the
# email's TO field. Enter the value using
# the format shown below.  For testing, it's a good 
# idea to send it to yourself first.
sendToAddress=FIRSTNAME LASTNAME <ADDRESS@EMAIL.COM>

Twitter Account

Tweial uses the Twitter4J libraries to communicate with Twitter. In order for this communication to be successful, you need to add Tweial as an authorized application on your account.

NOTE:
Refer to my blogger article on how to authorize Tweial with your Twitter account.

After you have added Tweial as an authorized applicaiton on your Twitter account, in the [TWEIAL_HOME]/conf/ directory, make a copy of twitter(example).properties as twitter.properties. Edit twitter.properties, adding the OAUTH details.

oAuthConsumerKey=ABC
oAuthConsumerSecret=ABC
oAuthAccessToken=ABC
oAuthAccessTokenSecret=ABC

Configuration complete! Next is preferences.