# Command Reference

## The main &kappname; window

### The File Menu

&Ctrl;N File New

- Creates a new sound

&Ctrl;O File Open

- Opens an existing sound

File Open Recent

- Opens a recently used sound. A list of recently opened sounds are displayed in a sub-menu. Click one of these to open it.

&Ctrl;S File Save

- Saves the current sound

File Save As

- Saves the current sound under a different name

&Ctrl;W File Close

- Closes the current window. If this is the last window, &kappname; will exit.

&Ctrl;Q File Quit

- Quits &kappname;

### The Edit Menu

&Ctrl;U Edit Undo

- Revert the last action. Up to 20 actions can be undone

&Ctrl;&Shift;Z Edit Redo

- Redo the last action that was undone

&Ctrl;X Edit Cut

- Remove the current selection from the sound and place it on the clipboard.

&Ctrl;C Edit Copy

- Copy the current selection to the clipboard.

&Ctrl;V Edit Paste

- Paste the clipboard contents at the current cursor position. If there is an active selection, it will be replaced.

Delete Edit Delete

- Delete the current selection

&Shift;Delete Edit Crop

- Crop the sound to the current selection.

&Ctrl;A Edit Select All

- Select the entire sound.

&Ctrl;&Shift;A Edit Select None

- Clear the current selection.

### The View Menu

&Ctrl;+ View Zoom In

- Increase the zoom level.

&Ctrl;- View Zoom Out

- Decrease the zoom level.

View Time Format

- Change the format times are displayed in. The following formats are available:

  - Samples

  - Time

  - Milliseconds

  - CDDA Frames (75 frames/second)

  - PAL Frames (25 frames/second)

  - NTSC Frames (29.97 frames/second)

View Scale Format

- Change the format scale labels are displayed in. The following formats are available:

  - Normalised (-1.0 to 1.0)

  - Real (-128 to 127 for 8-bit files, -32768 to 32768 for 16-bit files and -2^24 to 2^24-1 for 32-bit files)

  - dB

View Display

- Change the way sounds are displayed. The following displays are available by default:

  - Normal: Signal value / Time

  - Spectral: Frequency response / Time

  Other plugins may add new display types.

### The Format Menu

Plugins that change the format of the sound will appear in this menu. The default soniK installation includes:

Format Format

- Change the format of the current sound. Opens a dialog box that allows you to change the number of channels, sample rate and resolution (bits per sample) of the current sound.

Format Channels Convert To Mono

- Convert the current sound from Stereo to Mono. Opens a dialog box that allows you to select which channel to keep or whether to mix the channels together.

Format Channels Convert To Stereo

- Convert the current sound from Mono to Stereo. Opens a dialog box that allows you to select how to fill the new channel.

Format Channels Insert

- Add channels to the sound. Opens a dialog box that allows you to select how many channels to add and which channel to add the after.

Format Channels Remove

- Remove channels from the sound. Opens a dialog box that allows you to select how many channels to remove and which channel to start removing from.

### The Transform Menu

Plugins that change the content of the sound will appear in this menu. The default soniK installation includes:

Transform Amplitude Amplify

- Increase or decrease the volume of the sound.

Transform Amplitude Fade In

- Increase the volume of the sound as time increases.

Transform Amplitude Fade Out

- Decrease the volume of the sound as time increases.

Transform Reverse

- Reverse the sound.

LADSPA plugins will also be shown in this menu. Please see the documentation supplied with these plugins.

### The Generate Menu

Plugins that create new sounds will appear in this menu. The default soniK installation includes:

Generate Silence

- Generate a period of silence.

Generate Simple

- Generate a simple waveform (sine, square or saw).

### The Play Menu

&Ctrl;Home Play Start

- Move audio playback position to start of sound or selection.

&Ctrl;Left Play Left

- Move audio playback position backward.

&Ctrl;Right Play Forward

- Move audio playback position forward.

&Ctrl;End Play End

- Move audio playback position to end of sound or selection.

&Ctrl;&Enter; Play Play

- Start audio playback.

&Ctrl;&Shift;&Enter; Play Play Looped

- Start looped audio playback. Playback will return to the start of the sound or selection when the end is reached.

&Ctrl;P Play Pause

- Pause or resume audio playback.

&Ctrl;S Play Stop

- Stop audio playback.

&Ctrl;R Play Record

- Record new sounds. A dialog box will be opened to control the recording.

### The Settings Menu

Settings Show Toolbar

- Show or hide the main toolbar.

Settings Hide Statusbar

- Show or hide the status bar.

Settings Configure Shortcuts

- Change the keys to press to perform actions in soniK.

Settings Configure Toolbars

- Configure the icons shown in the toolbars.

Settings Configure Shortcuts

- Change the keys to press to perform actions in soniK.

Settings Configure soniK

- Configure the behaviour of soniK.

### The Help Menu

&help.menu.documentation;

### Keys

In addition to those associated with menu items, the following keys can also be used:

Left

- Move the cursor left.

Right

- Move the cursor right.

Page Up

- Move the cursor left by 10x Left.

Page Down

- Move the cursor right by 10x Right.

Home

- Move the cursor to the start of the sound.

End

- Move the cursor to the end of the sound.

&Shift;Left

- Move the selection edge left.

&Shift;Right

- Move the selection edge right.

&Shift;Page Up

- Move the selection edge left by 10x &Shift;Left.

&Shift;Page Down

- Move the selection edge right by 10x &Shift;Right.

&Shift;Home

- Move the selection edge to the start of the sound.

&Shift;End

- Move the selection edge to the end of the sound.

&Ctrl;Left

- Scroll the display to the left.

&Ctrl;Right

- Scroll the display to the right.

&Ctrl;Page Up

- Scroll the display to the left by 10x &Ctrl;Left.

&Ctrl;Page Down

- Scroll the display to the right by 10x &Ctrl;Right.

&Ctrl;Home

- Scroll the display to the start of the sound.

&Ctrl;End

- Scroll the display to the end of the sound.

### Mouse

The following mouse actions can be used:

Left click

- Place the cursor at the current mouse position.

Left drag

- Select the region of the sound between the point where the left button was pressed and the point where it was released. Can also be used to adjust the selection edges.

&Shift;Left drag

- Move the selection, keeping its length the same.

Wheel Up

- Zoom in.

Wheel Down

- Zoom out.

&Shift;Wheel Up

- Scroll left.

&Shift;Wheel Down

- Scroll right.