TKBot

A TKB booking app built on top of Selenium.

About The Project • Getting Started • Usage • Roadmap • Contributing • Contact • Acknowledgments

About The Project

Key Features

• Auto Booking
  • Immediately book the seats after the offical website refresh the opening seats at 00:00.
  • After reserving through the app, you can leave it alone.
• Auto Login
  • Automatically login when you launch the app, after you set up the config by your own username and passowrd
• Multiple Sessions
  • You can select more than one sessions, and the app will book all of them as more as possible

(back to top)

Getting Started

Installation

1. Clone the repo

   git clone https://github.com/tsai8890/TKBot.git

2. Install python packages

   cd TKBot/src
   pip3 install -r requirements.txt

3. Copy the config template

   cd TKBot/src
   cp .env.default .env

4. Enter your username and password in .env

   USERNAME=[your username]
   PASSWORD=[your password]

(back to top)

Usage

1. Run the app

   cd TKBot/src
   python3 main.py

2. After you launch the app, it will first try to login with your username and password

   

   Note If the login process is blocked by the website, then you would be required to login manually.

3. After the app successfully logged in, a window will pop up for the further reservation.

   

4. Select each field, then click 預約

   

5. After you click 預約, it will show 已預約，等待中 .... You can change the reservation information before 00:00, after 00:00, the app will immediately book the specified sessions

   

(back to top)

Roadmap

• Add a simple GUI interface
• Add a update tkb data button into the GUI interface
  • update function
  • update button
• Add a unique project icon
• Support multiple users at once

(back to top)

Contributing

If you have a suggestion that would make the project better, please fork the repo and create a pull request.
You can also simply open an issue with the tag enhancement.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Besides, if you find this project useful, don't forget to give it a star !

(back to top)

Contact

Peter Tsai - asdpeter6520@gmail.com

Project Link: https://github.com/tsai8890/TKBot

(back to top)

Acknowledgments

• Best README Template
• Electron-Markdownify's README
• Conventional Commit

(back to top)