AK820 Pro Studio

Lighting, screen and key remapping – straight from your browser

Not connected

Lighting

The preview updates instantly. Nothing is sent until you click below.

The preview is a reconstruction, not read from the keyboard – the real effects differ in detail. Direction only applies to Scroll, Roll, Flow and Tilt.
Persistence and technical details
If a setting is lost when the keyboard reboots – for example when you flip the mode switch – the save step is the suspect. The sources disagree here, so both variants are selectable. Applies to lighting, clock and standby.
Test procedure: apply a setting, unplug the cable, wait five seconds, plug it back in. If the setting survives, that variant writes to flash.
Sequence: START 04 18, MODE_CFG 04 13, MODE_DATA, SAVE 04 02. In the data packet byte 0 is the effect value, bytes 1–3 are R/G/B, byte 8 the rainbow flag, bytes 9–11 brightness, speed and direction, trailer 55 AA on bytes 14/15.

Image on the screen

A photo, an animation or text – 128 × 128 pixels on the little display.

or write text

Image crop

Advanced options
Payload = 256-byte header plus frames of 32768 bytes each, padded to multiples of 4096. Frame delays are stored as milliseconds divided by two, so 2 to 510 ms. The two variants come from two sources that disagree on three bytes.

Clock

The keyboard has its own clock, which drifts over time.

Send everything runs clock, lighting and image one after another. The automatic sync only works while this page stays open.

Which key is this?

Switch the monitor on and press a key – useful when the legend is wrong.

Switch the monitor on and press a key
While the monitor is on, input fields will not behave normally – switch it off afterwards. Media keys and the knob often produce no keyboard event; that is what the second button is for.

Remap a key

Handled by macOS, not by the keyboard – and it applies to this device only.

Terminal command


    

      
      
      
    

    
    
How to make it permanent
      
Make permanent downloads a startup file. Then run these three lines in Terminal:

      
mkdir -p ~/Library/LaunchAgents
mv ~/Downloads/de.local.ak820.keymap.plist ~/Library/LaunchAgents/
launchctl load -w ~/Library/LaunchAgents/de.local.ak820.keymap.plist

      
Without this the mapping is gone after a restart. Key combinations such as Cmd plus Space are not possible – only key to key.

    

  






  

    
Standby

    
How long without input before the screen switches off.

    

      

        
      

    

    
    
The keyboard knows no steps other than these four.

  

  

    
Profile

    
The keyboard will not reveal its current state – here you can record it yourself.

    
    
    
    
Saved are lighting, standby, image crop and text template – no image files.

  






  

    
Devices

    
The AK820 reports four interfaces. Two of them are needed.

    
    
    
    

    
Assignment

    

      

      

      

        
      

    

    
Variant A matches this keyboard descriptor and is confirmed on real hardware.

  


  

    
Send a single packet

    

      

    

      

      

        
      

    

    
    
  


  

    
Command scanner

    
The firmware echoes known commands back. That lets us sweep the command space.

    
    

      

      

      

    

    
    
    
    
    

    

      command exists
      already known
      no response
      error
    

    
Examine a command more closely

    
Step through every combination of byte 2 and byte 8 and group the responses. Different responses mean the byte is evaluated.

    

      

      

      

    

    
    
    

  


  

    
Log