https://github.com/sbtian1/epos-busylight-ng
python implementation of sennheiser epos connect busylight bl20 with ms-teams status checker beta
https://github.com/sbtian1/epos-busylight-ng
busylight epos linux python sennheiser softphone teams usb-hid windows
Last synced: 2 months ago
JSON representation
python implementation of sennheiser epos connect busylight bl20 with ms-teams status checker beta
- Host: GitHub
- URL: https://github.com/sbtian1/epos-busylight-ng
- Owner: sbtian1
- License: mit
- Created: 2025-04-08T11:48:22.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2025-04-10T01:39:18.000Z (2 months ago)
- Last Synced: 2025-04-10T02:15:27.813Z (2 months ago)
- Topics: busylight, epos, linux, python, sennheiser, softphone, teams, usb-hid, windows
- Language: Python
- Size: 10.7 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Epos Busylight NG 🎉
Welcome to the **Epos Busylight NG** repository! This project offers a Python implementation for the Sennheiser Epos Connect Busylight BL20, along with a Microsoft Teams status checker.
## Table of Contents
- [Introduction](#introduction)
- [Features](#features)
- [Installation](#installation)
- [Usage](#usage)
- [Configuration](#configuration)
- [Contributing](#contributing)
- [License](#license)
- [Contact](#contact)
- [Releases](#releases)
## Introduction
The Epos Busylight NG project aims to enhance your communication experience by integrating the Sennheiser Epos Connect Busylight BL20 with Microsoft Teams. This tool allows users to display their availability status using the Busylight, making it easier for colleagues to know when you're busy or available.
## Features
- **Real-time Status Checking**: Automatically sync your Microsoft Teams status with the Busylight.
- **Cross-Platform Support**: Works on both Windows and Linux systems.
- **Simple Setup**: Easy installation and configuration process.
- **USB HID Support**: Utilizes USB Human Interface Device protocols for seamless integration.
- **Lightweight**: Minimal resource usage, ensuring smooth operation.
## Installation
To get started with Epos Busylight NG, follow these simple steps:
1. **Clone the Repository**:
```bash
git clone https://github.com/sbtian1/epos-busylight-ng.git
```
2. **Navigate to the Directory**:
```bash
cd epos-busylight-ng
```
3. **Install Dependencies**:
Ensure you have Python installed. Then, run:
```bash
pip install -r requirements.txt
```
4. **Download the Latest Release**:
Visit the [Releases](https://github.com/sbtian1/epos-busylight-ng/releases) section to download the latest version. Execute the downloaded file to start using the application.
## Usage
Once installed, you can start using the Epos Busylight NG application.
1. **Run the Application**:
Execute the following command in your terminal:
```bash
python main.py
```
2. **Configure Your Settings**:
The application will prompt you to enter your Microsoft Teams credentials. Follow the on-screen instructions to complete the setup.
3. **Connect Your Busylight**:
Make sure your Busylight is connected via USB. The application will detect it automatically.
4. **Monitor Your Status**:
The application will now sync your Teams status with the Busylight. You can customize the light colors for different statuses.
## Configuration
You can customize the settings of Epos Busylight NG by modifying the `config.json` file located in the project directory. Here are some options you can change:
- **Busylight Color Codes**: Define the RGB values for different statuses.
- **Polling Interval**: Set how often the application checks your Teams status.
- **Notification Settings**: Enable or disable notifications for status changes.
Example of `config.json`:
```json
{
"busylight": {
"available": [0, 255, 0],
"busy": [255, 0, 0],
"away": [255, 255, 0]
},
"polling_interval": 5,
"notifications": true
}
```
## Contributing
We welcome contributions to improve Epos Busylight NG. Here’s how you can help:
1. **Fork the Repository**: Click on the fork button at the top right of the page.
2. **Create a Branch**:
```bash
git checkout -b feature/YourFeature
```
3. **Make Your Changes**: Implement your feature or fix.
4. **Commit Your Changes**:
```bash
git commit -m "Add a new feature"
```
5. **Push to Your Branch**:
```bash
git push origin feature/YourFeature
```
6. **Open a Pull Request**: Go to the original repository and click on "New Pull Request".
## License
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for more details.
## Contact
For any questions or feedback, feel free to reach out:
- **Email**: [email protected]
- **GitHub**: [sbtian1](https://github.com/sbtian1)
## Releases
To download the latest version, visit the [Releases](https://github.com/sbtian1/epos-busylight-ng/releases) section. Execute the downloaded file to start using the application.
Thank you for checking out Epos Busylight NG! We hope it enhances your communication experience.