Keyboard Shortcuts

Complete reference for keyboard controls

Overview

Keyboard shortcuts dramatically speed up your workflow in Ozen-web. This page lists all available shortcuts organized by category.

Tip

Tip: Print this page or keep it open in a second tab while learning Ozen-web.

Audio Playback

Key Action Notes
Space Play/pause selection If no selection, plays from cursor to end of visible window
Tab Play visible window Plays entire time range currently shown
Escape Stop playback & clear selection Stops audio and removes selection highlight

Editing (Annotations & Data Points)

Key Action Notes
Ctrl+Z Undo Mac: Cmd+Z
Ctrl+Y Redo Mac: Cmd+Shift+Z
Ctrl+Shift+Z Redo (alternative) Cross-platform consistency
Enter Save edited label When editing interval text
Escape Cancel label edit Discards changes to interval label
Delete Remove selected item Works on selected boundary or data point (if implemented)

Annotation Tiers

Key Action Notes
1 Select tier 1 Makes tier 1 active for editing
2 Select tier 2 Makes tier 2 active for editing
3 Select tier 3 Makes tier 3 active for editing
4 Select tier 4 Makes tier 4 active for editing
5 Select tier 5 Makes tier 5 active for editing
Double-click on tier Add boundary At cursor time position
Double-click on interval Edit label Opens text input for interval
Right-click on boundary Remove boundary menu Shows context menu
Drag boundary Move boundary Adjust boundary time position

Data Points

Key Action Notes
Double-click on spectrogram Add data point At clicked time/frequency
Drag data point Move data point Adjust time and/or frequency position
Right-click on data point Remove data point Shows context menu
Click data point Select & view values Values panel updates

Mouse & Click Actions

Action Result Location
Single Click Place cursor Waveform or spectrogram
Click & Drag Select time region Waveform or spectrogram
Double-click Add boundary Annotation tier
Double-click Edit interval label Annotation interval
Double-click Add data point Spectrogram (outside tiers)
Right-click Context menu Boundary or data point
Drag Move boundary/point Boundary line or data point
Scroll Wheel Zoom Waveform or spectrogram

Platform-Specific Shortcuts

Windows/Linux

Key Mac Equivalent
Ctrl Cmd
Alt Option

macOS

Most shortcuts use Cmd instead of Ctrl:

  • Undo: Cmd+Z
  • Redo: Cmd+Shift+Z
  • Pan: Cmd+Drag

Tips for Efficient Workflow

Tip

Master these shortcuts first:

  1. Space — Play selection (most used)
  2. Scroll Wheel — Zoom (essential for navigation)
  3. Ctrl+Z — Undo (safety net)
  4. Double-click — Add boundaries and data points
  5. 1-5 — Switch between annotation tiers

Typical Annotation Workflow

  1. Scroll Wheel — Zoom to see target region
  2. Click — Place cursor at boundary location
  3. Space — Play selection to verify
  4. Double-click tier — Add boundary
  5. Double-click interval — Edit label
  6. Enter — Save label
  7. Ctrl+Z — Undo if needed

Typical Data Collection Workflow

  1. Scroll Wheel — Zoom to vowel
  2. Click — Place cursor at vowel midpoint
  3. Space — Play to verify location
  4. Double-click spectrogram — Add data point
  5. Check values panel for measurements
  6. Repeat for all target segments

Customization

Currently, keyboard shortcuts are not customizable. This may change in future versions.

If you need different key bindings, please open an issue on GitHub.

Accessibility

Ozen-web aims to be keyboard-accessible for users who cannot use a mouse:

  • All major functions have keyboard shortcuts
  • Tab navigation works for UI controls
  • Screen reader support is limited (this is an area for improvement)

Suggestions for accessibility improvements are welcome! Please contribute feedback.

Quick Reference Card

Print-friendly quick reference:

Category Key Action
Playback Space Play selection
Tab Play window
Esc Stop
Navigate ←→ Pan left/right
↑↓ Zoom in/out
Wheel Zoom (centered on mouse)
Horizontal scroll Pan (trackpad)
Edit Ctrl+Z Undo
Ctrl+Y Redo
Ctrl+C Copy data points
Enter Save label
Tiers 1-5 Select tier
Dbl-click tier Add boundary
Dbl-click interval Edit label
Data Dbl-click spectrogram Add point
Right-click Remove
TipArrow Keys Work Everywhere

The arrow keys (←→ for panning, ↑↓ for zooming) work consistently across all browsers and operating systems, making them the most reliable navigation method.

Mobile/Touch

The mobile viewer (/viewer route) uses touch gestures instead of keyboard shortcuts:

  • Tap → Place cursor
  • Drag → Select region
  • Two-finger drag → Pan
  • Pinch → Zoom

See: Mobile Viewer Documentation

Next Steps

Back to top