aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'README.md')
-rw-r--r--README.md99
1 files changed, 99 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..f6f57a7
--- /dev/null
+++ b/README.md
@@ -0,0 +1,99 @@
+# DeepCool Display Linux
+
+This application is a replacement of the original DeepCool Windows application for the LP360 AIO cooler. I may add support for the entire LP series and any other new devices that use a similar pixel display. This currently only supports drawing custom patterns on the display. Support for displaying CPU temprature and usage will be added in future releases.
+
+Special thanks to [@Nortank12](https://github.com/Nortank12) for his work on [deepcool-digital-linux](https://github.com/Nortank12/deepcool-digital-linux). I would recommend checking out his app for additional functionality and support for other devices. Additionally, thanks to [@rohan09-raj](https://github.com/rohan09-raj) for figuring out the logic of the commands for creating the patterns.
+
+## Installation
+
+1. Locate your directory, it can be /lib/udev/rules.d or /etc/udev/rules.d and create a new file named 99-deepcool.rules.
+ ```bash
+ sudo nano /etc/udev/rules.d/99-deepcool.rules
+ ```
+2. Insert the following:
+ ```bash
+SUBSYSTEM=="usb", ATTRS{idVendor}=="3633", ATTRS{idProduct}=="000c", GROUP="plugdev"
+ ```
+3. Ensure that your user is part of the plugdev group:
+ ```bash
+ sudo usermod -aG plugdev $USER
+ ```
+4. Reboot your system.
+5. Download the latest [release](https://github.com/Blaster4385/deepcool-display-linux/releases/latest) and run it.
+
+## Usage
+
+You can run the applications with or without providing any options. Running it without any options will launch the GUI.
+
+```bash
+./deepcool-display-linux [OPTIONS]
+```
+
+```
+Options:
+ -d, --daemon Run the application in daemon mode
+ -f, --file Specify the CSV file containing the pattern data (This is required in daemon mode)
+
+Commands:
+ -h, --help Print help
+ -v, --version Print version
+```
+### Daemon Mode
+Run the application in daemon mode to display the pattern from a CSV file:
+
+```bash
+./deepcool-display-linux -d -f /path/to/pattern.csv
+```
+
+In daemon mode, the \`-f\` or \`--file\` flag is required to specify the CSV file containing the pattern.
+
+### Exporting patterns to CSV
+
+The GUI has an option to export the current pattern to a CSV file. This can be done by clicking the "Export Layout" button. The CSV files are stored in ~/.config/deepcool-display-linux.
+
+## Development
+
+This application is built using [Wails](https://wails.io).
+
+You can build the application from source by following the steps below.
+
+### Dependencies
+
+You need to install go, npm, and wails.
+
+On Arch Linux, you can use a AUR helper to install them:
+
+```bash
+yay -S go npm wails
+```
+### Building
+
+1. Clone the repository:
+
+```bash
+git clone https://github.com/Blaster4385/deepcool-display-linux
+```
+
+2. Open the directory:
+
+```bash
+cd deepcool-display-linux
+```
+3. Run a development server:
+
+```bash
+make dev
+```
+4. Build a release:
+
+```bash
+make build
+```
+5. Clean up:
+
+```bash
+make clean
+```
+## License
+
+This project is licensed under the GPLv2 License - see the [LICENSE](LICENSE) file for details.