First launch

So, you have installed reWASD. Now what?

On the right side you see a Profile panel:

• Profile is an element that contains configs, usually, one profile is created for one game.
• Config is the file that contains all the mappings and layout modifications you add.

In the file system, Profile is a folder, and Config is a file.

Below the device's image is the Device panel: here are all the devices you can initialize, group, and remap. You can also see two icons on the right of the devices list:

• reWASD Junior — shows where to download an application for Android or iOS
• Device Detection icon — helps you during Device initialization (for keyboards and mice only)

Top-right corner gives access to License information, Help (you are here), and Preferences.

In the center of the screen, you see an active (chosen) device and several quick options that will help you manage it.

Short guide

1. Choose the device you want to remap
2. Pick an existing Game Profile or create one
3. Add the desired mappings and Apply changes, or Apply a previously created config right away

To get more in-depth with reWASD interface, check out the Workspace article.

Longer guide

The next step may differ depending on how you plan to use reWASD:

• I want to remap a controller
• I need to remap mouse and keyboard
• I want to use several different devices at the same time, and only have one output visible for games

I want to remap a controller

1. Connect your gamepad to PC, find and choose it in the Device panel

2. Choose the Profile, or create one. The Config is created automatically

   If you don’t feel like customizing the layout from scratch, click on Check Community configs. There are numerous pre-made configs shared by our users.

3. Now, what input should reWASD emulate for you?

   1. If you wish reWASD to emulate mouse and keyboard inputs, choose a controller button and pick the mapping from reWASD mapping list

   2. If you want to emulate the other controller type, click the Magic Wand and choose the disguise for your gamepad: Xbox 360, Xbox One, DualShock 4, DualShock 3 or Switch Pro

4. If emulation doesn’t sound fun we have two ways to apply your config when reWASD won't emulate any devices, but your controller will be remapped:
   
   4.1. Click the Magic Wand icon and ensure that your physical gamepad is selected. Utilize only gamepad mappings from the reWASD mappings list. Find more details on how to apply mappings to your physical gamepad.
   
   4.2. Use Native menu to reassign the controller buttons.

5. Once the layout is done, press Apply in the lower-left corner, and enjoy!

I need to remap mouse and keyboard

1. If you see at least one device with a [?] in the Device panel, you should start with Device initialization. Choose the device with [?], then you will see a screen like this:

2. To properly define which device this is, click the Device Detection icon:

3. With Detection mode on, reWASD will light up the device you are pressing your buttons on. Now press the buttons on keyboard, if the chosen device lights up — choose Gaming keyboard or Keyboard with touchpad option. If you press mouse buttons, and the active device lights up — choose Mouse with programmable buttons option.

4. Click Submit, and repeat initialization until both keyboard and mouse you want to use in-game are initialized

5. Once you’re done, Group mouse and keyboard together: choose either one of them, click on Group button below the image of the device:

6. A Group window opens. Choose the second device from the drop-down list, and press Save:

7. Time to remap! Or, use one of the pre-made configs. Click Check Community configs to look for the configurations made by other users. They are sorted by game, so you can look up the exact game you will play, and choose a config you like the most.

8. If you wish to create a config from scratch, add a new Game Profile, and assign all the needed mappings in Keyboard and Mouse sub-configs:

9. Change the virtual controller type in the Virtual controller settings:

   • When remapping Mouse moves to Virtual Stick, we suggest you Mute the native mouse input, and avoid double-input in games. Find out how to bring native mouse behavior back from the Working with a muted mouse article.
   • To customize the way Virtual stick works, make sure to check out the video guide.

I want to use several different devices at the same time, and only have one output visible for games

1. If you see at least one device with a [?] in the Device panel, you should start with Device initialization. Choose the device with [?], then you will see a screen like this:

2. To properly define which device this is, click Device Detection icon:

3. With Detection mode on, reWASD will light up the device you are pressing your buttons on. Now press the buttons on keyboard, if the chosen device lights up — choose Gaming keyboard or Keyboard with touchpad option. If you press mouse buttons, and the active device lights up — choose Mouse with programmable buttons option.

4. Click Submit, and repeat initialization until both keyboard and/or mouse you want to use in-game are initialized

5. Once you’re done, Group the devices you want to use: choose either one of them, click on Group button below the image of the device:

6. Now choose up to 3 more devices from the drop-down list to create a Group. Press Save icon to proceed further:

   All the devices in one group will represent one Virtual controller, so any mappings you add further will be executed on its behalf. To execute Virtual keyboard and mouse mappings on behalf of your physical keyboard and mouse, visit Preferences — Input Devices.

7. Since this group is custom, most likely you will need to create config from scratch. Doesn’t hurt trying your luck in the Community though.

8. Create a new Game Profile, then make sure you have enough sub-configs for all the devices in the group. Pay attention to the panel on the top of the screen:

9. Gamepad, Keyboard and Mouse are the basic sub-configs and they cannot be removed. To add more sub-configs, click the + sign and choose the type of the sub-config:

10. If you have two or more devices of the same type (gamepads, keyboards, or mice) and apply one sub-config, it will affect every device in the group. You can preview how your sub-config will affect the behavior of every device by selecting the device icon. 

    Split sub-config to create different sub-configs that may affect devices in a group in different ways. All sub-configs will be applied to the devices based on their order in the group and will inherit the device's name. You can also choose the preferred sub-config and merge all sub-configurations from the same type of device into the selected one.
    

    This same principle applies to keyboards and mice.

11. Once all the mappings are added, Apply the config and have fun!