#light #ram #rgb #control #stick #cli #command

app fury-renegade-rgb

A small CLI app that allows you to control the RGB lights on Kingston Fury Renegade RAM

1 unstable release

0.1.0 May 7, 2023

#1617 in Hardware support

GPL-3.0 license

18KB
399 lines

fury-renegade-rgb

A small CLI app that allows you to control the RGB lights on Kingston Fury Renegade RAM

Note1: Currently this only works on linux, though contributions to make this work on windows as well will be welcome.

Note2: This was only ever tested with 4 sticks in my system. While you can probably use the timing synchronizing for less than 4 sticks, I currently do not account for that.

Note3: You must have permission to write to the i2cbus to use this. This would involve either running the command as root (sudo) or adding yourself to the i2c group.

Usage

fury-renegade-rgb -b /dev/i2c-1 -1 -2 -3 -4 COMMAND

Where /dev/i2c-1 is a path to the i2c bus where your RAM is. I wouldn't know where it is on your device, but that's where it is on mine.

You can omit any of the -1, -2, -3, and -4 flags if you don't wanna send the command to any of the sticks.

COMMAND is any of what's below

Commands

  • noop just sends a noop command to the specified sticks
  • reset does the following
    • Syncronizes the sticks
    • Sets all brightness values to 100%
    • Sets custom colour to #000000
    • Sets pattern to rainbow
    • Resets timing delays and offsets
  • sync syncs the sticks together
    • Note that you can only syncronize sticks that are beside each other. E.g., you can sync all of them together, 1 with 2, and 3 with 4, but you can't sync 1 with 3.
  • colour-brightness --red VALUE --green VALUE --blue VALUE
    • Sets a sort of colour filter mask... thing
  • brightness --value VALUE
    • Between 0 and 100, dims the overall pattern with 100 being the default
  • pattern-start-offset --raw-offset VALUE
    • Sets a delay before starting the pattern. On a syncronized set of sticks, the offset appears to be additive
  • pattern-repeat-delay --raw-delay VALUE
    • A delay before the pattern repeats, this should be set to the same value on all sticks that are syncronized
  • pattern --style STYLE --red VALUE --green VALUE --blue VALUE --colour-cycle
    • STYLE can be any of the following
      • solid - Always shows custom colour
      • rainbow - The unicorn barf we all know and love, no custimization options have any effect
      • scan - A dot scans from top to bottom, then settles on the center
      • breathe - Fades in and out
      • fade - Only fades in, most interesting with the colour cycle
      • stripe - Wipes from the bottom to top
      • trail - Trailing light, bottom to top
      • lightning - Electrical pattern, not unlike a plasma ball. Looks best with 4 sticks
      • countdown - Counts down from 9 to 0 repeatedly. Looks best with 4 sticks
      • fire - Fire pattern, no custimization options have any effect, looks best with 4 sticks
      • sparkles - Sprikles random colours around the ram, non-customizable, looks best with 4 sticks
      • fury - Writes "F" on the sticks, then "U", then "R", then "Y". Looks best with 4 sticks.
    • VALUE is a value between 0 and 255
    • --colour-cycle can be omitted, when specified, it will cycle the pattern with the following colours: custom, green, orange, blue, yellow-sih green, pink, cyan, yellow, bright-punk, bright-cyan, red
  • pattern-style STYLE
    • Only sets the STYLE which is the same as above
  • pattern-colour --red VALUE --green VALUE --blue VALUE
    • Only sets the colour, which has the same VALUEs as above

Dependencies

~7.5MB
~143K SLoC