Skip to content

web-gears/openplayer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

26 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

OpenPlayer

A music and podcast player for Garmin smartwatch, syncing with Jellyfin media servers via username/password authentication.

Garmin Connect IQ Store link

hero_garmin (Audio player interface vary by model)

Features

  • Username/password authentication via Jellyfin's /Users/AuthenticateByName
  • Credentials used once — only the access token is stored on device
  • Select specific Jellyfin playlists to sync
  • Local storage management with size warnings
  • First-run setup wizard with QR code flow
  • Garmin Connect Mobile settings for server URL, username, and password
  • Audio content provider app for Garmin wearable integration
ezgif-20d663f3e9bcf921

Requirements

  • Garmin Fenix 5+ (or compatible Connect IQ device starting API level 3.1 with music and WiFi support)
  • Jellyfin server with public access
  • Jellyfin user account credentials

Getting Started

1. Install

Install OpenPlayer from the Garmin Connect IQ Store to your watch via Garmin Connect Mobile.

2. Connect to your Jellyfin server

Open OpenPlayer on your watch. On first launch you'll see a connect prompt. Press ENTER to proceed to the setup screen.

Garmin Connect Mobile (recommended): Enter your server URL, username, and password in the Garmin Connect Mobile app under Device > Apps > OpenPlayer > Settings. On the watch, press ENTER to connect once the fields are filled.

QR code: From the setup screen, press UP to switch to the QR code flow. A QR code is displayed on the watch. Scan it with your phone to open a secure form where you enter your Jellyfin server URL, username, and password. The credentials are transmitted to the watch and saved.

After entering credentials, the watch displays a review screen showing your server URL and username. Press ENTER to save.

3. Sync playlists

After setup you'll see a list of playlists from your Jellyfin server. Use UP/DOWN to scroll and ENTER to toggle a playlist for syncing. Press ENTER on the sync prompt to download the selected playlists to your watch. Tracks are stored locally for offline playback.

4. Play music

From the main playback screen:

  1. ENTER to connect and load synced tracks.
  2. Select a playlist, then select a track.
  3. Use Garmin's native music controls (or the watch's media widget) to play, pause, skip, and adjust volume.

5. Manage playlists and storage

Press Menu (or the action menu on touch devices) from the playback or sync screens to access:

  • Settings — Re-run the setup wizard to change server or credentials.
  • Sync playlists — Select playlists, review number of tracks, and start syncing.
  • Clear All Downloads — Remove all synced tracks from watch storage.
  • About — App version and developer info.

Button navigation

Action Button
Select / Confirm ENTER
Scroll up UP
Scroll down DOWN
Back ESC / LAP
Menu / Options START (long-press on supported models)

Touch-enabled watches (Venu X1, Venu 4, Vivoactive 5/6) support tap to select and swipe to scroll.

Privacy

All data is stored locally, encrypted with your Garmin watch.

If QR authentication path is chosen, Disposable Form (GitHub) is used to gather the auth credentials.

License

See LICENSE.md for full terms. All rights reserved.

Developed by

Webgears
https://webgears.org

About

Music/podcast player for Garmin watch that syncs with Jellyfin

Topics

Resources

License

Stars

2 stars

Watchers

1 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors