Contents

Manual

Playback

Skagway plays videos in a single floating player — compact, windowed, or full screen — plus Play All through the current view, bookmarks, resume positions, and sidecar subtitles.

Skagway floating player with custom transport controls and bookmark ticks on the timeline

Start and stop

  1. Select a video and press Space, double-click its grid card, or click Play in the Inspector.
  2. Space toggles play/pause while the player is open.
  3. Press ⌥Space to play from the very beginning, ignoring any saved position.
  4. Press Esc (or the red traffic-light Stop) to stop — Skagway saves where you left off.

If focus is in a text field, press Esc once first so Space plays instead of typing.

Play All (⇧⌘P)

  1. Play All (⇧⌘P) plays the current view and advances when each video finishes.
  2. Loop Play All repeats the list. Stopping or playing a single video ends the session.

Album Order is the sequence Play All uses when you are in an album. For search and sort, see Browse.

Transport controls

  1. Hover the scrubber for a frame preview; click to seek.
  2. Skip back / forward 15 seconds with ⌥← / ⌥→.
  3. Playback speed cycles from 0.5× to 2×.

Bookmarks

  1. While playing, press ⌥⌘B or double-click the scrubber.
  2. Bookmarks appear as diamonds on the timeline and as a list in the Inspector — click one to jump there, or delete it from its row.

Bookmarks live in the library file. Still frames regenerate if you move the library.

Play from the filmstrip

  1. Switch the Inspector preview to Filmstrip (⌥⌘T) to see frames sampled across the video.
  2. Click a frame to start playback there.

Clicking the Still preview starts playback too, from the beginning or the saved resume position.

Three sizes, one player

  1. Compact (⌃⌘C) — docks into the Inspector preview.
  2. Windowed (⌃⌘W) — a floating panel; size and position are remembered.
  3. Full screen (⌃⌘F) — edge to edge without restarting. Esc stops; ⌃⌘F or the traffic lights leave full screen without stopping.
  4. Choose the opening size under Settings → Video → Player opens at.

Resume where you left off

  1. Reopening a partially watched video resumes automatically. A banner offers Start at beginning.
  2. Grid cards show a thin progress bar. The banner can fade — see Settings → Video.

Live Preview

  1. Rest the pointer on a grid card or List thumbnail for a silent preview through the video.
  2. In List view, the enlarged preview opens beside the row. It pauses while the player is open.
  3. Toggle it under Settings → Video → Hover preview on Grid and List.

Subtitles

  1. Put an .srt file next to the video with the same name (movie.mp4 → movie.srt; movie.en.srt also works).
  2. Set Subtitles in the Inspector so the badge and filters match. File → Scan for Subtitles if you add files later.

External players

  1. Press ⌘↩ (or right-click → Play in External Player) to open the video in its default macOS app.
  2. Right-click → Open With lists every installed app that can play the file.
  3. Either way, Skagway counts the play in the video’s play history.

Capture the perfect thumbnail

  1. While playing, pause or scrub to the exact frame you want.
  2. Press ⌥⌘M (Make Thumbnail from Current Frame) — that frame becomes the video’s thumbnail everywhere in Skagway.
  3. Or right-click → Set Poster from Image… (or drag an image onto a grid card) to use any still as the poster.