Skip to content

Zeepaardje98/Bottenkraker-Timer

Repository files navigation

Bottenkraker-Timer

This repository contains the code for a tool that helps with timing clicks manually. This project is written in Python 3.

Packages

This project uses several third-party packages. These can be found in requirements.txt. To install the packages all at once, the following command can be run: pip install --no-cache-dir -r requirements.txt. Keep in mind that you need to have installed python3-pip for this to work. Next to pip-installable dependencies, the project also depends on tkinter. This can be installed with the package manager, package name being python3.x-tkinter or python3.x-tk, substituting x for the current python version.
For example on debian: sudo apt-get -yqq install python3.9-tk.

Run Snipetool

To run this tool, follow these steps in the command line or terminal:

  1. Navigate to the folder containing snipetool.py: cd Bottenkraker-Timer/
  2. Run the snipetool: python snipetool.py
    Additionaly, for windows, you can download the .zip file of the version you want from https://github.com/Zeepaardje98/TimeTool_Release. unzip this file, and execute snipetool.exe.

Guide to the Snipetool

When starting the snipetool. This window will show up:
image
with the bottom bar filling up exactly once every second. This bar is filled when the time reaches the millisecond given by the user. This bar will change color when the time reaches the Snipe Time minus the Walk Time given by the user.

Entries

There are 3 entry fields in this window:
image

  • Snipe Time: The time entered here will partly determine when the bar changes color.
  • Walk Time: The time entered here will be subtracted from Snipe Time, to determine the time when the bar will change color.
  • Snipe Ms: The millisecond entered here will determine at what millisecond the bar will be completely filled.

Under these entry fields is a Send label. This shows the user at what time you need to click. The bar will be completely filled up in a different color at this time.
image

Server synchronisation

The timeserver that's being used can be found under the Send label, with a Sync button right next to it.
image

You can change the selected server by clicking on the currently used server, and selecting one of the options in the menu that drops down. Clicking the Sync button will synchronize the currently used time with the time of the selected server. To the right of the Sync button is an icon that shows you if you are currently synchronized with a server, and how long ago this synchronization took place. This icon will be green if you're synchronized to a server, and red if you're not synchronized to a server.

Side buttons

On the right side of the window, several buttons can be found.
image
This button opens the Settings menu, where you can customize the used colors in the program. Or (in production) add time servers and custom themes.

image
This button pastes the contents of the current clipboard into the entry fields(Snipe Time, Walk Time and Snipe Ms) of the program, but only if the current clipboard contents is a python dict with the required keys: {"snipe_time": "vandaag 04:20:00", "walk_time": "00:00:00", "snipe_ms": 0}.

image
This button links directly to the github repository, and will open the repository in the browser.

image
This button opens the Info screen, showing additional info about the program.

image
This button links directly to a PayPal donation button, and will open a donation screen in the browser. Paypal currently takes €0.30 and 2.9% from all individual donations.

Used assets

images from https://icons8.com/icon/set/settings/material-sharp--white