First launch

First launch

So, you have installed reWASD. Now what?

First launch

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

  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:

    First Launch

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

    First Launch

  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:

    First Launch

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

    First Launch

  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:

    First Launch

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

    First Launch

    • 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:

    First Launch

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

    First Launch

  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:

    First Launch

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

    First Launch

    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:

    First Launch

  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:

    First Launch

  10. If you have 2 or more same-type devices (gamepads, keyboards or mice), sub-configs will apply to them according to the order in the Group. So, the Gamepad config will be applied to the first Gamepad in the group, Gamepad 2 — to the second one, Gamepad 3 — to the third one, etc. The same principle applies to keyboards and mice.

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