Skip to content

Keyboard Navigation & TV Mode

Peek provides complete keyboard navigation, making it perfect for TV remotes, wireless keyboards, or couch browsing.

Why Keyboard Navigation?

  • TV Mode - Use Peek on your TV with just a remote
  • Accessibility - Full keyboard support for users who prefer or require it
  • Efficiency - Navigate faster without reaching for the mouse
  • Couch Browsing - Control everything from your couch with a wireless keyboard

Primary Navigation Keys

Key Action
Tab Move to next focusable element
Shift+Tab Move to previous focusable element
Enter Activate/click the focused element
Space Activate buttons (also play/pause in video player)
Escape Go back or close modals

Arrow Key Navigation

Arrow keys navigate through grid layouts and lists:

Key Action
↑ Move focus up (in grids and lists)
↓ Move focus down (in grids and lists)
← Move focus left (in grids)
→ Move focus right (in grids)

Grid Navigation: - Scene grids automatically respond to arrow keys - Focus moves intelligently between rows and columns - Works on Scenes, Performers, Studios, Tags pages

List Navigation: - Arrow up/down navigates vertical lists - Works in playlists, search results, settings

Scene Browsing

Scene Grid Navigation

Navigating scene cards:

  1. Use Tab or arrow keys to focus a scene card
  2. Press Enter to open the scene detail page
  3. Press Escape to go back to the grid

Quick actions on scene cards:

Key Action
Enter Open scene detail page
P Play scene immediately (when focused)
+ Add to playlist (opens playlist selector)
F Toggle favorite (when supported)

Scene Detail Page

While viewing scene details:

Key Action
Space or Enter Play video
Escape Return to previous page
Tab Navigate between action buttons

Video Player Controls

Playback Controls

Key Action
Space or K Play/Pause
← Seek backward 10 seconds
→ Seek forward 10 seconds
Shift+← Seek backward 5 seconds
Shift+→ Seek forward 5 seconds
Home Jump to beginning
End Jump to end
0-9 Jump to 0%-90% of video

Examples: - Press 5 to jump to 50% of the video - Press 0 to jump to the start - Press 9 to jump to 90%

Volume Controls

Key Action
↑ Increase volume
↓ Decrease volume
M Mute/unmute

Display Controls

Key Action
F Toggle fullscreen
Escape Exit fullscreen
T Toggle theater mode (when available)

Playlist Playback

While playing a playlist:

Key Action
N or Shift+→ Next scene in playlist
P or Shift+← Previous scene in playlist
S Toggle shuffle
R Cycle repeat mode (Off → All → One)
Escape Exit playlist playback

Search & Filtering

Key Action
/ or Ctrl+F Focus search box (from anywhere)
Escape Clear search and exit search box
Enter Submit search / apply filters
↓ Move to search results (from search box)

Filter Controls

While using filters:

Key Action
Tab Move between filter options
Space Toggle checkbox filters
Enter Apply filters
Escape Close filter panel

Playlists

Playlist Management

Key Action
N Create new playlist (when on Playlists page)
Enter Open focused playlist
Delete Delete focused playlist (with confirmation)

Editing Playlists

In edit mode:

Key Action
Tab Navigate between scenes
Delete Remove focused scene from playlist
Escape Exit edit mode
Enter Save changes

Reordering scenes: - Use mouse drag-and-drop for reordering - Keyboard reordering not currently supported

TV Mode

What is TV Mode?

TV Mode is Peek's interface optimized for TV remotes and couch browsing:

  • Large Focus Indicators - Easy to see what's selected from across the room
  • Remote-Friendly Navigation - Arrow keys and Enter are all you need
  • Auto-Scroll - Page scrolls to keep focused element visible
  • Simplified Controls - Reduced clutter, bigger buttons

Using Peek on TV

Recommended setup:

  1. Connect a computer to your TV (HDMI)
  2. Access Peek via web browser on that computer
  3. Use a wireless keyboard or TV remote (with keyboard features)
  4. Navigate entirely with arrow keys and Enter

Popular remote options: - Amazon Fire TV remote (with Alexa) - Android TV remote apps - Wireless keyboards (Logitech K400, etc.) - Smart TV keyboards - Game controllers (via browser support)

TV Mode Tips

  1. Use fullscreen browser mode (F11) for immersive experience
  2. Enable auto-hide cursor in your OS settings
  3. Increase font size in browser settings (Ctrl +)
  4. Use dark theme for better viewing in dark rooms
  5. Disable screen saver on your PC/TV

Settings Navigation

Key Action
Tab Move between settings sections
Enter Open/edit focused setting
Space Toggle switches and checkboxes
Escape Cancel without saving

Saving Settings

Key Action
Enter Save changes (when focused on Save button)
Escape Cancel changes

Dialog Controls

Key Action
Enter Confirm action (OK, Save, Submit)
Escape Cancel and close dialog
Tab Navigate between dialog buttons

Examples: - Delete confirmation dialogs - Playlist selector - Add to playlist modal - Login form

Accessibility Features

Focus Indicators

Peek shows clear visual focus indicators:

  • Blue outline around focused elements
  • Highlighted cards when focused in grids
  • Button highlights when focused
  • Scale effect on focused scene cards

Screen Reader Support

Basic screen reader support:

  • Alt text on images
  • ARIA labels on buttons and controls
  • Semantic HTML for proper navigation
  • Keyboard-accessible everything

Screen Reader Support

Screen reader support is improving but may not be perfect. Please report accessibility issues on GitHub.

Customizing Keyboard Shortcuts

Currently not customizable. Keyboard shortcuts are built-in and cannot be changed.

Future enhancement: Custom keyboard shortcuts may be added in a future update.

Troubleshooting

Keyboard navigation not working

Solution: - Click anywhere in the browser window to focus it - Try pressing Tab to activate focus mode - Check if a modal or dialog is open (press Escape) - Disable browser extensions that may interfere - Try a different browser

Focus indicator not visible

Solution: - Your browser theme may be hiding focus outlines - Try a different theme in Peek (Settings → My Settings) - Check browser zoom level (Ctrl + 0 to reset) - Report as a bug if it persists

Arrow keys scroll page instead of navigating

Solution: - Click on the scene grid to focus it first - Use Tab to focus an element, then arrow keys work - Some areas use Tab navigation only

Video player shortcuts not working

Solution: - Make sure video player is focused (click on it) - Some shortcuts only work during playback - Check if another app is intercepting keys - Try clicking the video before using shortcuts

Tips for Power Users

Speed Navigation

  1. Use / to search instantly from any page
  2. Use number keys (0-9) to scrub through videos quickly
  3. Press Escape repeatedly to navigate back multiple levels
  4. Use Tab + Enter combo for rapid clicking

Couch Potato Mode

Perfect setup for couch browsing:

  1. Open Peek in fullscreen (F11)
  2. Create a "Favorites" playlist
  3. Start playlist playback
  4. Use only these keys:
  5. Space - Play/Pause
  6. N - Next video
  7. P - Previous video
  8. ↑/↓ - Volume
  9. F - Fullscreen on/off

Workflow Optimization

Browse and queue efficiently:

  1. Navigate scene grid with arrow keys
  2. Press + on scenes you want to watch
  3. Add all to "Watch Later" playlist
  4. Open playlist and press Play
  5. Lean back and enjoy

Next Steps