Merge pull request #3 from urbanoanderson/development

Development

Author: urbanoanderson

.vscode/launch.json

@@ -0,0 +1,14 @@
+{
+    // Use IntelliSense to learn about possible attributes.
+    // Hover to view descriptions of existing attributes.
+    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "name": "C#: XinputWindowsManager Debug",
+            "type": "dotnet",
+            "request": "launch",
+            "projectPath": "${workspaceFolder}/XinputWindowsManager/XinputWindowsManager.csproj"
+        }
+    ]
+}

Images/help-screen.png

@@ -8,11 +8,15 @@
 
 ## About
 
-This system tray Windows 10 application allows the user to toggle a mouse mode by pressing a special button combination on an Xinput gamepad such as the Xbox One Controller. In this mode, the gamepad is able to freely move the cursor around the screen, perform left and right click actions as well as some useful keyboard presses.
+This system tray Windows application allows the user to toggle a desktop manager mode by pressing a special button combination on an Xinput gamepad such as the Xbox One Controller. In this mode, the gamepad is able to freely move the cursor around the screen, perform left and right click actions as well as some useful keyboard presses.
 
 The software was developed so that users with a desktop setup with only gamepad input or at least inconvenient access to keyboard and mouse can perform basic tasks that require these input methods using a gamepad. An example would be my case, where I use a desktop PC with Steam Big Picture in my living room as a DIY game console.
 
 <img src="Images/screenshot1.png" width="100%">
+Manager System tray menu
+
+<img src="Images/help-screen.png" caption="caption" width="100%">
+Help screen
 
 ## Installation
 
@@ -23,18 +27,43 @@ Optional - If you want the app to start with windows do the following:
 1. Create a shortcut of `"XinputWindowsManager.exe"`
 2. Place the shortcut inside the following folder: `"C:\Users\<YOURUSERNAME>\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Startup"`
 
+OR (if first option does not work for controlling desktop):
+1. Open Windows "Task Scheduler"
+2. Select "Create Task" with Trigger for "At startup" and action "Start a program"
+3. It might require selecting "Run with highest privilege" if it still does not launch
+
 ## Usage
 
-You can toggle mouse mode by right-clicking the system tray icon and selecting the toggle option or by pressing the following button combination on your xinput controller (player one):
+You can toggle manager mode by right-clicking the system tray icon and selecting the toggle option or by pressing the toggle button combination on your xinput controller (player one). Combination can be set in the config file and it defaults to:
 - `BACK` + `A` + `X`
 
 While in mouse mode, the following actions can be performed:
 - `Left analog stick`: controls mouse cursor movement;
 - `A`: performs left click;
 - `X`: performs right click;
+- `Y`: opens Windows Task Manager (CTRL+SHIFT+ESC);
+- `B`: presses ESC key;
+- `LS`: opens OnScreen Keyboard;
+- `RS`: sends mute command;
+- `LT`: presses Windows key;
+- `RT`: minimizes all apps (Win+D);
+- `LB+RB`: performs performs ALT+TAB;
+- `DPAD`: sends arrow keys from keyboard;
+- `Right analog stick UP/DOWN`: controls system volume;
+- `Right analog stick LEFT/RIGHT`: controls prev/next song;
+
+Other settings can be changes on 'XinputWindowsManager.dll.config' but default values should sufice on most cases.
 
 ## Release Notes
 
+### 2.0.0
+
+- Refactors codebase
+- Upgrade to .NET 8
+- Utilizes XInputium instead of SharpDX for Xinput control
+- Utilizes InputSimulatorCore for Keyboard/Mouse control
+- Implement a help screen and new shortcuts
+
 ### 1.0.0
 
 - Initial version

Images/screenshot1.png

@@ -0,0 +1,11 @@
+<configuration>
+  <appSettings>
+    <add key="START_ENABLED" value="false"/>
+    <add key="XINPUT_POLLING_DELAY_MSECS" value="8"/>
+    <add key="MAX_CURSOR_MOVEMENT_SPEED" value="18.0"/>
+    <add key="LEFT_STICK_THRESHOLD" value="0.15"/>
+    <add key="RIGHT_STICK_THRESHOLD" value="0.70"/>
+    <add key="TRIGGER_THRESHOLD" value="0.99"/>
+    <add key="TOGGLE_MANAGER_COMBINATION" value="A,X,BACK"/>
+  </appSettings>
+</configuration>

README.md

@@ -0,0 +1,63 @@
+using System;
+using System.Windows.Forms;
+
+namespace XinputWindowsManager
+{
+    public class HelpForm : Form
+    {
+        public HelpForm()
+        {
+            // Setup Help Form
+            Label label = new Label();
+            label.Text = "--- XINPUT WINDOWS MANAGER CONTROLS ---" + Environment.NewLine + Environment.NewLine
+                + "Left Stick => Mouse Movement" + Environment.NewLine
+                + "Left Stick Click => Launch Virtual Keyboard" + Environment.NewLine
+                + "A => Mouse Left Click" + Environment.NewLine
+                + "X => Mouse Right Click" + Environment.NewLine
+                + "Y => Launch Task Manager" + Environment.NewLine
+                + "B => Press ESC" + Environment.NewLine
+                + "BACK => Press ALT+F4" + Environment.NewLine
+                + "START => Press ENTER" + Environment.NewLine
+                + "LB => Press Alt" + Environment.NewLine
+                + "RB => Press Tab" + Environment.NewLine
+                + "LT => Press Windows Key" + Environment.NewLine
+                + "RT => Show Help Screen" + Environment.NewLine
+                + "Right Stick UP/DOWN => Control System Volume" + Environment.NewLine
+                + "Right Stick LEFT/RIGHT => Prev/Next Song" + Environment.NewLine
+                + "Right Stick Click => Mute System Sounds" + Environment.NewLine
+            ;
+            label.Size = new Size(300, 300);
+            label.Anchor = AnchorStyles.Left;
+            label.TextAlign = ContentAlignment.TopCenter;
+
+            this.Size = label.Size;
+            this.ShowInTaskbar = false;
+            this.ShowIcon = false;
+            this.ControlBox = false;
+            this.FormBorderStyle = FormBorderStyle.None;
+            this.StartPosition = FormStartPosition.CenterScreen;
+            this.Controls.Add(label);
+            this.SetVisibleCore(false);
+        }
+
+        protected override void OnLoad(EventArgs e)
+        {
+            this.Visible = false;
+            this.Opacity = 0;
+            this.ShowInTaskbar = false;
+
+            base.OnLoad(e);
+        }
+
+        protected override CreateParams CreateParams
+        {
+            get
+            {
+                CreateParams cp = base.CreateParams;
+                // turn on WS_EX_TOOLWINDOW style bit
+                cp.ExStyle |= 0x80;
+                return cp;
+            }
+        }
+    }
+}