Short:         bePlayer
Author:        beworld@sfr.fr (BeWorld)
Type:          music/player
Version:       2.0
Requires:      MorphOS 3.19 and last TinyGL
Architecture:  ppc-morphos

Simple audio/music player written by BeWorld.
This is an experimental player based on SDL 3 technologies.

Libraries included:
SDL_mixer 3.3.0: libXMP, libfluidsynth, drflac, drmp3, opus, libgme, libogg, vorbis and ffmpeg 6.1.4 sdk (light version)
SDL 3.4.3 and SDL_ttf 3.3.0

Usage:
******

Player Window
******************************
  
Space / P Pause or resume playback. If playback is stopped, this starts
the current track.
S Stop playback immediately.
Q / Escape Quit bePlayer.
L Show or hide the playlist window.
B Show or hide the scope window.
F5 Open a file requester to select a new SoundFont (.sf2) for MIDI
playback. If the current track is a MIDI file, playback is reloaded with
the new SoundFont.
Left / Right Arrow Seek backward or forward by 5 seconds (disabled for
MIDI tracks).
Keypad + / Keypad - Increase or decrease the playback volume.
Keypad 1 to 7 Change the scope color.
Return / Keypad Enter Play the track currently selected in the playlist.

Delete Delete the currently selected playlist entry when the playlist
window has focus.

Mouse Controls
**************

Left click on the player scope area Switch to the next scope
visualization.
Double left click in the scope window Switch to the next scope
visualization.
Mouse wheel on the player window Adjust volume.
Mouse wheel on the playlist window Scroll the playlist.
Drag on the vertical volume bar Set the volume with the mouse.
Drag or click on the progress bar Seek inside the current track
(disabled for MIDI tracks).

Player buttons (left click) Play, pause, stop, open files, previous
track, next track.

Stop button (right click) Clear the full playlist.
Eject button (right click) Open a directory requester and load a whole
folder.

Playlist Window
***************

Single click Select a track.
Double click Play the selected track.
Scrollbar drag or click Scroll through the playlist.

Toolbar buttons Previous track, next track, delete entry, add files,
load playlist, save playlist.

Scope window:
*************

Tab Switch to the next visualization.
Alt + Enter Toggle fullscreen mode.
N Toggle borderless / always-on-top mode.
F Show or hide the FPS display.
C Toggle FPS cap / uncapped rendering.
Q / Escape Close the scope window and return to the player.

Drag and Drop
*************
bePlayer supports drag and drop directly onto the player window.

Dropping a directory Adds its contents recursively.
Dropping an M3U or M3U8 file Loads it as a playlist.
Dropping regular audio files Adds them to the playlist.

When the drop operation completes, playback starts automatically if the
player was idle.

Game Controller support:
************************

South button Play the currently selected playlist entry.
East button Play, pause, or resume depending on the current playback
state.
West button Show or hide the playlist window.
North button or Start Show or hide the scope window.
Back or Guide Toggle fullscreen for the scope window.
D-Pad Up / Down Move the playlist selection up or down.
Left shoulder / D-Pad Left Play the previous track.
Right shoulder / D-Pad Right Play the next track.
Left analog stick (X axis) Seek backward or forward by 5 seconds.
Right analog stick (Y axis) Adjust the volume.

FileType:
*********
bePlayer accepts argument(s) from CLI, you can use it with filetype.
example : run >nil: beplayer %sp
bePlayer accept a drawer content.

History:
********

13.03.2026
- bePlayer now detects M3U files automatically
- Fixed launch from shell
- Added audio_sample_frames config option (default 2048, min 1024, max 8192)
- Added warning for unsupported tracks and automatic removal from playlist
- Migrated to SDL 3.4.x (Complete code rewrite)
- Fixed several SDL3 related issues
- Changed SDL3 audio priority (25) and updated SDL3 (timer fix)
- Updated to SDL3_mixer 3.2.0, built with libgme 0.6.4, fluidsynth 2.5.3, libXMP 4.7.0, FLAC 1.5.0, MPG123 1.33.5
- Added experimental FFmpeg decoder for SDL3_mixer (AAC/AC3/M4A/WMA support)
- Rebuilt FFmpeg libraries with audio-only configuration
- Added more information about XMP / FFmpeg formats
- Added separate playlist and scope windows
- Playlist can be attached to the player
- Added new scopes (press TAB to switch)
- Added double-click on large scope and click on player scope to change scope style
- Enhanced scopes (multi-channel)
- Added playlist toolbar (prev, next, delete, add entry)
- Added save/load support for M3U playlists
- Added new PNG buttons
- Fixed mouse button detection when clicking inactive windows

10.11.22
 - fix gamepad button B
 - enhanced PlayList
 - add Artist/Album/Copyright info (just click on music's title)
 - add FFMPEG to detect more format (AAC/AC3/WMA/MP4...)
 - sdl2_mixer.library now included into binary (no more need sdl_mixerX.library)
 - build with last SDL2 and last codecs
 - add libGME 0.6.3
 - fix lot of module detection
 - add delete entry into playlist wth DELETE key

06.06.22
 - add Opacity on config file (90% per defaut)
 - add Real Fullsreen or Fullscreen desktop (defaut) option
 - save last selected directory
 - Building with last SDL2
 - Update sdl2_mixerX.library - so use last dependancies (use DrFLAC instead libFLAC)
 
19.03.2022
 - Update sdl2_mixerX.library (last MPG123, Fluidsynth, libxmp, FLAC etc...)
 - Compiled with last SDL2
 - add simple Notification support
 - fix a lot of bugs
 - now bePlayer use 100% opengl renderer
 
03.06.2021
 - merge playlist window with main window
 - fixed some small bugs
 - better readme file
 - Update sdl2_mixerX.library (last libmpg123, libxmp, libmikmod)
 - add GameController support
 
28.04.2021
 - add Scope window with fullscreen/window option (use OpenGL renderer)
 - add config colors scope lines
 - fixed some bugs

22.04.2021
 - add MOUSEMOTION on volume and progress bar
 - add key l to open/close playlist
 
19.04.2021
 - add visual volume control
 - add Key e and button to open playlist window
 
18.04.2021
  - add mikmod to sdl2_mixerX.library (read more mod type)
  - control playlist with mouse/keys
  
14.04.2021
  - Add little window for playlist... no action
  - rework  player engine
  
12.04.2021
  - Add drawer selection to add all files (recursive) (click right on EJECT)
  - Accept drawer on drag and drop and CLI argument
  - better transition between music
  
11.04.2021
  - added save config on exit
  - changed soundfont by defaut (MuseScore V1 - 6Mb)

10.04.2021
  - updated to fluidsynth 2.2.0
  - added config file
  - fixed path
  - fixed launch from WB
  
01.04.2021
  - start this project
  - create SDL2_mixerX.library

Thanks:
  - K-L
  - Papiosaur
  - All tester
  - Skateman for video
  - Skateman and Greennaam for Mirari Project !
  - And MorphOS Team
  
 
Have fun !!

You love that, dont hesite to support me !

BeWorld