Warning: This is an unofficial implementation; use at your own risk.
Uni Wireless Sync (UWS) CLI provides command-line utilities for managing Uni Fan Wireless controllers, L-Wireless receivers, and LCD panels. Each command re-opens the required USB or RF device so no background daemon is left running, and lower-level HID/USB errors are surfaced directly to simplify scripting.
- UNI FAN TL wireless LCD panels
- UNI FAN TL wireless fans (non-LCD)
Other Uni Fan series are currently not supported.
- Discover TL LCD USB devices and 2.4 GHz wireless fan controllers.
- Query LCD firmware and the panel's group index.
- Show images (JPEG or PNG, scaled to the panel) or play videos on the TL Wireless LCD, optionally keeping an image as the power-on image.
- Set LCD brightness and rotation.
- Show live sensor gauges (CPU/GPU temperature and load, fan speed) or a clock on the TL Wireless LCD.
- Keep the wireless TL LCD awake with the same heartbeat the vendor app sends.
- List wireless fan receivers with metadata (MAC, master MAC, channel, device type, fan speeds, PWM targets, fan types, RF firmware version, running LED effect).
- List detected master controller MAC addresses to simplify binding workflows.
- Send one-shot PWM commands to TL wireless fans over the 2.4 GHz dongle.
- Bind or unbind wireless receivers against the attached master controller.
- Make a device flash to find it, or restart the LCD panels of a TL Wireless LCD fan over RF.
- Toggle motherboard PWM sync mode for one receiver or every bound receiver.
- Send LED effects to wireless receivers; the CLI waits until the device reports the new effect and resends it if needed.
- All 29 TL effects with the vendor app's colours, speeds and brightness levels, and merge mode (one effect running across fan groups).
- Move every bound device to another RF channel.
- USB + PWM header (controller mode): leave the receiver's PWM lead unplugged; control every fan via
uws fan set-fan(any PWM value 0-255). The reportedfan_pwmreflects your last command. - USB-only (receiver mode, PWM lead connected to motherboard): the CLI writes a PWM of 6 (e.g.
uws fan pwm-sync --mode receiver --all) so the receiver keeps syncing to the motherboard header. Sending anotherset-fanvalue at any time overrides the sync immediately; writing 6 (or re-running the sync helper) hands control back to the motherboard.
- How do I mount the L-Wireless Controller (v1)? The thicker dongle supports two options: (1) plug into a USB Type-A port—this wiring is equivalent to
pwm-syncreceiver mode; (2) plug the header into a 9-pin USB port on the motherboard—this matchespwm-synccontroller mode, but 2.4 GHz signal strength drops because the dongle lives inside the chassis. - How do I mount the L-Wireless Controller (v2)? The slimmer dongle only supports option (1): plug into a USB Type-A port (
pwm-syncreceiver mode). - What is the difference between L-Wireless Receiver (v1) and (v2)? Receiver v1 exposes both USB and a 2-pin PWM lead only on the LCD bundle (USB powers the LCD, the 2-pin lead powers fans); non-LCD receiver v1 units ship with just the 2-pin power lead. Receiver v2 adds a dedicated 4-pin PWM header; plug it into the motherboard when you want it to mirror the motherboard duty cycle via
pwm-sync --mode receiver, or leave it disconnected and the controller will keep driving fan PWM directly.
pip install uwscli
python -m venv .venv
source .venv/bin/activate
pip install -e .
# or include dev extras
pip install -e .[dev]# Enumerate connected devices
uws lcd list
uws fan list
# Display operations
uws lcd info --serial <usb-serial>
uws lcd send-jpg --serial <usb-serial> --file assets/sample_lcd.jpg
uws lcd send-jpg --serial <usb-serial> --file photo.png --save # also keep it as the power-on image
uws lcd play-video --serial <usb-serial> --file clip.mp4 --loop
uws lcd control --serial <usb-serial> --brightness 40 --rotation 90
uws lcd keep-alive --serial <usb-serial>
uws lcd sensor --serial <usb-serial> --metric cpu-temp --color blue
# Fan receiver operations
uws fan set-fan --mac aa:bb:cc:dd:ee:ff --pwm 120 # direct PWM control
uws fan pwm-sync --mode receiver --all # receiver mode receivers (sets PWM=6)
uws fan bind --mac aa:bb:cc:dd:ee:ff
uws fan unbind --mac aa:bb:cc:dd:ee:ff
uws fan identify --mac aa:bb:cc:dd:ee:ff # the device flashes
uws fan reboot-lcd --mac aa:bb:cc:dd:ee:ff
uws fan set-channel --channel 7
# Lighting
uws fan set-led --all --mode static --color 255,0,0
uws fan set-led --all --mode effect --effect meteor --speed 3
uws fan set-led --all --mode merge --effect wave
uws fan pwm-sync --all
uws fan pwm-sync --mac aa:bb:cc:dd:ee:ff --onceuws lcd list prints JSON rows that include a serial field—copy that value when invoking other LCD subcommands.
uws lcd list– enumerate TL LCD devices and show their USB serial numbers.uws lcd info --serial <usb-serial>– read the firmware version and the panel's group index.uws lcd send-jpg --serial <usb-serial> --file <image> [--raw] [--save]– show a JPEG or PNG. On the TL Wireless LCD the image is scaled to 400x400 and re-encoded as JPEG (quality 95, lowered until it fits in 100000 bytes), as the vendor app does;--rawsends the file unchanged;--savealso stores it as the image the panel shows at power-on.uws lcd play-video --serial <usb-serial> --file <video> [--fps N] [--loop]– decode a video with FFmpeg and send it frame by frame (TL Wireless LCD; default: the video's own frame rate).uws lcd sensor --serial <usb-serial> --metric cpu-temp|cpu-load|gpu-temp|gpu-load|fan-rpm|clock [--color blue|green|purple|red] [--fan <mac>] [--interval seconds] [--once] [--output preview.png]– show a live ring gauge (or a clock) on the TL Wireless LCD, updated every second like the vendor app's sensor screens. CPU temperature comes from hwmon (k10temp, zenpower or coretemp), GPU fromnvidia-smior amdgpu, fan speed from the RF receiver (the average of a group's running fans). Runs until Ctrl+C;--outputwrites one frame to a PNG instead.uws lcd keep-alive --serial <usb-serial> [--interval seconds]– send the vendor app's heartbeat (default every second) to keep the wireless panel awake.uws lcd control --serial <usb-serial> [--brightness 0-100] [--rotation 0|90|180|270]– on the TL Wireless LCD, change only the settings given. Brightness is sent as is (the vendor app's 0/25/50/75/100% steps send 0/10/30/40/100). On the wired TL LCD the fullLCDControlSettingis sent (--mode show-jpg|show-app-sync|lcd-test,--jpg-index N,--fps N,--test-color R,G,B; brightness defaults to 50, rotation to 0).uws fan list– fetch a snapshot of wireless receivers via the RF receiver (master controllers are listed bylist-masters).uws fan list-masters– enumerate master controllers and associated wireless receivers.uws fan set-fan --mac <aa:bb:..> --pwm <0-255> [--sequence-index N]– send a single shot PWM update to one receiver;--allsends it to every receiver bound to the attached master. The device number sent with it defaults to the device's position among the master's devices, as the vendor app does.uws fan bind --mac <aa:bb:..> [--rx-type 1-13]/uws fan unbind --mac <aa:bb:..>– bind to or unbind from the attached master; the master saves its configuration afterwards. A device that follows the motherboard keeps doing so after binding.uws fan identify --mac <aa:bb:..>– make the device flash so you can find it.uws fan set-channel --channel <1|7|11|15|17|21|25|29|31|33|35|39|8>– move every device bound to the attached controller to another RF channel (the vendor app's choices; 8 is its automatic default). Fan speeds and lighting are kept.- Commands reach every bound device, whichever controller it is bound to. Devices bound to a controller that is not attached receive short commands, but longer LED effects rarely get through to them; bind them to the attached controller (
fan unbind, thenfan bind) for reliable effects. uws fan reboot-lcd --mac <aa:bb:..>– restart the LCD panels of a TL Wireless LCD fan over RF.uws fan pwm-sync --mac|--all [--mode controller|receiver] [--interval seconds] [--once] [--sequence-index N]– synchronize receiver speeds.receiver(default) sets PWM=6 so the receiver tracks the motherboard header directly; as the vendor app, only for devices whose MAC ends ine1.controllerpolls motherboard PWM and replays the value via RF (--interval/--onceapply here).uws fan set-led --mac <aa:bb:..> --mode static|rainbow|frames|effect|random-effect– apply wireless LED effects. The effect is compressed (at most 12288 bytes, as the vendor app allows), sent, and resent until the device reports it; then the master saves its configuration.
-
static: requires--color R,G,Bor--color-list R,G,B;...to paint the LED strip once. -
rainbow: procedural rainbow; optional--frames N(default 24) and--interval-ms(default 50). -
frames: feed a JSON animation via--frames-file. Each frame is an array of[R, G, B]triples; seeexamples/tl_frames_sample.jsonfor a minimal illustration (the CLI will pad or truncate per device LED count). -
effect: drives any of the 29 TL presets, with the same frames the vendor app sends. Choose an effect with--effect <name>(e.g.twinkle,meteor_shower), adjust brightness 0‑255 via--effect-brightness, pick direction with--effect-direction 0|1(0 clockwise, the app's default), the speed level with--speed 1-5(default 4, the app's default), swap the front and behind halves with--flip(the app's up/down swap), and select which segment to update using--effect-scope front|behind|both(defaultboth; the two sides are combined as the app does).- Each effect starts with the colours the app's lighting page uses for it (e.g. purple, cyan, green and yellow for
static_color).--effect-colors R,G,B;...replaces them (up to four) for the nine computed effects:rainbow,rainbow_morph,static_color,breathing,runway,meteor,color_cycle,stackandtwinkle. - The other 20 are shipped as frames rendered by the vendor app with its default colours for each effect, for each fan count, direction and its 5 brightness levels (0, 64, 128, 192, 255; other brightness values use the closest level).
voice,meteor_showerandkaleidoscopeare random in the app; one rendering of each is shipped.
- Each effect starts with the colours the app's lighting page uses for it (e.g. purple, cyan, green and yellow for
-
merge: one effect running across fan groups, like the vendor app's merge mode (--all, or--order mac1,mac2,...for the sequence;--reverse mac,...runs it the other way on those groups). Merged effects:rainbow,static_color,breathing,runway,meteor,color_cycle,cover_cycle,wave,meteor_shower;rainbow_morphandtwinklerun on each group on its own, as in the app. Speed, brightness, direction and colours work as foreffect(merged effects step 12 ms per speed level). All groups are sent the effect before uws waits for them, so they start together. -
random-effect: picks a random preset each time; accepts the same brightness/direction/scope flags aseffect.Available effect names (case-insensitive):
rainbow,rainbow_morph,static_color,breathing,runway,meteor,color_cycle,staggered,tide,mixing,voice,door,render,ripple,reflect,tail_chasing,paint,ping_pong,stack,cover_cycle,wave,racing,lottery,intertwine,meteor_shower,collide,electric_current,kaleidoscope,twinkle.Example:
uws fan set-led --mac aa:bb:cc:dd:ee:ff --mode effect --effect twinkle --effect-brightness 180 --effect-direction 0 --effect-scope bothRandom example:
uws fan set-led --mac aa:bb:cc:dd:ee:ff --mode random-effect --effect-brightness 200 --effect-direction 1 -
uws fan pwm-sync --all|--mac [--mode controller|receiver] [--interval seconds] [--once] [--sequence-index N]– defaultreceivermode writes PWM=6 so fans follow the motherboard;controllermode polls and replays PWM from the motherboard (supports--interval/--oncefor polling loops;--sequence-indexapplies to receiver broadcasts).
hidapi(viahid) for TL LCD HID access.pyusbfor the RF sender/receiver WinUSB endpoints.pycryptodomexfor the DES-CBC transport used by the wireless LCD receiver.Pillowto prepare images for the LCD.FFmpeg(ffmpegandffprobeon the PATH) foruws lcd play-videoonly.
Each command expects the TL LCD USB display (vendor 0x04FC or 0x1CBE) and the wireless transmitter/receiver pair (vendor 0x0416) to be attached when the command executes.
Grant non-root access to the TL wireless dongles by adding /etc/udev/rules.d/99-tl-wireless.rules with:
# Winbond SLV3RX_V1.6 (receiver)
SUBSYSTEM=="usb", ATTR{idVendor}=="0416", ATTR{idProduct}=="8041", MODE="0666", GROUP="plugdev"
SUBSYSTEM=="usb_device", ATTR{idVendor}=="0416", ATTR{idProduct}=="8041", MODE="0666", GROUP="plugdev"
SUBSYSTEM=="usb_interface", ATTRS{idVendor}=="0416", ATTRS{idProduct}=="8041", MODE="0666", GROUP="plugdev"
# Winbond SLV3TX_V1.6 (transmitter)
SUBSYSTEM=="usb", ATTR{idVendor}=="0416", ATTR{idProduct}=="8040", MODE="0666", GROUP="plugdev"
SUBSYSTEM=="usb_device", ATTR{idVendor}=="0416", ATTR{idProduct}=="8040", MODE="0666", GROUP="plugdev"
SUBSYSTEM=="usb_interface", ATTRS{idVendor}=="0416", ATTRS{idProduct}=="8040", MODE="0666", GROUP="plugdev"
# Luminary Micro TL-LCD Wireless-1.3
SUBSYSTEM=="usb", ATTR{idVendor}=="1cbe", ATTR{idProduct}=="0006", MODE="0666", GROUP="plugdev"
SUBSYSTEM=="usb_device", ATTR{idVendor}=="1cbe", ATTR{idProduct}=="0006", MODE="0666", GROUP="plugdev"
SUBSYSTEM=="usb_interface", ATTRS{idVendor}=="1cbe", ATTRS{idProduct}=="0006", MODE="0666", GROUP="plugdev"
Reload the rules and replug the dongles:
sudo udevadm control --reload
sudo udevadm trigger
Released under the MIT License. See LICENSE for details.