Impala Streamer User Guide

Quick help for everyday listening and playlists.

Summary: open the app and sign in when prompted.

  1. Open Impala Streamer in your browser.
  2. If you are sent to the sign-in page, enter your username and password.
  3. After sign-in, you are redirected to the player automatically.

If sign-in fails:

  1. Re-check spelling (password is case-sensitive).
  2. Try again once.
  3. If it still fails, ask your admin to reset or verify your account.

Playing Music

Summary: pick a playlist, choose a track, then press Play.

  1. In Source, choose the playlist you want.
  2. Click any song in the Tracks list.
  3. Use Play, Pause, Next, and Prev to control playback.

Tip: the source badge shows where media came from: L = local, C = cloud.

Repeat Mode and Video

Summary: choose repeat behavior and resume videos quickly.

  1. Tap Repeat to cycle through Repeat Off, Repeat One, and Repeat All.
  2. When a video has a saved position, use Resume to jump back in.
  3. Video and audio views switch automatically based on the selected track.

Save Favorites (Starred)

Summary: star songs first, then save those stars into a playlist.

  1. In the track list, click the star next to songs you want.
  2. Use New From Starred to create a new playlist.
  3. Enter a playlist name, then confirm.
  4. Use Add Starred to send favorites to an existing custom playlist.

If nothing happens:

  1. Check the starred count near the track controls.
  2. If it says 0 starred, star at least one song first.

Manage Playlists and Songs

Summary: Use Edit Song List for organizing.

  1. Click Edit Song List.
  2. Choose a playlist from the Playlist dropdown.
  3. For custom playlists, you can drag to reorder, remove songs, rename, and delete.
  4. You can also import a playlist from pasted JavaScript format.

To return to listening, click Back to Player.

Add Songs from the S4 Library

Summary: Browse folders and add tracks to a playlist.

  1. In Edit Song List, select a custom playlist (or create one).
  2. Use Audio or Video at the top of the library panel to change browse mode.
  3. Filter Library can search artist, album, track, or folder text.
  4. Select items and use Add Selected To Playlist, or create a new playlist from selected tracks.
  5. Admins may see a Rebuild Index button when signed in with admin rights.

User Preferences

Summary: personalize look and behavior from the Preferences page.

  1. Choose and apply a color palette (with live preview).
  2. Set a custom message and medallion image.
  3. Optionally set Local Audio Directory and Local Video Directory.
  4. Use Test Local Audio and Test Local Video to quickly check reachability.

Local Library JSON

Summary: you can override built-in lists with local JSON entries.

In Preferences, paste or drop a JSON manifest into Local Library JSON, then click Apply Local Library JSON.

Example:

{
  "audio": [
    {
      "name": "Rolling In The Deep",
      "artist": "Adele",
      "album": "21",
      "file": "01 Rolling In The Deep.mp3"
    }
  ],
  "video": [
    {
      "name": "Happy Days",
      "artist": "Unknown artist",
      "file": "Happy Days.mp4",
      "mediaType": "video"
    }
  ]
}
  1. Use file names or relative paths in each entry.
  2. Set local directory roots if your files are hosted locally.
  3. Clear Local Library JSON to return to built-in lists.

Quick Fixes

Summary: most issues are solved by sign-in, source switching, or refresh.

If a song will not play:

  1. Try a different track in the same playlist.
  2. Switch to another Source and then switch back.
  3. If prompted, sign in again.
  4. Refresh the browser page.

If playlists look wrong:

  1. Go to Preferences and check whether Local Library JSON is enabled.
  2. Clear Local Library JSON if you want built-in lists back.
  3. Refresh the page.

If stars seem to disappear:

  1. Stars are temporary selections for the current session.
  2. Save them with New From Starred or Add Starred before closing.

Keyboard Shortcuts

Summary: Helpful, but not required.

  1. S: star or unstar current track
  2. A: add starred tracks to an existing playlist
  3. N: create new playlist from starred tracks
  4. M: open Edit Song List
  5. C: clear starred tracks
  6. H or ?: show hotkey help

Diagnostics

Summary: use diagnostics for troubleshooting and health checks.

  1. Click the Diag button on the player page to open diagnostics.
  2. Use Refresh on the diagnostics page to pull latest state.
  3. Review player status, playlist counts, storage health, and recent errors.