Skip to content

Commit

Permalink
Updated Readme
Browse files Browse the repository at this point in the history
  • Loading branch information
ScreamingOranges committed Jun 29, 2021
1 parent efe5c42 commit 76970d2
Show file tree
Hide file tree
Showing 3 changed files with 21 additions and 23 deletions.
44 changes: 21 additions & 23 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,9 +9,9 @@ iCueConnect-Android is an Android app that allows you to control your Corsair iC
## Requirements
* You will need iCue installed and running on your windows machine.
* You will need to download and configure the iCueConnect-API on your windows machine.
* You will have to have configured all your Corsair devices through iCue.
* You will have to have configured all your Corsair devices through iCUE.
* In order for iCueConnect-Android App to communicate with [iCueConnect-API](https://github.com/ScreamingOranges/iCueConnect-API) and set the LEDs accordingly, both devices must be connected to the internet.
* Lastly you will have to check the **Enable SDK** option in iCue's Settings.
* Lastly you will have to check the **Enable SDK** option in iCUE's Settings.
<p align="center">
<img src="https://help.corsair.com/hc/article_attachments/360072361252/iCUE_SDK_enabled.jpg" width="800px">
</p>
Expand Down Expand Up @@ -45,38 +45,38 @@ iCueConnect uses Pusher for realtime communication between iCueConnect-Android A
5. Save these values. We will need them later.

### Configuring iCueConnect on Android
1. First make sure that you downloaded and configured the iCueConnect-API. **If you did not do this, the app will not work**.
2. Open iCueConnect on Android and click the settings icon in the top right corner. <img align="right" style="padding-left:20px" src="./readmeImages/settings_icon.jpg" width="200px">
1. Make sure that you downloaded and configured the iCueConnect-API. **If you did not do this, the app will not work**.
2. Open iCueConnect on Android and click Setting from the menu in the top right corner.
3. In the fields enter the associated values that we got from creating a Pusher account. <br/> **DO NOT ENTER THE QUOTATION MARKS, ONLY ENTER THE TEXT**
4. Click the **SAVE** button to set the values.
> Note: If you enter an incorrect value for any of the fields, simply update the values in the fields and click the **SAVE** button again.
## How To Use
When you first open the app you will be presented with the right most image.<br>
This is the main page where you can manually control your LEDs.<br>
When you first open the app you will be presented with the homepage.<br>
This is the main page where you can control your LEDs.<br>

<img align="right" style="padding-left:20px" src="./readmeImages/main_activity_default.jpg" width="250px">

### The Menu Bar
* The menu bar is the main way to navigate through out the app, and only has three buttons. <br><br>
<img src="./readmeImages/reset_control_icon.jpg" height="70px"> <img src="./readmeImages/help_icon.jpg" height="70px"> <img src="./readmeImages/settings_icon.jpg" height="70px">
* The menu bar is the main way to navigate throughout the app, and only has four buttons. <br>

1. **Revert Control**
* This reverts LED control back to iCue.
* For example, if you set the LEDs to a color using the **LIVE** or **SOLID** option, then they will stay that color unless you click this button.
2. **Help**
* For example, if you set the LEDs to a color, then they will stay that color unless you click this button.
2. **Sync Devices**
* This sends a request to the iCueConnect API for all the devices configured via iCUE. Once the information is received it populates the drop down.
3. **Help**
* This button redirects to a page shows the readme file for the iCueConnect-Android app.
3. **Settings**
4. **Settings**
* This button redirects to the previously mentioned [Setting Up Pusher](#setting-up-pusher) section.

### Controlling LEDs
1. Select an option from the dropdown below the **Enter RGB Values Below** title where the following options will appear.<br/>
* **Pulse** : Pulses the LEDs and then goes back to iCUE's selected color.
* **SOLID** : Sets the LEDs to color of your choice and stays that color.
* **LIVE** : This is works the same way that the SOLID option does, except that the color of your LEDs are automatically set.
2. Use the color wheel to select the color of your choice. You can preview the color of your choice via the color square.
3. Use the horizontal bar to select the brightness.
4. **(OPTIONAL)** Instead of using the color wheel and the brightness bar, you can enter RGB values in the input field. Each value should be from 0 to 255, and should be separated by a space. For example:
1. Select an option from the dropdown below the **Enter RGB Values Below** title where all your devices will appear. If only *All Devices* appears, then you will need to sync your devices (make sure the iCue Connect API is updated and running).<br/>
2. Toggle the *LIVE* switch to update your computers Leds in realtime.
> Note: Pusher limits you to 200,000 messages a day with the free plan, and using the *LIVE* option eats through that. You can check how many messages you sent under the *Overview* tab for your account's app on pusher's website.
3. Use the color wheel to select the color of your choice. You can preview the color of your choice via the color square.
4. Use the horizontal bar to select the brightness.
5. **(OPTIONAL)** Instead of using the color wheel and the brightness bar, you can enter RGB values in the input field. Each value should be from 0 to 255, and should be separated by a space. For example:
* Passing the color RED
```
255 0 0
Expand All @@ -89,14 +89,14 @@ This is the main page where you can manually control your LEDs.<br>
```
0 0 255
```
5. If you selected **LIVE** from the dropdown, then you can skip this step since the **UPDATE ICUE** button is pointless. However if you chose another option, then when you are done choosing a color either by the color wheel, or by the RGB Value input field, press the **UPDATE ICUE** button to set your LEDs to your color of choice.

### Notification LEDs
This option can be enabled from the **Notification Leds** option in the android app's settings page.


## Help
* Leds not updating according to your phones selection? Follow these trouble shooting steps.
* Select the **Test** button from the iCue Connect API.
* Make sure that iCue is running in the background and that the **Enable SDK** option is set in the settings.
* Sometimes iCue will need to be reopened. Try that.
* Make sure your Pusher credentials are correct on both devices.
Expand All @@ -112,10 +112,6 @@ This option can be enabled from the **Notification Leds** option in the android
## Disclaimer
**I do work for nor did I partner up with Corsair to produce this application. I am simply an enthusiast who just wanted to bring an idea to life.**

## Version History
* 1.0
* Initial Release

# For Developers

## Utilized Dependencies
Expand All @@ -126,7 +122,9 @@ This option can be enabled from the **Notification Leds** option in the android
* androidx.test.ext:junit:1.1.2
* androidx.test.espresso:espresso-core:3.3.0
* com.pusher:pusher-http-java:1.2.0
* com.pusher:pusher-java-client:2.2.6
* androidx.localbroadcastmanager:localbroadcastmanager:1.0.0
* com.google.code.gson:gson:2.8.6
* com.github.duanhong169:colorpicker:1.1.6
* androidx.palette:palette:1.0.0
* group: 'com.fasterxml.jackson.core', name: 'jackson-databind', version: '2.11.3'
Binary file modified readmeImages/main_activity_default.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified readmeImages/pusher_activity_field.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 76970d2

Please sign in to comment.