This program is meant to automatically update a team’s twitter feed during competition with match scores and seeding (approximate as I’ll explain in known bugs). My team last year always forgot to update ours so I’ve decided to solve the problem. It does this by means of reading the twitter feed released by the FMS, tabulating scores and updating a team’s twitter feed whenever they play a match. This software is still in BETA, it is not guaranteed to work and I’ve not had time yet to test all the features (Particularly the elimination matches).
Usage information:
Tweet format -
**Qualification **
winning- ‘We won match#(MatchNumber) (yourScore) to (oppScore) and we are seed #(seed)’
losing - ‘We lost match #…’
tie - ‘We tied match #(MatchNumber) with a score of (yourScore) and we are seed #(seed)’
Elimination
winning- ‘We won (level)(MatchNumber) (yourScore) to (oppScore) and we are up/down (your/oppWin):(your/oppWin)’
losing- ‘We lost …’
tie- ‘We tied** (level)(MatchNumber) **with a score of (yourScore) and we are up/down (your/oppWin):(your/oppWin)’
If you move on to the next stage the last part (after the score) will be replaced with ‘we are moving on to the semi-finals/finals’
If you lose the event the last part will be replaced with ‘and we are out of the elimination’
level - is the stage of the elimination e.g QF,SF,F
MatchNumber- your match number, this disregards the match number assigned by the event.
Installation guide:
-
Install the tweepy python library to your python installation(found at GitHub - tweepy/tweepy: Twitter for Python!)
-
The teamlist.txt file needs to contain a list of all the teams participating in the event. each team in a new line.
2.the settings file needs to be filled as follows.
a.myTeam = your team number
b.eventCode = the code for your event check in the FIRST twitter documentation
c.winningMessage = what to post in case you win the regional
d-g. this needs to be filled by the settings found in https://dev.twitter.com/apps .
you need to register a new app and fill in the needed information.
IMPORTANT
1.Change the application permissions to read&write
2.generate a token only after you change the permissions or else it won’t work.
h.accountToFollow = this is meant for testing. If you want to try the program with a different twitter account than the FMS’s. For the competition this should be set to FRCFMS
RUNNING THE PROGRAM
The program has to be run for the duration of the competition. Shutting it down will make it lose the data.
Program should be run after the start of the qualification matches. Otherwise it will also tabulate practice match results
KNOWN BUGS
0. If you find any bugs please report them to me and I’ll try to fix them
1.The seeding does not 100% reflect FRC seedings. The last tie breaker in seeding in first events is a coinflip by the FMS. Since I can’t replicate the FMS result I also do a random coinflip and seed by that. This means that in a few cases the seedings will be incorrect. In my experience however I don’t remember an instance where after the first 2-3 rounds there was ever an occurance of that.
LAST THINGS
The program is released with the source code and is completely open source. You can freely redistribute the program just please give me credit.
CREDITS
I’m using the tweepy twitter library which is released under the following license:
I hope you enjoy using the program.
~Yotam Kenneth
4406 Mentor
2212 Alumni
FRCTwit.zip (7.38 KB)
FRCTwit.zip (7.38 KB)