Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/antonioskalattas/automatic-gym-reservation
Automatic Gym Reservation
https://github.com/antonioskalattas/automatic-gym-reservation
automation chrome gym selenium webdriver
Last synced: 5 days ago
JSON representation
Automatic Gym Reservation
- Host: GitHub
- URL: https://github.com/antonioskalattas/automatic-gym-reservation
- Owner: AntoniosKalattas
- Created: 2024-07-16T15:53:43.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-02-01T21:47:41.000Z (11 days ago)
- Last Synced: 2025-02-01T22:27:34.446Z (11 days ago)
- Topics: automation, chrome, gym, selenium, webdriver
- Language: Python
- Homepage:
- Size: 424 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Automatic-Gym-Reservation
UCYGYM_BOT is an automation tool for reserving gym sessions at the University of Cyprus. It uses Python and Selenium WebDriver to interact with the UCY gym reservation system, automating the entire booking process.
## Features
- **Automated Reservations**: Book gym sessions quickly without manual interaction.
- **Cross-Platform Compatibility**: Works on Windows, macOS, and Linux systems with Python and Selenium.
- **User-Friendly Setup**: Easily configurable through the provided scripts.
## Prerequisites
- [Python 3.x](https://www.python.org/downloads/)
- [Google Chrome Browser](https://www.google.com/chrome/)
- [ChromeDriver](https://sites.google.com/chromium.org/driver/) (compatible with your Chrome version)
- [Electron](https://www.electronjs.org/) for additional GUI-based features
## Installation
1. **Clone the Repository**:
```bash
git clone https://github.com/AntoniosKalattas/UCYGYM_BOT.git
cd UCYGYM_BOT
```
2. **Install Dependencies**:
Use the `requirements.txt` file for Python dependencies:
```bash
pip install -r requirements.txt
```
Ensure Electron dependencies are installed via npm(Only for UI perposes):
```bash
npm install
```
3. **Set Up ChromeDriver**:
- Download [ChromeDriver](https://googlechromelabs.github.io/chrome-for-testing/) for your OS.
- Place it in your system's PATH or specify its location in the script.
4. **Copy the path to chrome profile**:
- enter `chrome://version` in chrome url
- copy the location of `profile path` inside the `chromeProfilePath.txt` file
## Usage
### Start with Electron (Optional)
For a GUI-based experience, launch the Electron app:
```bash
npm start
```
## Files and Structure
- **`autoReservation.py`**: Main script for automating reservations.
- **`firstTime.py`**: Script for initial configuration.
- **`package.json`**: Configuration file for Electron integration.
- **`requirements.txt`**: Python dependencies for Selenium and other packages.
## Troubleshooting
- **Selenium Errors**: Ensure that ChromeDriver matches your Chrome browser version.
- **Element Not Found**: Verify that the UCY reservation system hasn't changed its structure. Update the selectors in the scripts if necessary.
- **Node.js Issues**: Ensure Node.js is installed to run Electron.
# How to setup automatic reservation
- Choose the desired time of the reservation in `auto.py`
- In your LINUX server run the command
```bash
nohup python3 auto.py &
```
## Contributing
Contributions are welcome! Feel free to fork the repository, submit a pull request, or open an issue.
## License
This project is licensed under the ISC License. See the `LICENSE` file for details.
## Author
Created by [Antonios Kalattas](https://github.com/AntoniosKalattas).
---
