## Documentation
### Running xremap
You can choose between the following ways to run xremap. They are ordered by the easiest way first.
Each method has pros and cons, it's worth checking out the pages before choosing.
- [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)
- [Multi-purpose key (alias: tap-hold key)](use_case_multipurpose_key.md)
### Configuration file reference
- [Configuration options](reference_config_options.md)
- [Key names](reference_key_names.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)
- [FreeBSD](reference_freebsd.md)
### Troubleshooting
- [Troubleshooting](troubleshooting.md)
### Upgrade guide
- [Upgrade to v.0.15.0](../UPGRADE.md#Upgrade-to-v0.15)