Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
cow-killer authored Jan 27, 2022
1 parent 15a5820 commit ea267b1
Showing 1 changed file with 7 additions and 9 deletions.
16 changes: 7 additions & 9 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,8 +3,8 @@
This program allows the user to adjust color and brightness to the various LEDs found throughout the DualSense (DS). Rainbow, disco, or otherwise random effects can be applied, though these are unstable. Also fetches battery percentage and displays this.

## Prerequisites (besides your DS, obviously)
* Linux-based operating system
* Access to root privileges (the program modifies the values found in `/sys/devices`)
* Linux-based operating system with kernel 5.12 or later
* Access to root privileges (the program modifies the values found in `/sys/devices/pci0000:00/(long string followed by a bunch of folders/`)
* Python 3
* GTK 3
* Tkinter
Expand All @@ -14,24 +14,22 @@ The program is highly unstable depending on what button you press, in particular
* Rainbow LED colors
* Disco/Progress bar LED patterns

Pressing any of those types of buttons (which have been labeled as unstable accordingly) will cause the program to loop indefinitely. You'll need to one of the following:
Clicking any of those buttons (which have been labeled as unstable accordingly) will cause the program to loop indefinitely. You'll need to one of the following:
* Press `Enter` in the terminal window to either close the application or keep it from looping
* force exit the application through your system monitor
* disconnect your DS

Other tasks going on on your computer will still run regardless.

## How To Use
1. Clone the repository, i.e. `git clone https://github.com/cow-killer/dualsense-led-configurator.git`
2. Run the script as root: `sudo python ds_led.py`
1. Clone the repository:<br>
`git clone https://github.com/cow-killer/dualsense-led-configurator.git`
2. Change into the `dualsense-led-configurator` folder and run the script as root:<br>
`sudo python ds_led.py`

## To-Do
* ~~Code is a mess, more than likely a way to reduce the amount of code needed~~ Thanks thats-the-joke!
* Much-needed UI polish
* Find a way to get rainbow LEDs, disco, etc. to work without hanging the application
**Update 2/13/2021:** only Rainbow needs to get fixed now
* ~~Add a color picker~~
* Add a way to extract MAC address without user interaction
* Update UI if controller is plugged/unplugged and if the percentage of the battery has changed

Pull requests welcomed!

0 comments on commit ea267b1

Please sign in to comment.