git404hub

what is fkturesults fr?

prawmathean/fkturesults — explained in plain English

Analysis updated 2026-05-18

8PythonAudience · generalComplexity · 2/5Setup · easy

tl;dr

A Python script that logs into the KTU university result portal for you and fetches your semester grade card, retrying automatically when the slow portal times out.

vibe map

mindmap
  root((FKtuResults))
    What it does
      Logs into KTU portal
      Fetches grade card
      Prints results table
    Reliability
      Retries on 504 errors
      Jittered backoff
      Up to 100 retries
    Tech stack
      Python
      requests
      BeautifulSoup4
    Output
      Terminal table
      Saved HTML file
    Audience
      KTU students

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Fetch your KTU semester grade card from the terminal without repeatedly refreshing an overloaded website.

VIBE 2

Automatically retry fetching results when the KTU portal returns server timeout errors during peak release times.

VIBE 3

Save your grade card as a formatted HTML file you can open and view in any browser.

VIBE 4

Check results for any semester by supplying its numeric semester ID.

what's the stack?

PythonrequestsBeautifulSoup4urllib3

how it stacks up fr

prawmathean/fkturesults100/awesome-machine-learningadam-s/car-diagnosis
Stars888
LanguagePythonPythonPython
Last pushed2024-08-07
MaintenanceStale
Setup difficultyeasyeasymoderate
Complexity2/51/53/5
Audiencegeneraldeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min

Requires Python 3.7 or newer and a valid KTU student portal login.

in plain english

FKtuResults is a Python command line script for students at KTU, a university whose result portal is known for timing out and returning server errors. Instead of refreshing the slow website by hand, you run this script in a terminal and it logs into the portal for you, fetches your semester grade card, and prints it as a clean table right there in the console. You run one script and it asks for three things: your KTU username, which is usually your register number, your password, entered as hidden input so it never shows on screen, and the semester ID for the results you want to see. The semester ID is a number the portal uses internally, and the README explains how to find it by logging into the portal in a browser and checking the dropdown next to each semester's name. Because the KTU portal frequently returns 504 Gateway Timeout errors, especially right when results are released and everyone is checking at once, the script automatically retries the request up to one hundred times with randomised delays between attempts. You just leave it running and it keeps trying until the portal responds. Once it succeeds, the results are both printed to the terminal and saved as a full HTML file named after your username and semester, which you can open in a browser for a nicely formatted view. To use it you need Python 3.7 or newer, and after cloning the repository you install three packages: requests for handling the login and HTTP sessions, beautifulsoup4 for pulling the CSRF token and grades table out of the returned HTML, and urllib3 to quiet SSL warnings that come from the portal's self signed certificate. Credentials are never written to disk, they only exist in memory while the script runs. The project includes a troubleshooting table covering common failures like a missing CSRF token or an expired session, along with suggested fixes for each.

prompts (copy fr)

prompt 1
Explain how FKtuResults finds and uses the semester ID needed to fetch my grade card.
prompt 2
Walk me through installing the Python dependencies FKtuResults needs before running it.
prompt 3
Explain why FKtuResults retries the results request up to one hundred times.
prompt 4
Show me how to open the saved HTML grade card file that FKtuResults produces.

Frequently asked questions

what is fkturesults fr?

A Python script that logs into the KTU university result portal for you and fetches your semester grade card, retrying automatically when the slow portal times out.

What language is fkturesults written in?

Mainly Python. The stack also includes Python, requests, BeautifulSoup4.

How hard is fkturesults to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is fkturesults for?

Mainly general.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.