Developed by Robin Karlsson

contact: r.robin.karlsson@gmail.com

http://www.chess.com/members/view/SudoRoot

How to run the script through the terminal/command prompt

start by typing "cd PathToScriptFolder" to navigate to the folder containing the script. We're now ready for step two which launches the script :))

Source Version:

type "python RKResource001.py", press enter and the script will start

Executable version:

type "RKResource001.exe", press enter and the script will start

If for some reason it crashes during the startup, or at any other point for that matter, you will now get an error msg in the terminal, this crash can most likely easily be fixed if you follow a few easy steps.

Start by copying the error msg (and maybe take a few screenshots if relevant) and either send it to SudoRoot in a pm or, this is the prefered method as it will make it easier for coming script users who run into the same problem, post it to the troubleshooting forum (with a short, or long, explanation of the problem)!

Install Instructions

Windows users can download a prepacked, executable version of the script from: https://www.dropbox.com/s/6rd474qlqa73vvd/RK%20Resource%20001%2C%20exe%20version.zip?dl=1

And can thus skip step 1 - 2 in the instructions below

*** binary Dependencies for executable version ***

OLEAUT32.dll, C:\Windows\system32\OLEAUT32.dll
USER32.dll, C:\Windows\system32\USER32.dll
SHELL32.dll, C:\Windows\system32\SHELL32.dll
KERNEL32.dll, C:\Windows\system32\KERNEL32.dll
ADVAPI32.dll, C:\Windows\system32\ADVAPI32.dll
WS2_32.dll, C:\Windows\system32\WS2_32.dll
GDI32.dll, C:\Windows\system32\GDI32.dll
VERSION.dll, C:\Windows\system32\VERSION.dll
ole32.dll, C:\Windows\system32\ole32.dll

Requirements (source version only, exe version comes prepacked with the libraries)

Python 2.7
Libraries: Mechanize, BeautifulSoup4, Selenium

Instructions

Step 1.

download and install python 2.7, https://www.python.org/download/releases/2.7.7/

Step 2.

Step 3. A few functions in the script requires a webdriver to function properly. The firefox driver comes with the selenium library so if you have firefox installed you're good to go. If you prefer chrome over firefox you can download a chromedriver (only necessary if the included one for some reason wont work!!!) from http://chromedriver.storage.googleapis.com/index.html . Place the webdriver(s) in the folder /Data/Webdriver/YOUR_OS/86

Step 4. run the script again and you should be good to go ;))

ps. don't forget to update regularly

Miscellaneous

After adding a new group for which you wish to do invites you must create an invites message! Go to the folder /Data/Messages/Invite Messages. There should now be two files called "{Group Name} Standard message" and "{Group Name} Deserter message".

The Standard message will be used for members from your standard and priority invites lists, while the deserter message will be used for members from the invites list of members who has left (to find members who has left your group use option 9 in the script, if you use the same name when adding a new group for 9 as you did for the inviter members who has left your group will be automatically added to the invites list of members who has left).

The text can include newlines, references to the members nation and name given on their profile through the commands:

/name = gets replaced with the name given on members profile, username if no name is given.
/firstname = gets replaced with the firstname given on members profile, username if no name is given.
/nation = gets replaced with the members nation of origin (by modifying the file "/.Config/Invites/{Group Name}.ini" you can chooce what to use if member nation is international, plus set a few filters that will be used by the invites)
/newline = newline... do NOT add a newline by enter unless you're done with the current section!!! use the /newline command

Options

1) Creates a list of members from one or more groups. Has the option to remove those who're also members of a specific group (using the members list built in option 9). The list can either be saved to a file or be directly printed onscreen

2) Build an excell compatible csv file with the following data on a list of members.

Column 1: Username
Column 2: Real name (if available on members homepage)
Column 3. Live Standard rating
Column 4. Live Blitz rating
Column 5. Live Bullet rating
Column 6. Online Chess rating
Column 7. 960 rating
Column 8. Tactics rating
Column 9. Timeout-ratio
Column 10. Last online
Column 11. Member since
Column 12. Time per move
Column 13. Number of groups member is in
Column 14. Points
Column 15. Number of online chess games played
Column 16. Number of online chess games won
Column 17. Number of online chess games lost
Column 18. Number of Online chess games drawn
Column 19. Win ratio for online chess
Column 20. Member nation (if available on members homepage)
Column 21. If member has a custom avatar
Column 22. Number of site awards
Column 23. Number of tournament trophies
Column 24. Number of game trophies
Column 25. Number of fun trophies

This data can be presented and sorted using option 7 in the main script

3) Send personalized invites for one or more groups. The invites can include text (with member name and nation, to personalize the message), pictures and videos.

4) Goes through a groups finished, non thematic votechess matches and counts number of posts per member

5) Build an excell compatible csv file with the following data on how each member who has ever played for a group has performed in the groups team matches

Column 1. Username
Column 2. Number of team matches member has participated in
Column 3. Points won
Column 4. Points lost
Column 5. Ongoing games
Column 6. Timeouts
Column 7. Win ratio

6) Takes a comma seperated list of members and sort out those who doesn't fill a few criterias regarding:

Min online chess rating
Max online chess rating
Min 960 chess rating
Max 960 chess rating
Last online
Member Since
Older than (if birthdate is available on members profile)
Younger than (if birthdate is available on members profile)
Min number of groups member may be in
Max number of groups member may be in
Min number of social points
Max Timeout-ratio
Min Timeout-ratio
Time per move
If they have a custom avatar
Gender

7) Presentation of csv files from option 2 and 5. Can present data from the csv files sorted by any column, compare two csv files from option 5 to see what has changed or return the username of each member in the file and present it as a comma seperated list

8) Send personalized notes to either a comma seperated list of members or those who are present in a set of pages. The note can include text with the members real name (or username) and nation.

9) At first run the script builds a list of members who are currently in your group.

At future runs the script will build a new memberslist of your group, look for members who are in the memberslist compiled during the last run but not in the latest run.

Removes those who has had their accounts closed or changed their names and print the result, which is the members who has left your group in the timeperiod between two runs

10) Count number of group notes per member in the last 100 notes pages

11) Takes a comma seperated list of members and builds a sorted birthday schedule of those who have their birthday visible on their profile

12) Send personalized personal messages to either a comma seperated list of members or those who are present in a set of pages. The message can include text (with the members real name and nation, to personalize the message) and images

13) Takes either one or two list of members and offer to pair them against each others based on rating.

If given one lists members will be paired against each other after the format, highest ranked vs second highest rank etc. For two lists the script takes each member in the shorter list and pair this member against whoever has the most similar rating in the longer list

Ratings can be Live Standard, Live Blitz, Live Bullet, Online chess, 960 or tactics

14) Perform set operations on two lists (union, intersection, difference, symmetric difference)

15) Count number of wins, losses and draws per opponent in a teams team match archive

16) Delete all group notes in a group

17) Accept open challenges

18) Get the 1000 latest team matches on cc sorted by size

19) Check groups for new timeouts

20) Post precofigured group notes

21) Send tm challenges to a group

22) Check network strength

23) Attempt to automatically fix various problems with invites lists and messages

Group Dynamics

Super Admins