player - Frankanator8/openmusic GitHub Wiki
Using the player
Need help navigating the app? You've come to the right place.
Playing songs
To play a song, either
- Click on its card in the Song Library in the upper left of the app
- Load a playlist, and click on a song's card in the Playlist view in the middle of the app
Loading a playlist
To load a playlist, click on its card in the Playlist library in the bottom left of the app
Controlling song playback
By playing a song earlier, you stop the current song and play the new one.
All playback controls are in the lower right corner of the app.
To pause/play the song, you can press space in the app, click the first button in the playback controls list (the one that says Play or Pause), or on MacOS, you can use your system MacOS controls.
To skip back a track, you must be in the first 5 seconds of the song, otherwise it will restart the current song. Press the second button in the playback controls (the one that says <<) or on MacOS, use system controls to skip back. NOTE: this functionality is disabled for songs played from the Song Library.
To skip the current track, press the third button on the playback controls (>>) or on MacOS, use system controls. NOTE: this functionality is disabled for songs played from the Song Library.
To seek back 15 seconds, press the fourth button on the playback controls (<15) or on MacOS, use system controls. NOTE: on Playlist songs, this button will not show up in the MacOS control center and will be replaced by the skip/previous track buttons.
To seek forward 15 seconds, press the last button on the playback controls (15>) or on MacOS, use system controls. NOTE: on Playlist songs, this button will not show up in the MacOS control center and will be replaced by the skip/previous track buttons.
To seek to a specific time, use the slider in-app or on MacOS, use your system controls.
New song
To create a new song, press the "New Song" button to the right of the text "Song Library" in the upper left corner of the app.
You can choose to add songs individually, where you hand it an audio file, image file, and some metadata about the song. You can also add songs in bulk, but the audio and image files must follow certain conventions to properly match and add them. See the in-app information for more.
New playlist
To create a new playlist, press the "New Playlist" button to the right of the text "Playlists" in the middle left of the app. Follow the instructions in the following dialog.
Add song to playlist
To add a song to a playlist, you can either right click its card in the Song Library and select a playlist to add to "Add to playlist" or add it in the Playlist editor.
Edit song
To edit a song, you right click its card in the Song Library and edit its data there.
Edit playlist
To edit a playlist and bring up the playlist editor, you can right click its card in the Playlist library OR open the playlist in the main central view and click the button to the right of the playlist cover image that says "Edit Playlist"
Delete song
To delete a song, right click its card in the Song Library and press "Delete"
Delete playlist
To delete a playlist, right click its card in the Playlist library and press "Delete"