Save the Current Mapping as a Named Profile¶
Save your current MIDI bindings under a name so you can recall them later or switch between controller layouts without re-learning every binding.
Before you start¶
- At least one binding must exist in the Bindings table. An empty mapping can be saved but is not useful.
- Open
Settings > MIDI Mapping...to reach the MIDI Controller Mapping dialog.
Steps¶
- Open
Settings > MIDI Mapping.... - Confirm that the Bindings table shows the bindings you want to save.
- In the Profile: field, type a name for the profile. The field accepts free text; it also shows existing profile names in its drop-down if any have been saved before.
- Click Save.
The profile is stored immediately. The Profile: drop-down is refreshed to include the new name.
What each control does¶
| Control | What it does | Setting key |
|---|---|---|
| Port: | Selects MIDI input device. | MidiPort |
| Refresh | Rescans available MIDI ports. | — |
| Connect | Opens/closes selected MIDI port. | — |
| Auto-connect on startup | Reopens MIDI port on launch. | MidiAutoConnect |
| Category | Filters parameter combo to a control category. Available categories: All, RX, TX, Phone/CW, EQ, Global, Mode, Band, Filter, Slice, Display, Frequency. | — |
| Parameter | Chooses the target parameter for a new binding. In v26.6.1, three momentary (Gate) actions are available in the Phone/CW category: "Trigger straight key" (id: cwkey), "Trigger CW Left Paddle" (id: cwdit), "Trigger CW Right Paddle" (id: cwdah). Legacy dotted IDs cw.key/cw.dit/cw.dah are auto-migrated on read. | — |
| Learn | Starts listening for the next MIDI message and binds it to the selected parameter. | — |
| Manual… | Opens a dialog to type a binding's channel, message type and number instead of using Learn mode. | New in v26.8.4 (#4760). Opens the same manual editor used by the per-row edit button. |
| Bindings table | Shows existing bindings with per-row Invert, Relative, edit (✎) and delete controls. Columns: Parameter, MIDI Source, Channel, Invert, Relative, (edit), (delete). | — |
| ✎ (edit binding) | Opens the manual editor to correct this binding's channel, type and number. | New in v26.8.4 (#4760). |
| Invert | Reverses the control direction for the row. | — |
| Relative | Treats the control as an endless encoder. | — |
| × (delete row) | Removes that binding. | — |
| Clear All | Removes every binding. | — |
| Profile: | Editable combo box. Type a new name to create a profile, or pick an existing name from the drop-down to overwrite it. | — |
| Save | Saves the current bindings under the name shown in Profile:. Does nothing if the field is empty. | — |
| Load | Replaces the current bindings with those stored under the selected profile name. | — |
| Import... | Imports a profile file into the store — AetherSDR profile XML or a SmartSDR ".map" file. Reports how many bindings were imported and lets the user Load to apply. | New in v26.8.4. |
| Export... | Exports the current bindings as an AetherSDR profile XML file. Remembered directory persisted under MidiImportExportPath. |
New in v26.8.4. |
| Close | Closes the dialog. | — |
Indicators¶
| Indicator | Meaning |
|---|---|
| Port status | Shows "Opened" or "Closed" to indicate whether the MIDI port is currently open. |
| Activity indicator | Shows the most recent MIDI message received. |
Tips¶
- Typing a name that already exists in Profile: and clicking Save overwrites that profile without a confirmation prompt.
- To keep bindings for different controllers separate, use a descriptive name such as the controller model or use case.
- The dialog remembers its window position and size between sessions.
Troubleshooting¶
- Clicking Save does nothing — The Profile: field is empty or contains only spaces. Type a name first.
- A profile name does not appear in the drop-down after saving — Click anywhere to dismiss the drop-down and reopen it; the list refreshes after each save.