Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/LoLei/razer-cli
CLI for configuring Razer devices
https://github.com/LoLei/razer-cli
cli colors effects hacktoberfest linux pywal razer rice x
Last synced: 2 months ago
JSON representation
CLI for configuring Razer devices
- Host: GitHub
- URL: https://github.com/LoLei/razer-cli
- Owner: LoLei
- License: gpl-3.0
- Created: 2019-03-13T15:54:45.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2024-04-04T06:49:52.000Z (9 months ago)
- Last Synced: 2024-10-02T12:03:55.522Z (3 months ago)
- Topics: cli, colors, effects, hacktoberfest, linux, pywal, razer, rice, x
- Language: Python
- Homepage:
- Size: 6.67 MB
- Stars: 89
- Watchers: 2
- Forks: 11
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome - LoLei/razer-cli - CLI for configuring Razer devices (Python)
README
# razer-cli
[](#contributors-)
Command line interface for controlling Razer devices on Linux
## About
With this command line interface you can configure your Razer peripherals, such
as keyboard and mouse, set their colors and effects, etc.
The most simple use case (for which this tool was originally developed) is to
use it in symbiosis with [`pywal`](https://github.com/dylanaraps/pywal). Then
this tool will set your Razer colors to Pywal's colors. See below for more
information.
## Installation
[`pip install razer-cli`](https://pypi.org/project/razer-cli/)
OR
```
git clone https://github.com/LoLei/razer-cli.git
cd razer-cli
sudo python setup.py install
```
OR
```
git clone https://github.com/LoLei/razer-cli.git
cd razer-cli
pip install . --user
```
## Usage
```
$ razer-cli -h
usage: razer-cli [-h] [-man [MANUAL ...]] [-v] [-d DEVICE [DEVICE ...]]
[-a] [-e EFFECT [EFFECT ...]] [-c COLOR [COLOR ...]]
[-z ZONES [ZONES ...]] [-b BRIGHTNESS [BRIGHTNESS ...]]
[--dpi DPI] [--poll POLL]
[--battery BATTERY [BATTERY ...]] [-l] [-ll] [-ls]
[--sync] [--restore] [--version]
optional arguments:
-h, --help show this help message and exit
-man [MANUAL ...], --manual [MANUAL ...]
Print help details for given feature(s)
-v, --verbose increase output verbosity
-d DEVICE [DEVICE ...], --device DEVICE [DEVICE ...]
only affect these devices, same name as output of
-l
-a, --automatic try to find colors and set them to all devices
without user arguments, uses X or pywal colors
-e EFFECT [EFFECT ...], --effect EFFECT [EFFECT ...]
set effect
-c COLOR [COLOR ...], --color COLOR [COLOR ...]
choose color (default: X color1), use one argument
for hex, or three for base10 rgb
-z ZONES [ZONES ...], --zone ZONES [ZONES ...]
choose zone for color(s)
-b BRIGHTNESS [BRIGHTNESS ...], --brightness BRIGHTNESS [BRIGHTNESS ...]
set brightness of device
--dpi DPI set DPI of device (use print as a value to show
it)
--poll POLL set polling rate of device (use print as a value
to show it)
--battery BATTERY [BATTERY ...]
set low threshold and/or idle delay (use print as
a value to show it)
-l, --list_devices list available devices, settings, and their
supported capabilities/effects
-ll, --list_devices_long
list available devices settings, and list their
supported capabilities/effects
-ls, --list_devices_short
list available devices and their settings
--sync sync lighting effects to all supported Razer
products
--restore Load last used settings
--version Print version number
```
This might be out of date, just run it with `-h` yourself to see the newest
options.
### Example usage with Pywal
To get your mouse and keyboard to use Pywal's colors, simply start `razer-cli`
with the `-a` flag, after having executed `wal`: `razer-cli -a`
Example in action
[here](https://github.com/LoLei/dotfiles/blob/master/exec-wal.sh).
Another option is to use `razer-cli -e multicolor,xpalette`, which not only
uses a single color from pywal, but uses the entire 16 color palette.
#### Other examples
`$ razer-cli -e ripple -c ff0000`
`$ razer-cli -e static -c ffffff`
You can also leave out the color or the effect:
`$ razer-cli -e breath_single`
`$ razer-cli -c 55ff99`
Currently this will imply the `-a` flag being used for the missing setting. I
plan on also having the option to reuse the current color/effect, if the
argument is missing, in the future.
#### Effects
Effects are listed in
[`razer_cli/settings.py`](https://github.com/LoLei/razer-cli/blob/master/razer_cli/settings.py).
The effects that are supported per device can be listed with `razer-cli -l[l]`.
Some of the built-in effects or not implemented yet. If such an effect is
chosen, a notice will be logged. There are also custom effects that do not exist
normally, such as `multicolor`, which is described in the same file.
Here's a showcase of that effect:
#### Other symbiosis tools
* [`wpgtk`](https://github.com/deviantfero/wpgtk)
* [`Chameleon`](https://github.com/GideonWolfe/Chameleon)
## Dependencies
* [`openrazer`](https://github.com/openrazer/openrazer)
* :warning: Do not install `openrazer` from [pip](https://pypi.org/project/openrazer/), which is something else.
* Instead install it from one of the various package managers of your distribution.
* [`xrdb`](https://www.archlinux.org/packages/extra/x86_64/xorg-xrdb/)
* Also available on most distros.
## Disclaimer
Not all devices have been tested, but basic effects should work everywhere. Some guesswork is being done as to what capabilities are supported on specific devices. If you need more advanced configuration, consider using the GUIs [Polychromatic](https://github.com/polychromatic/polychromatic/), [RazerGenie](https://github.com/z3ntu/RazerGenie) or [RazerCommander](https://gitlab.com/gabmus/razerCommander) which have specific implementations for most devices.
Feel free to open feature request issues or PRs.
## Contributors ✨
Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):
Ansis
💻
Kainoa Kanter
🤔
IFo Hancroft
🐛 📓 📖
GM-Script-Writer-62850
💻
Stephen Thomas-Dorin
💻
Romain Richard
💻
This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!