SolarOS 4.17.7 manual · app

player

Interactive WAV/MP3 player and the user-facing counterpart to aplay. player keeps a persistent playlist under .player on the current storage root. Opening an audio file from Files adds it to that playlist, selects it, and starts playback. Missing files remain listed so removable media can be reattached.

Usage:

player [--tui] [file.wav|file.mp3]

Player selects its graphical interface on a graphical shell and its text interface on a port shell. --tui forces the text interface even when the launching shell has graphics. The graphical controls and lists adapt to small displays, including 240×64 and 128×64 targets.

On a graphical session, Tab switches between Play and Playlist. The Play tab uses the space above the shared bottom controls for a cassette visualizer by default; V cycles through Cassette, Oscilloscope, and Spectrum. The cassette reels turn only while audio plays and show track progress when duration is known. Left/Right plays the previous or next track in the playlist ring, Enter plays or stops, Space pauses or resumes, and Up/Down adjusts volume. </> seeks backward/forward by ten seconds without changing tracks; rewind/forward buttons provide the same actions. Seeking preserves pause state and discards queued audio. The controls show the track name, playback status and time above the volume bar. The middle button stops or starts playback and indicates pause while paused. On the Playlist tab, Up/Down selects, Enter starts the track and returns to Play, A opens the WAV/MP3 file browser, and Delete removes the selected playlist entry.

The text interface is one playlist screen: Up/Down selects, Enter plays or stops, Space pauses or resumes, </> seeks backward/forward ten seconds, A opens the filtered file browser, Delete removes an entry, and Esc exits. Its bottom status line shows the playing, paused, or stopped state with elapsed and total time. Playback follows the resumable app while another foreground session is selected and stops when Player closes. End of file advances to the next playlist entry.

Player shows SEEKING while preparing a new position. MP3 seeking can take longer on slow storage, including with variable-bitrate files. Stop playback to cancel a seek.

WAV playback converts the file's mono/stereo channel count and sample rate to the selected output stream. A mono recording therefore plays through a fixed stereo device without changing the recording stored on disk.