## Documentation
### Running xremap
You can choose between the following ways to run xremap. They are ordered by the easiest way first.
- [Running with sudo](running_with_sudo.md)
- [Running without sudo](running_without_sudo.md)
- [Running as a user service](running_as_user_service.md)
- [Running as a system service](running_as_system_service.md)
### Use cases
- [Use normal key as modifier](use_case_virtual_modifer.md)
### Configuration file reference
- [Configuration options](reference_config_options.md)
- [Actions](reference_actions.md)
- [Multi-purpose key (alias: tap-hold key)](reference_multipurpose_key.md)
- [Press/release key](reference_press_release_key.md)
### Experimental features
- [Double tap](reference_double_tap.md)
- [Chords (simultaneous keys)](reference_chords.md)
### Troubleshooting
- [Troubleshooting](troubleshooting.md)
### Upgrade guide
- [Upgrade to v.0.15.0](../UPGRADE.md#Upgrade-to-v0.15)