Mehmet Emre Doğan



Chirping Bird 2021S

Step 0: Read and agree the following manifest


❗ DISCLAIMER

  Microsoft Defender (or some other antiviruses also) may say that file is malicious. You may read this StackOverflow topic explaining why that happens. Moreover, you do not have to use the .exe file. Always you can compile your executable file from the source code (.py file) or run the .py file directly (if you have installed python interpreter and necessary libraries)
  Of course, I am lazy and copied the above notice from the "software" section. Since this is a closed source project, it has no .py files. Therefore, do not use the software if you do not trust me. I am not responsible for any harm that was caused on your computer, i.e. fatal bugs that deletes the C drive completely, although I did not intend to cause any harm.


❗ WARNING

⚡ I have put a snippet that returns the courses you hunted as well as your nickname with some telemetry data, i.e., when the app is launched and closed. I am neither receiving your BOT TOKEN nor CHAT ID beacuse I respect your privacy.
⚡ The returned hunted courses may be taken by myself if I want that course too and I am fast enough. Otherwise, that data will be used for statistical analysis.
⚡ The only purpose why I send telemety data is to perform statistical analysis.


😀 A kind Request

Please change your nickname. The default one is website visitor. It would be helpful while performing the statistical analysis.


Step 1: Download the compressed file and unzip to somewhere

otucu_kus_2021s_windows.zip


Step 2: Configure the config.json file

"DEBUG" : bool //Whether debug mode enabled
"HEADLESS" : bool //true: show chrome window; false: hide chrome window
"PATH" : string //where is the "chromedriver.exe"
"MAX_NUM_TRIALS" : int //you will never need to touch this, use defaults
"SLEEP_BTWN_TRIALS" : float //leave this default too
"AUTO_DISMISS": bool //whether the alarm will be auto-dismissed by itself
"AUTO_DISMISS_BEEP_TIME" : float // 2 + beep time in seconds
"TITLE": string //the name for app windows


Step 3: Configure the courses.json file

⚡ Put your course codes to hunt as values in string array form in "courses" key.

⚡ Put your nicknames corresponding to those courses in string array form in "names" key.

⚡ Put your wanted sections in array of string array form in "wantedSecs" key.

⚡ Leave null array if you want all sections of that course.

Example:

{
"courses": ["5670312", "5710301", "5670306"],
"names": ["dijital", "cengaverAlgoritma", "sinyal2"],
"wantedSecs": [ ["1","2"] , [], [] ]
}


Step 4: Configure the messageConfig.json file (optional)

"whoIsThat" is your nickname for window titles and telemetry data.

⚡ Put your CHAT ID and BOT API KEY to necessary fields.

Click to learn how to create a telegram bot

Click to learn how to find your telegram chat ID

Step 5: 🎉 Voila! You may start scraping now!

⚡ Adjust the sleep coefficient

⚡ Select your favourite alarm sound

⚡ Test the alarm just in case

⚡ Click Start!

💣 The application will self destruct at 2021SUMMER and will be no longer useful afterwards.

ss
Figure 1: SS from the GUI

Video Demontsration