---
title: How to use a Custom Key Mapping File in Cycle
description: Cycle has the ability to use a custom key mapping file for its terminal interactions.
---

[Skip to content](https://kb.cyclelabs.io/how-to-use-a-custom-key-mapping-file-in-cycle#main-content)

English - United States

Show submenu for translations

![](https://kb.cyclelabs.io/hs-fs/hubfs/main-lockup-color-Aug-11-2026-06-33-05-0386-PM.png?width=500&height=93&name=main-lockup-color-Aug-11-2026-06-33-05-0386-PM.png)

Open main navigation

Close main navigation

- English - United States
  
  Show submenu for translations
- [Get Support & Track Tickets](https://help.cyclelabs.io/)

[Get Support & Track Tickets](https://help.cyclelabs.io/?hsLang=en-us)

 How can we help you?

- There are no suggestions because the search field is empty.

1. [Cycle Knowledge Base](https://kb.cyclelabs.io/?hsLang=en-us)
2. [Tips and Tricks](https://kb.cyclelabs.io/tips-and-tricks?hsLang=en-us)

# How to use a Custom Key Mapping File in Cycle

## Cycle has the ability to use a custom key mapping file for its terminal interactions.

Some applications that Cycle interacts with require key presses beyond what can be done from the standard key mapping. Examples of this might include F keys higher than F12. In order to use such keys, Cycle can be pointed at a custom key mapping file.

The format of these files should take is a CSV with no header row and 2 columns:

> ![](https://kb.cyclelabs.io/hubfs/Knowledge%20Base%20Import/edbsnee92f6a563e9a798d93f013019cc9d651e929bdbac8de70033f3ebce2b70f8dc9bc1e79698d4ff4a2239492d5cb788fb.png)

This setting is located in the **Project Settings** area under **Device Settings**.

> ![](https://kb.cyclelabs.io/hubfs/Knowledge%20Base%20Import/edbsn238dbdd08be451341963ff2c089bee8a0cbcbd11979fec9389960aac72c86820493cc9a17de86a7ae9dd8a6aa75ce360.png)

### Commonly Used Alternative Key Mapping Files

The following list of known key mapping files are available for download and use within Cycle:

- MGT
- RXVT
- SCREEN
- VT100
- VT100Plus
- VT220
- xTermFree86
- xTermX11R6

- [Getting started](https://kb.cyclelabs.io/getting-started?hsLang=en-us)
- [Using Cycle with BYWMS](https://kb.cyclelabs.io/using-cycle-with-bywms?hsLang=en-us)
- [Cycle Appliance and CI/CD](https://kb.cyclelabs.io/cycle-appliance-and-ci-cd?hsLang=en-us)
- [Tips and Tricks](https://kb.cyclelabs.io/tips-and-tricks?hsLang=en-us)
- [Native App](https://kb.cyclelabs.io/native-app?hsLang=en-us)
- [Deprecated Steps](https://kb.cyclelabs.io/deprecated-steps?hsLang=en-us)
- [Common Issues](https://kb.cyclelabs.io/common-issues?hsLang=en-us)

[![](https://kb.cyclelabs.io/hs-fs/hubfs/main-lockup-color-Aug-11-2026-06-33-05-0386-PM.png?width=500&height=93&name=main-lockup-color-Aug-11-2026-06-33-05-0386-PM.png)](http://cyclelabs.io)

<https://www.facebook.com/> <https://www.twitter.com/> <https://www.instagram.com/> <https://podcasts.apple.com/> [mailto:email@email.com](mailto:email@email.com)

Copyright © 2026, Cycle Labs