Berlin Auslaenderbehorde Termin Bot Project Overview
Introduction
Berlin Auslaenderbehorde Termin Bot is a convenient software tool that automates the process of detecting available appointments at the Ausländerbehörde Berlin for various visa services. This tool is especially useful for individuals who need to find an appointment as it provides an audible notification whenever a spot becomes free.
Key Features
- Automated Appointment Detection: Utilizing the Selenium library, this application continuously checks for appointment availability at the Berlin Ausländerbehörde.
- Sound Notification Alert: Once a suitable appointment is found, the application will emit a beep, ensuring users are promptly informed.
- Ease of Use: Users simply input their data, and the bot does the rest.
Prerequisites
To successfully use the Berlin Auslaenderbehorde Termin Bot, the following prerequisites are required:
-
Docker Installation:
- Docker is necessary to run the Selenium server. It can be downloaded and set up by following instructions on Get Docker.
- After Docker installation, users can start the Selenium server with a provided command, tailored for general use or specifically for MacOS with an M1 chip.
-
Java Development Kit (JDK) Version:
- A JDK version of 17 or higher is essential. Users are advised to verify their Java version using
java --version. If it is outdated, they should update to the latest version through the Oracle website.
- A JDK version of 17 or higher is essential. Users are advised to verify their Java version using
How to Run the Application
-
Personal Information Setup:
- Users must fill in a
personInfoDTO.jsonfile with their personal details. - Key details include setting the country and indicating family status (single or married) appropriately.
- Users must fill in a
-
Visa Application Setup:
- A
visaFormTO.jsonfile must also be completed with specific visa request details. Template files are available to ease this process.
- A
-
Starting the Application:
- The application should be executed via the terminal using the command
./gradlew run. - Once the bot identifies available appointment dates, a sound notification will be triggered.
- The application should be executed via the terminal using the command
-
Monitoring the Process:
- Users can view the bot's operation by visiting http://localhost:7900/?autoconnect=1&resize=scale&password=secret.
License Information
Berlin Auslaenderbehorde Termin Bot is released as free software under the GNU Affero General Public License. It allows users to redistribute and modify the software under the included terms. For additional licensing details, users should refer to the accompanying GNU license documentation.
The project was initiated in 2022 by Yilmaz Naci Aslan and includes contributions from other collaborators. The full list of contributors can be accessed by executing a specific Git command within the project directory.