# LEDSpicer - LED Manager for linux

[![GitHub](https://img.shields.io/github/v/release/meduzapat/LEDSpicer?color=blueviolet)](https://github.com/meduzapat/LEDSpicer/releases/latest)
![GitHub Release Date](https://img.shields.io/github/release-date/meduzapat/LEDSpicer)
![GitHub License](https://img.shields.io/github/license/meduzapat/ledspicer?logo=opensourceinitiative&logoColor=%233DA639&color=blue)
[![CII Best Practices](https://bestpractices.coreinfrastructure.org/projects/3183/badge)](https://bestpractices.coreinfrastructure.org/projects/3183)
[![Static Badge](https://img.shields.io/badge/Donations_are_welcome-gray?logo=paypal&labelColor=rgb(255%2C%20209%2C%2064))](https://www.paypal.com/donate/?hosted_button_id=LVNVCXN4NKWP8)
[![Static Badge](https://img.shields.io/badge/OH-rgb(90%2C%2042%2C%20130)?label=Project%20Summary&labelColor=gray)](https://openhub.net/p/ledspicer)
[![Copr build status](https://copr.fedorainfracloud.org/coprs/meduzapat/ledspicer/package/ledspicer/status_image/last_build.png)](https://copr.fedorainfracloud.org/coprs/meduzapat/ledspicer/package/ledspicer/)

## LEDSpicer: LED and Joystick Control Daemon

LEDSpicer is a Linux daemon for controlling single-color and RGB LEDs across multiple hardware devices. It executes animations and lighting profiles that can be triggered by user commands, network events, or running applications, with native support for MAME game events.

### Key Features

- **Multi-device support** for a wide range of LED controllers
- **Profile-based activation** triggered by games, commands, or network events
- **MAME integration** for LED synchronization with in-game activity
- **Joystick restrictor and rotator control** for arcade applications

LEDSpicer combines responsive LED management with mechanical control, making it well-suited for arcade cabinets and interactive projects.

## Getting Started

### Installation

LEDSpicer is available through package repositories for major Linux distributions:

- **Ubuntu/Debian**: [PPA](https://launchpad.net/~meduzapat/+archive/ubuntu/ledspicer)
- **Fedora**: [COPR](https://copr.fedorainfracloud.org/coprs/meduzapat/LEDSpicer/)
- **Arch Linux**: [AUR](https://aur.archlinux.org/packages/ledspicer)

For manual compilation and detailed configuration, see the [project wiki](https://github.com/meduzapat/LEDSpicer/wiki/).

## Contacts, Content and Media.

[![Facebook Page](https://img.shields.io/badge/Visit%20the-Facebook%20page-blue?logo=facebook)](https://www.facebook.com/LEDSpicer-2393969390678210)

[![Youtube Channel](https://img.shields.io/badge/Visit%20the-Youtube%20Channel-red?logo=youtube)](https://www.youtube.com/playlist?list=PLKqGl2gHvQPSnCl0zcyKkzd4-E6xux-Zi)

[![Discord Channel](https://img.shields.io/discord/1187485303313809528?logo=discord&logoColor=%235865F2&label=Discord%20Channel)](https://discord.gg/m4D2QVXqm6)

## Some sample videos

[![Arcade Demo](http://img.youtube.com/vi/DbuePBl1W0Y/0.jpg)](https://youtu.be/DbuePBl1W0Y)
[![Arcade Demo](http://img.youtube.com/vi/l4lzksatgVA/0.jpg)](https://youtu.be/l4lzksatgVA)

for more videos visit the YT channel.

## License

Copyright (C) 2018 - 2024 Patricio A. Rossi

LEDSpicer is free software: you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the
Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
LEDSpicer is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along
with this program. If not, see <http://www.gnu.org/licenses/>.

## Copyright note

Ultimarc, Ultimarc brand and Ultimarc products are property of Ultimarc Limited Company.
For more information about Ultimarc visit their website at https://www.ultimarc.com

Led-Wiz™, GP-Wiz™, Roto-X™ are property of Ithaca Digital Visual Technologies Inc.
For more information about Led-Wiz visit their website at https://groovygamegear.com

All names used are trademarked by their respective trademark holders.
