https://github.com/phelipegustavo/fireflies-lightsync
Mouse lightsync GUI
https://github.com/phelipegustavo/fireflies-lightsync
g203 g203-lightsync linux-app logitech
Last synced: about 1 month ago
JSON representation
Mouse lightsync GUI
- Host: GitHub
- URL: https://github.com/phelipegustavo/fireflies-lightsync
- Owner: phelipegustavo
- License: mit
- Created: 2025-02-25T23:02:40.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-05-10T13:41:12.000Z (about 1 year ago)
- Last Synced: 2025-07-13T22:26:31.101Z (12 months ago)
- Topics: g203, g203-lightsync, linux-app, logitech
- Language: Python
- Homepage:
- Size: 71.1 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Fireflies Light Sync
This project provides a graphical user interface (GUI) for controlling the Logitech G203 Prodigy / G203 LightSync Mouse LED settings. It allows users to easily interact with the mouse's LED features without needing to use the command line interface (CLI) directly.
Inspired by and based on [g203-led](https://github.com/smasty/g203-led).
## How to install
To install the app, run the following commands:
### Prerequisites
```shell
sudo apt install libxcb-cursor0
```
### Install
```shell
git clone https://github.com/phelipegustavo/fireflies-lightsync.git
cd fireflies-lightsync
./install-ubuntu
```
After that, you should be able to open the app from the applications menu. A sudo password is required.
## Project Structure
```
fireflies-lightsync*
├── src
│ ├── main.py # Entry point of the application
│ ├── gui
│ │ ├── __init__.py # GUI package initializer
│ │ ├── main_window.py # Main window class for the GUI
│ ├── controllers
│ │ ├── __init__.py # Controllers package initializer
│ │ └── g203_led.py # logic for controlling the mouse
├── requirements.txt # Project dependencies
└── README.md # Project documentation
```
## Features
- Off - Disable leds
- Fixed - Single color mode
- Wave - Cycle all colors from left to right
- Breathing - Single color Breathing
- Custom Colors - Define a fixed color for each LED
- DPI settings - **TBD**
## Contributing
Contributions are welcome! Please feel free to submit a pull request or open an issue for any enhancements or bug fixes.
### Installation
To install the required dependencies, run the following command:
```
pip install -r requirements.txt
```
### Usage
To start the application, run the following command:
```
sudo python src/main.py
```
This will launch the GUI, allowing you to control the LED settings of your Logitech G203 mouse.
## License
This project is licensed under the MIT License. See the LICENSE file for more details.