This is basically a fork of ConsoleTweet, but designed specifically for Heroku, since its purpose is to tweet "Good Morning!" everyday (no longer active.)
AutoTweet is a Java-based program that integrates with Twitter to send tweets. Since this program was made with Heroku usage in mind, it runs on environment variables, a.k.a. config vars. It can be used on a computer nonetheless, but requires an extra argument.
AutoTweet uses yusuke's Twitter4J library in order to send requests to the Twitter API
To use this program, you need a server, a Twitter account ready for the Developer API (has a phone number included) and common sense.
Before running, create a Twitter App and create an Access Token for it. Afterwards, set your Heroku Config Vars (or System Environment Variables for Windows) for the following:
| Key | Value |
|---|---|
| TWITTER-CONSUMER_KEY | The consumer key of your Twitter app |
| TWITTER-CONSUMER_SECRET | The consumer secret of your Twitter app |
| TWITTER-ACCESS_TOKEN | The access token of your Twitter account for the app |
| TWITTER-ACCESS_TOKEN_SECRET | The access token secret of your Twitter account for the app |
| TIMEZONE | The number of hours to add or subtract from UTC or wherever the server's timezone is. (If server is UTC, and you need PST, set this to -8) |
To run the program on your local server without using environment variables, add --normal as the last argument and create a file in the same folder named "AutoTweet.cfg"
You then need to dedicate one line each for the following
1 | The consumer key of your Twitter app 2 | The consumer secret of your Twitter app 3 | The access token of your Twitter account for the app 4 | The access token secret of your Twitter account for the app
If you have trailing lines, the program will err.
If you would like the bot to run in a different timezone, you may also set the TIMEZONE environment variable. There is no support for timezones in the configuration file.
AutoTweet works by taking fed arguments and turning it into a tweet, like so:
java -jar at-latest.jar "Testing Tweet"
ConsoleTweet also contains a syntax that automatically replaces reserved words to add more functionality and automation to your automatic tweets
NOTE: Objects in (parentheses) are not part of the output
| Syntax | Function | Example |
|---|---|---|
| --datetime-- | month/day/year hour:minute meridian | 11/11/2011 11:11 PM |
| --date-- | month/day/year | 11/11/2011 |
| --time-- | hour:minute meridian | 11:11 PM |
| --24datetime-- | month/day/year 24hour:minute | 11/11/2011 23:11 |
| --24time-- | 24hour:minute | 23:11 |
| --24datetimes-- | month/day/year 24hour:minute:second | 11/11/2011 23:11:11 |
| --24times-- | 24hour:minute:second | 23:11:11 |
| --datetimes-- | month/day/year hour:minute:second meridian | 11/11/2011 11:11:11 PM |
| --times-- | hour:minute:second meridian | 11:11:11 PM |
| --dydatetime-- | Day month/day/year hour:minute meridian | Fri 11/11/2011 11:11 PM |
| --dydate-- | Day month/day/year | Fri 11/11/2011 |
| --dy24datetime-- | Day month/day/year 24hour:minute | Fri 11/11/2011 23:11 |
| --dydatetimes-- | Day month/day/year hour:minute:second meridian | Fri 11/11/2011 11:11:11 PM |
| --dy24datetimes-- | Day month/day/year 24hour:minute:second | Fri 11/11/2011 23:11:11 |
| Syntax | Function | Example |
|---|---|---|
| --username-- | User's username | ChlodAlejandro |
| --usermade-- | User creation date | Mon 02/20/2012 08:15:16 PM |
| --displayname-- | User's set display name | Chlod Alejandro (as of 12/19/2017 23:19) |
| --usertz-- | User's timezone | Beijing (despite living in the PH) |
| --userdesc-- | User's description (bio) | student, programmer, dad of @MentionChlod, SU fan, space fan. follow for too much tweets, retweets and likes. dm me if you need someone to talk to. (as of 12/19/2017 23:19) |
| --userid-- | User's Twitter ID | 497834217 |
| --userloc-- | User's set location | 32 Twitter Drive, Internet (example only) |
| --userlang-- | User's preffered language | en (English) |
| --userpcolor-- | User's profile color (deprecated) | 000000 |
| Syntax | Function | Example |
|---|---|---|
| --followers-- | User's follower count | 202 (as of 12/19/2017 23:19) |
| --following-- | User's friend (following) count | 376 (as of 12/19/2017 23:19) |
| --tweetcount-- | User's tweet count | 5235 (as of 12/19/2017 23:19) |
| --favorites-- | User's like count | 4165 (as of 12/19/2017 23:19) |
| --lists-- | Count of lists user is included in | 1 (as of 12/19/2017 23:19) |
| Syntax | Function | Example |
|---|---|---|
| --userlink-- | User's set link | <bit.ly/chloda> (as of 12/19/2017 23:19) |
| --userprofile-- | User's profile link | https://twitter.com/ChlodAlejandro |
| --userdp-- | User's display picture link | https://pbs.twimg.com/profile_images/934421851467431936/FeNLfUL5.jpg (as of 12/19/2017 23:19) |
| --userbanner-- | User's banner link | https://pbs.twimg.com/profile_banners/497834217/1511420159/web (as of 12/19/2017 23:19) |
THE PROGRAM IS IN PRE-ALPHA. IT IS BOUND TO BREAK.
THE USER IS LIABLE FOR DAMAGE TO THEIR ACCOUNT IF THEIR ACCESS TOKEN OR ACCESS TOKEN SECRET ARE EXPOSED TO ANYONE BUT THEMSELVES OR TWITTER. THE CREATOR OR THE PROGRAM SHALL NOT RECIEVE ANY CHARGES. A BETTER SYSTEM FOR STORING CONFIGURATIONS IS UPCOMING.
- Integrate more syntax rules
- Singular time syntax (--hour--, --minute--, --second--)
- Create a better time syntax
- Planning on 'insert tweet here by --username-- at date("dateformat")'
- Patch up all bugs
- Fix loopholes
- Create much more secure way of storing keys