Skip to content
whomperPublic

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

EPlay

EPlay icon: a loudspeaker sending out a play triangle

An audio player for the Atari Falcon, TT and STE: MP3 decoded on the Falcon's DSP, WAV and AIFF, VGM game music and web radio, in a GEM window. Written in C and DSP56001 assembly.

EPlay on a Falcon in 256 colours (Hatari): an album of five tracks in the list, the first playing, its cover, title and artist in the bar with the position, the volume and DSP as the output

Highlights

  • MP3 on the Falcon's DSP: MPEG-1, 2 and 2.5 layer III, every bit rate.
  • WAV and AIFF: 8 to 32 bits, mono or stereo, at their own pitch at any rate.
  • Through a SoundPool FDI: set to the file's rate (44.1 or 48 kHz) and played bit for bit.
  • Steady sound: fed by an interrupt from memory, so menus, dialogs and other programs don't break it up.
  • Gapless: an album encoded with LAME plays from one track into the next with no gap.
  • ReplayGain: evens out the loudness of tracks or albums from their tags.
  • VGM and VGZ game music: AY and YM2149 files on the Atari's own YM2149 (Falcon, TT, STE); SN76489 files (Master System, Game Gear), YM2612 files (Mega Drive), YM3812 (OPL2) files (AdLib and Sound Blaster music, MSX) and YMF262 (OPL3) files (Sound Blaster Pro 2 and 16) on the Falcon's DSP, a file's rate lowered where the DSP can't keep up with it.
  • Web radio: Icecast and Shoutcast stations, http or https, with titles and pictures; Find station searches by genre, country and language.
  • Playlists: files, folders and .M3U; reorder by dragging; Shuffle and Repeat.
  • Mini player: the bar alone, in a small window.
  • Falcon, TT and STE: WAV and AIFF on the TT's and STE's DMA sound too.
  • 68060 and 68080: a Falcon with a 68060 plays as any Falcon; where there's no DSP free (a Milan, a Vampire, a CT60 whose DSP another program holds), a 68060 or a 68080 decodes MP3 and web radio itself: with its FPU (mp3fpu.ovl), or without one (mp3int.ovl). So far tested in Hatari, not yet on a real 68060 or 68080.
  • FireBee (first test edition): eplayfb.prg, built for its ColdFire: MP3 and web radio decoded by the ColdFire and its FPU, WAV and AIFF, through FireTOS's sound. VGM and the YM2149 not yet there.

EPlay's Settings on a Falcon in 256 colours (Hatari): its pages Playing, Stations and Files at the left; Playing shows the Output (Auto, FDI, DSP) and ReplayGain (Off, Track, Album, Auto) as buttons

Getting started

Download the latest eplay-x.y.zip from Releases and unpack it:

File What it is
eplay.prg the program, for the Falcon and the TT
eplayst.prg the program for an STE
eplay.hyp, eplay.ref the guide, for EHypView or ST-Guide: Help opens it
tls.ovl, cacert.pem secure (https) stations: keep them beside the program
tlsfb.ovl the same on a FireBee: EPlay loads it there instead of tls.ovl
mp3fpu.ovl MP3 decoded by a 68060 or a 68080 with its FPU where there is no DSP free: keep it beside the program
mp3int.ovl the same for a 68060 or a 68080 without an FPU
eplayfb.prg the program for a FireBee (a first test edition: MP3, WAV and AIFF)
fbprobe.prg for FireBee testers: says what the machine's sound can do, in FBPROBE.TXT

Start eplay.prg, or drop music files, a folder or a playlist on it. File > Open... adds more, File > Open URL... plays a station, Help > Keys... lists the keys. The guide (docs/GUIDE.md) has the rest.

Needs: a Falcon030 with TOS 4.0x or EmuTOS (MP3 needs its DSP, or a 68060 or 68080), a TT, or an STE or Mega STE with eplayst.prg (WAV and AIFF), or a FireBee with eplayfb.prg; a screen 640 pixels wide. The original ST has no DMA sound and isn't supported. Web radio needs a network card and STinG or MiNTnet.

AERA-Gateway

EPlay plays MP3 stations by itself. Through the Gateway (the Options menu), AERA-Gateway on a Raspberry Pi also plays stations that send AAC, Ogg or HLS, sent on as MP3, and finds the stations' logos. It is optional.

Building

sudo apt install gcc-m68k-linux-gnu a56 python3 sox lame
make && make st && make test

More in docs/DEVELOPING.md.

Source

src/ the formats and the decoder's C model, dsp/ the MP3 decoder and the chips' programs for the DSP56001, atari/ the sound hardware, ui/ GEM, mp3ovl/ the MP3 overlays for a 68060 or a 68080 (minimp3 and libmad, in third_party/), radio/ the Gateway's radio service, common/ the AERA library. The full list is in docs/DEVELOPING.md.

Tests

make test and make dsptest, with the Hatari rigs in tests/hatari/ (play060.py runs them on a Falcon with a 68060): see docs/DEVELOPING.md.

Licence

EPlay is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 2 of the License, or (at your option) any later version. It is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See COPYING.

Copyright (C) 2026 AERA | Erez Yaary. What it includes under other licences is in NOTICES.TXT.


Part of AERA for Atari: ECal · EContact · EMail · EFTP · EHypView · ClaudeST · EWeb · EUpdate · EPDF · 8-bit: EDOS · EFTP_XL · Gateway: AERA-Gateway

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages