Difference between revisions of "Initial Setup"

From JoyXoff Wiki
Jump to navigation Jump to search
m
 
(14 intermediate revisions by the same user not shown)
Line 7: Line 7:
#Select <code>Settings</code> option.
#Select <code>Settings</code> option.


===<code>Settings > General</code>===  
===General Settings===  
[[File:Settings Window - General.png|thumb|Settings > General]]
[[File:Settings Window - General.png|thumb|Settings > General]]
The General tab is where you configure the UI settings and control Joyxoff's behavior.
The General tab is where you configure the UI settings and control Joyxoff's behavior.
Line 14: Line 14:
*<code>Check for updates automatically</code> <br> Allow Joyxoff to check for updates automatically and notify you when a new version is available.<br><b>Remarks:</b> To allow update notifications you must check <code>Show balloons tips</code> option.
*<code>Check for updates automatically</code> <br> Allow Joyxoff to check for updates automatically and notify you when a new version is available.<br><b>Remarks:</b> To allow update notifications you must check <code>Show balloons tips</code> option.
*<code>Show balloons tips</code> <br> Allow Joyxoff to show notifications.
*<code>Show balloons tips</code> <br> Allow Joyxoff to show notifications.
*<code>Run on UAC prompts and sign-in screen</code> <br> Allows you to use Joyxoff on sign-in screen, UAC prompts and with some applications that require higher-level rights
*<code>Run on UAC prompts and sign-in screen</code> <br> Allows you to use Joyxoff on sign-in screen, UAC prompts and with some applications that require higher-level rights.
*<code>Languages</code> <br> Set UI language. <br> <b>Remarks:</b> Supported languages are <code>English US</code>, <code>Brazilian Portuguese (Português do Brasil)</code>, <code>Simplified Chinese (简体中文)</code>, <code>Traditional Chinese (繁體中文)</code>, <code>Japanese (日本語)</code> and <code>French (Français)</code>.
*<code>Use "Controller 1" only</code> <br> If this option is enabled, JoyXoff will only accept input from the first controller it finds.
*<code>Disable bindings on startup</code> <br> Prevent controller bindings from being activated on JoyXoff startup.
*<code>Languages</code> <br> Set UI language.


===<code>Settings > Profiles</code>===  
<b>Remarks:</b> If you want to use Joyxoff with applications that require higher-level rights, then the <code>Run on UAC prompts and sign-in screen</code> option must be checked. Otherwise, some Joyxoff functions may stop working. For security reasons, the User Interface Privilege Isolation (UIPI) restricts system interface to LocalSystem.
 
===Profiles Settings===  
[[File:Profileswindow.png|thumb|Settings > Profiles]]
[[File:Profileswindow.png|thumb|Settings > Profiles]]
The Profiles tab is where you can create profiles for programs/games.
The Profiles tab is where you can create profiles for programs/games.
Line 31: Line 35:
! Menu !! Description
! Menu !! Description
|-
|-
| Recent processes || List that shows the most recent processes. If you run a process with Joyxoff already running, the process will show up in this list when trying to add a new profile.
| Recent processes || List that shows the most recent processes. If you run a process with Joyxoff already running, the process will show up in this list.
|-
|-
| Browse || Browse for the executable file that you want to create a file for.
| Browse || Browse for the executable file that you want to create a profile for.
|}
|}


===<code>Settings > Mouse</code>===
===Mouse Settings===
The Mouse tab allows you to configure the mouse cursor/scroll sensitivity and acceleration.
The Mouse tab allows you to configure the mouse cursor/scroll sensitivity and acceleration.


===<code>Settings > Keyboard</code>===
===Keyboard Settings===
The Keyboard tab allows you to configure the keyboard repeat delay and repeat rate. When the option <code>Use the default system settings</code> is checked, Joyxoff simulates these values based on current keyboard settings in Windows.  
[[File:KbdSettingsTab.png|thumb|Settings > Keyboard]]
The Keyboard tab allows you to configure the keyboard repeat delay and repeat rate. When the option <code>Use the default system settings</code> is checked, Joyxoff simulates these values based on current keyboard settings in Windows.
 
<b>Remarks:</b> Changing these settings does not affect the existing physical keyboard settings.
 
*<code>Virtual keyboard mode</code> <br> Allows to choose between the two modes available: Spiral and Plain.
*<code>Virtual keyboard layout</code> <br> Allows to choose the virtual keyboard layout. The <code>Auto</code> option will select the current keyboard layout.
*<code>Color theme</code> <br> Allows to choose between the two themes available: Dark and Light.
*<code>Position</code> <br> Allows you to choose the virtual keyboard position.
*<code>Resize the active window automatically if the virtual keyboard is open</code> <br> When this option is enable, the foreground/active window will be resized so that it is not overlapped by the virtual keyboard.
*<code>Close the virtual keyboard automatically when the active window is changed</code> <br> When this option is enable, the virtual keyboard will be closed if the foreground/active window is changed.
*<code>Reverse spiral letter order</code> <br> Change the spiral letter order.
 
 
<b>Remarks:</b> The <code>Color theme</code> and  <code>Resize the active window automatically if the virtual keyboard is open</code> options only applies if <code>Virtual keyboard mode</code> is set to <code>Plain</code>.


<b>Remarks:</b> This configuration does not interfere with the existing physical keyboard settings.
===Advanced Settings===
===<code>Settings > Advanced</code>===
[[File:Advancedwindow.png|thumb|Settings > Advanced]]
[[File:Advancedwindow.png|thumb|Settings > Advanced]]
The Advanced tab is where you configure the left and right sticks deadzone and controller behaviors.<br>
The Advanced tab is where you configure the left and right sticks deadzone and controller behaviors.<br>
Line 50: Line 67:
*<code>Disable confirmation window to turn off the controller</code> <br> When this option is checked, the <code>Delay Rate</code> value is ignored.
*<code>Disable confirmation window to turn off the controller</code> <br> When this option is checked, the <code>Delay Rate</code> value is ignored.
*<code>Vibrate the controller when bindings are enabled/disable</code> <br> When this option is checked, the controller will vibrate when you toggle between <i>Enable and Disable bindings</i> function.
*<code>Vibrate the controller when bindings are enabled/disable</code> <br> When this option is checked, the controller will vibrate when you toggle between <i>Enable and Disable bindings</i> function.
*<code>Play sounds when bindings are enabled/disabled</code> <br> Triggers sounds indicating the activation or deactivation.
*<code>Turn off all controllers on Windows shutdown</code> <br> When this option is checked, Joyxoff will turn off all connected controllers on Windows shutdown/sleep/restart. <br> <b>Remarks:</b> exclusive for Xbox 360 controllers.
*<code>Turn off all controllers on Windows shutdown</code> <br> When this option is checked, Joyxoff will turn off all connected controllers on Windows shutdown/sleep/restart. <br> <b>Remarks:</b> exclusive for Xbox 360 controllers.


<b>Remarks:</b> It is very important to configure the stick deadzone, otherwise you may experience some erratic mouse behavior (e.g. mouse moving on its own).
<b>Remarks:</b> It is very important to configure the stick deadzone, otherwise you may experience some erratic mouse behavior (e.g. mouse moving on its own).


===<code>Settings > About</code>===
===About/Updater===
[[File:Aboutwindow.png|thumb|Settings > About / Update]]
[[File:Aboutwindow.png|thumb|Settings > About / Update]]
The About tab is where you can check for update and download the latest version.
The About tab is where you can check for update and download the latest version.
Line 61: Line 79:


==Configuration files==
==Configuration files==
All configuration files are stored in <code>"%ProgramData%\Joyxoff"</code>.
All configuration files are stored in <code>%ProgramData%\Joyxoff</code>.
''ProgramData'' is hidden by default. If you are unable to see this location then please follow the instructions provided by Microsoft to show hidden files: https://windows.microsoft.com/en-us/windows/show-hidden-files#show-hidden-files=windows-7
The ''ProgramData'' folder is hidden by default. If you are unable to see this location then please follow the instructions provided by Microsoft to show hidden files: https://windows.microsoft.com/en-us/windows/show-hidden-files#show-hidden-files


===Files Description===
===Files Description===
Line 78: Line 96:
|}
|}


<b>Remarks:</b> If for some reason you experience erratic behaviors or any issues,
<b>Remarks:</b> If for some reason you experience any issues, try the following steps:
#Close Joyxoff.
#Close Joyxoff.
#Make a backup of these files and then delete them all.
#Make a backup of these files and then delete them all.
#Restart Joyxoff and the files will be recreated.
#Restart Joyxoff and the files will be recreated.
Still, if the issue persists, please [http://mailto:diegoferracini@joyxoff.com report to us].
Still, if the issue persists, please report it to [mailto:diegoferracini@joyxoff.com diegoferracini@joyxoff.com].


[[Category:Overview]]
[[Category:Overview]]

Latest revision as of 10:14, 21 August 2023

Settings[edit]

The settings window is the main interface of Joyxoff. From there, you can determine how you would like Joyxoff to run and customize the features available within it.

How to Open The Settings Window[edit]

By default, the settings window will pop up right after the Joyxoff installation. To manually access the Settings window, do the following:

  1. Right-click on the Joyxoff icon located in the system tray.
  2. Select Settings option.

General Settings[edit]

Settings > General

The General tab is where you configure the UI settings and control Joyxoff's behavior.

  • Run on Windows startup
    Allow Joyxoff to automatically launch when you turn on your computer.
  • Check for updates automatically
    Allow Joyxoff to check for updates automatically and notify you when a new version is available.
    Remarks: To allow update notifications you must check Show balloons tips option.
  • Show balloons tips
    Allow Joyxoff to show notifications.
  • Run on UAC prompts and sign-in screen
    Allows you to use Joyxoff on sign-in screen, UAC prompts and with some applications that require higher-level rights.
  • Use "Controller 1" only
    If this option is enabled, JoyXoff will only accept input from the first controller it finds.
  • Disable bindings on startup
    Prevent controller bindings from being activated on JoyXoff startup.
  • Languages
    Set UI language.

Remarks: If you want to use Joyxoff with applications that require higher-level rights, then the Run on UAC prompts and sign-in screen option must be checked. Otherwise, some Joyxoff functions may stop working. For security reasons, the User Interface Privilege Isolation (UIPI) restricts system interface to LocalSystem.

Profiles Settings[edit]

Settings > Profiles

The Profiles tab is where you can create profiles for programs/games.

  • Desktop bindings
    This is the global profile. Any binding set in this profile applies to all processes that have not been added to Process bindings.
  • Virtual keyboard
    Virtual keyboard profile.
  • [ + ]
    Adds a new profile.

[ + ] Description[edit]

Menu Description
Recent processes List that shows the most recent processes. If you run a process with Joyxoff already running, the process will show up in this list.
Browse Browse for the executable file that you want to create a profile for.

Mouse Settings[edit]

The Mouse tab allows you to configure the mouse cursor/scroll sensitivity and acceleration.

Keyboard Settings[edit]

Settings > Keyboard

The Keyboard tab allows you to configure the keyboard repeat delay and repeat rate. When the option Use the default system settings is checked, Joyxoff simulates these values based on current keyboard settings in Windows.

Remarks: Changing these settings does not affect the existing physical keyboard settings.

  • Virtual keyboard mode
    Allows to choose between the two modes available: Spiral and Plain.
  • Virtual keyboard layout
    Allows to choose the virtual keyboard layout. The Auto option will select the current keyboard layout.
  • Color theme
    Allows to choose between the two themes available: Dark and Light.
  • Position
    Allows you to choose the virtual keyboard position.
  • Resize the active window automatically if the virtual keyboard is open
    When this option is enable, the foreground/active window will be resized so that it is not overlapped by the virtual keyboard.
  • Close the virtual keyboard automatically when the active window is changed
    When this option is enable, the virtual keyboard will be closed if the foreground/active window is changed.
  • Reverse spiral letter order
    Change the spiral letter order.


Remarks: The Color theme and Resize the active window automatically if the virtual keyboard is open options only applies if Virtual keyboard mode is set to Plain.

Advanced Settings[edit]

Settings > Advanced

The Advanced tab is where you configure the left and right sticks deadzone and controller behaviors.

  • Delay rate (in milliseconds) to turn off or show confirmation window when the binding button is held
    This value is relative to the function Turn off Controller (Xbox 360) that pops up a window to confirm if you want to turn off the controller.
  • Disable confirmation window to turn off the controller
    When this option is checked, the Delay Rate value is ignored.
  • Vibrate the controller when bindings are enabled/disable
    When this option is checked, the controller will vibrate when you toggle between Enable and Disable bindings function.
  • Play sounds when bindings are enabled/disabled
    Triggers sounds indicating the activation or deactivation.
  • Turn off all controllers on Windows shutdown
    When this option is checked, Joyxoff will turn off all connected controllers on Windows shutdown/sleep/restart.
    Remarks: exclusive for Xbox 360 controllers.

Remarks: It is very important to configure the stick deadzone, otherwise you may experience some erratic mouse behavior (e.g. mouse moving on its own).

About/Updater[edit]

Settings > About / Update

The About tab is where you can check for update and download the latest version.

Remarks: It is highly recommended that you update Joyxoff using this module to avoid any trickery or unwanted results. Joyxoff uses SHA-256 hashing for data integrity validation.

Configuration files[edit]

All configuration files are stored in %ProgramData%\Joyxoff. The ProgramData folder is hidden by default. If you are unable to see this location then please follow the instructions provided by Microsoft to show hidden files: https://windows.microsoft.com/en-us/windows/show-hidden-files#show-hidden-files

Files Description[edit]

Filename Data Description
bindings.bin Bindings.
config.bin Settings.
pfslist.bin Fullscreen state per process list.
state.bin Controller state.

Remarks: If for some reason you experience any issues, try the following steps:

  1. Close Joyxoff.
  2. Make a backup of these files and then delete them all.
  3. Restart Joyxoff and the files will be recreated.

Still, if the issue persists, please report it to diegoferracini@joyxoff.com.