Ambiance is a fast, full-screen media centre for the Amiga, in the spirit
of Kodi(R) and Windows(R) Media Center: games and demos from Amiga Game
Selector (AGS) or iGame, tracker music, internet radio, the music and
photos on your Plex(R) server and your pictures, all in one place, driven by
keyboard, mouse or joystick.
Copy the Ambiance drawer anywhere and double-click it. On an Amiga Game
Selector 3 installation it is a drop-in companion: AGS's games and demos,
its modules and its pictures are found by themselves. On any other Amiga,
Settings > Folders says where your music, modules and pictures are, and
iGame's games and demos are found where iGame is installed. Everything
plays inside Ambiance, on its own screen and the Amiga's own sound.
Features
--------
Games and demos
- Browses the AGS menu tree (Games, Demos, Disk Magazines, Favourites) by
category, never as one giant flat list. On screens 640 or more wide the
selected title's screenshot and fact sheet sit in a pane beside it.
- Launches titles through their AGS .run scripts, honouring the AGS
Expert, ExpertPerm and Adult settings. While a game runs Ambiance frees
everything it can, and comes back on the same entry afterwards.
- Long lists (All Games, menus split A-Z) are kept in an index in the
Cache drawer, so they open at once; only letters that changed are read
again. Deleting the Cache drawer is always safe. Screenshots and fact
sheets are read by a second process, so the list never waits for disk.
- Without AGS, or beside it (an "iGame" folder), the games and demos of
iGame's list (gameslist.csv in iGame's drawer): Favourites, All, Most
played, By genre, By chipset, By year, with iGame's igame.iff screenshot.
iGame is looked for by itself the first time and its drawer kept;
Settings > Folders > iGame chooses another, or None. Titles start as
iGame starts them: WHDLoad with their icon's tooltypes. iGame's list is
only read.
- Without AGS or WHDLoad, with the network up, Games offers to install
WHDLoad: its user package fetched from whdload.de, unpacked by
xadmaster.library (or LhA in C:), WHDLoad and its tools put in C:.
Mods
- Modules from the MODS: assign and up to eight folders chosen in Settings >
Folders > Modules, and on AGS from ST-00:Modules, ST-00:C64Music and
AGS:Mods (its menu music). ProTracker modules play on Ambiance's own
replayer, after the ProTracker 2.3D play routine and timed by a CIA timer.
Hundreds of other formats (OctaMED, TFMX, Future Composer, Hippel, AHX,
SID...) play through EaglePlayer's and DeliTracker's players where they
are installed (AGS has them). 6- and 8-channel MODs play on the same
replayer, channels 5 to 8 mixed onto Paula's four the way ProTracker 4.1
does (its mixer, by Andreas Wendorf). XM, S3M, IT, MTM and 669 are mixed
by modplug.library on a 68020 or better. Packed modules (PowerPacker,
XPK...) are unpacked with xfdmaster.library.
Radio
- Internet radio from radio-browser.info: top voted, most listened to,
trending, chiptune, demoscene, by genre or by country (A to Z, your own
country first, from your Locale settings). Only stations an Amiga can
play are listed: MP3, working, and no higher in bitrate than this Amiga
copes with. Now Playing shows the song titles the station sends.
- With AmiSSL 5 or 6 and Settings > Networking > HTTPS on, stations that
stream over HTTPS are listed and play too, marked HTTPS in the lists
and on Now Playing.
Music (Plex)
- The music libraries of a Plex Media Server on your network: by artist,
album or recently added, with covers and details beside the list.
- Plex converts each track to an MP3 this Amiga can decode: 22 kHz mono
on a 68020/030, 24 kHz stereo on a 68040/060, at a higher bitrate on a
fast one. On a fast Amiga with flacdec.library, MP3 and FLAC tracks
play as stored. Plain HTTP on your own network: no AmiSSL needed.
- Servers are found on the network by the Plex platform's own discovery (GDM).
With AmiSSL 5 or 6, sign in at plex.tv by a code entered at plex.tv/link on
a phone or computer: no token to copy, and your account's servers are listed
too.
Music (files)
- MP3, FLAC, WAV, AIFF and 8SVX files on this Amiga, under Music beside
Plex: the MUSIC: assign, if there is one, and up to eight folders chosen
in Settings > Folders > Music. Only folders with music somewhere
inside are listed (in a folder of more than 64 folders, all of them).
Fire plays a file with the rest of its folder as
the playlist, with seeking. FLAC needs flacdec.library; a 68020/030
plays it in mono at about 22 kHz.
- Beside the list: the file's title, artist, album and year (ID3 tags,
FLAC's comments, AIFF and 8SVX names), its format and length, and its
cover: the folder's cover file (cover, folder or front .png or .jpg) or
the picture inside the file. Now Playing shows them too.
- A beets library (beets.io) with its database in MUSIC: (musiclibrary.db
or library.db) adds Music library (beets): Artists, Albums and Recently
added, then an artist's albums and an album's tracks, without reading
the folders (quick on a network share). The database is only ever read,
through Ambiance's own Libs/ambsql.library (SQLite). Its albums are
read once, a few seconds on an 030, and kept in Cache until the
database changes. Tracks in WMA, AAC or other formats Ambiance does
not play are left out, as are file names with characters Latin-1 lacks.
Now Playing
- Title, artist, album and cover, a level meter per channel (labelled for
modules by their samples), a position bar you can click to seek, and
buttons for previous, back, play/pause, stop, forward, next, loop
(again at its end, until turned off) and volume.
- The music plays on while you browse; the lists you came from mark what is
playing, and Now playing, the menu's first entry while something plays,
brings you back to it.
- Stop gives Paula and its timer back to the system, so other programs
can play sound.
Pictures
- Browses the PICTURES: assign, up to eight folders chosen in Settings >
Folders > Pictures and AGS's Media:Images, with a preview of the picture
or folder selected,
shows pictures full screen on Ambiance's own screen (no mode switch) and
plays folders as slideshows, in the pictures' own colours where the
screen allows. Pictures are decoded by the installed datatypes.
Moving the mouse shows the pointer and buttons for the previous
picture, the slideshow (play or pause) and the next.
- Plex photos: the photo libraries of your Plex server at the top of
Pictures, albums and photos with a preview beside the list, full
screen and as slideshows. The server makes each photo the size of the
screen (PNG, JPEG above 640x512); the next is fetched while one is
shown, and a slideshow waits for a slow one rather than skip it.
Videos
- IFF ANIMs from the VIDEOS: assign, up to eight folders chosen in
Settings > Folders > Videos and AGS's Media:Animations, with a frame
of each beside the list (a later one when it starts blank), its size,
colours, frame count and length. Each plays on a screen in its own
display mode (HAM, extra halfbrite, interlace, overscan) as it was
made, read from the file a frame at a time, so the biggest play too:
ANIM-5, 7 and 8. Its own sound plays in step with the pictures, by
AHI if that is the sound output, else Paula; what was playing waits
(a station or a track is stopped, and goes on afterwards).
- Moving the mouse brings up controls over the picture: from the start,
play/pause, stop, loop, volume (when it has sound), the time and the
length; a click on the line of how far it has got goes there. Up/Down
set the volume; Esc or the right button stops. At its end it goes
back to its first frame and waits there, unless loop is on.
- In a Workbench window it is made as large as the window holds,
larger or smaller; the full-screen button shows it on the whole
display, on a screen in Workbench's own mode (no mode switch), and
back.
- MPEG video on a ZZ9000: .mpg, .mpeg, .vob and transport streams
(.ts, .m2ts), MPEG-1 or MPEG-2, decoded by the card and shown on its
overlay, its sound (MPEG audio or AC-3) played as music is. Without
one, MPEG-1 is decoded by the CPU on RTG screens (Libs/mpegv.library,
also on Aminet for other programs).
- DVDs: while a DVD-Video disc is in a drive, its volume is at the top
of Videos with a disc beside it. Fire plays its film, or its
programmes one after another (a disc of episodes); N and P, or the
controls' |< and >|, the previous and next chapter or programme. Of
its sound tracks, a stereo one first (MPEG audio, then AC-3), then
the others. Needs Libs/dvdnav.library (in the archive); no encrypted
(CSS) discs. Decoded by the CPU, a disc with menus plays from its
start, its menus' buttons drawn over the picture: arrows or the stick
and Return or fire, or the pointer and a click; M, a CD32 pad's green
button or the controls' menu button bring its menu back. A DVD's
image (.iso) in Videos' folders plays the same way, a disc beside it;
past 2 GB through the 64-bit DOS packets UAE's and Amiberry's host
file system answers (elsewhere up to 4 GB at most).
Screens
- 320x200/256 lowres, 640x200/256 hires and 640x400/512 laced on OCS, ECS
and AGA; 640x480, 800x600 and 1024x768 on RTG, or Automatic: the
graphics card when the Workbench is on it (the largest of those sizes
that fits the Workbench's screen), else hires on AGA, lowres before it.
- Japanese, Chinese and Korean names (from Plex, stations and song
tags) are shown in their own characters, at 12 or 15 pixels (without
Fonts/amb-cjk, as [JP], [KO] or [CJK]). Greek names too, in the smooth
style's own letters or at 12 pixels.
- Laced screens choose their pixel font (Galmuri or Pixelify Sans); big
RTG screens scale the layout up, in a pixel look or a smooth,
anti-aliased one. Never uses Extra Half-Brite.
- Or a window on Workbench, when Workbench is on a graphics card at 15
bits or more: Settings > Display > Workbench window, the icon's WINDOWED
tooltype (shipped as (WINDOWED): take the brackets away), or
Ambiance WINDOWED from a Shell; a choice made in Settings comes first.
Its text is Small, Medium or Large (512 x 384, 640 x 480 or 800 x 600
at first, as far as Workbench has room); in the pixel style the font
is the size. Resize it (its grip, bottom right) and the layout
follows, the text staying its size; it opens again where and as large
as it was left. Its Project menu (the right button over its title
bar): About, Settings, Full screen, Iconify, Quit. Iconify (Amiga-I,
or the title bar's gadget on OS 3.2; full screen too) leaves an
AppIcon on Workbench and the music playing: double-click it to come
back; Workbench's Tools > Quit Ambiance quits. Its zoom gadget swaps
it for a mini player (the cover, what plays, the time, the buttons,
mute, the volume, a meter; 1x, 2x or 3x by Workbench's size); its own
zoom gadget, a click on the cover, Esc or Return bring the window
back. Pictures and videos go full
screen from it (their button, F or Amiga-F) on a screen in
Workbench's own mode, so the monitor does not change mode.
- The menu folds to its icons while you browse, giving the lists and
Now Playing its room, and opens again with the focus or the pointer on
it; it slides open and shut where the Amiga draws it quickly.
- Flicker-free scrolling lists and text pages. A long list always shows
a scroll bar (how long it is, and where you are in it), which the mouse
can drag or click.
Requirements
------------
- Kickstart 3.1 or later and a 68020 or better, on OCS, ECS, AGA or RTG.
- Amiga Game Selector 3 for Games and Demos (found through AGS:), or
iGame's list with WHDLoad. To install WHDLoad from Games:
xadmaster.library or LhA in C:.
- For Radio and Plex: a running TCP/IP stack (bsdsocket.library).
- For MP3: nothing more (Libs/ambmpega.library is in the archive);
mpega.library or an MHI driver may be chosen instead. For FLAC:
flacdec.library (Aminet: util/libs/flacdec; on a 68060 its 68060 build).
- Optional: EaglePlayer's players (Aminet: mus/play/Eagleplayer, with its
own installer, which assigns Eagleplayer2:; AGS has them) or
DeliTracker's, modplug.library and
xfdmaster.library for more module formats (the installer offers the
two libraries); picture datatypes; AHI for sound through a sound card;
AmiSSL 5 or 6 for HTTPS (secure radio stations, signing in at plex.tv).
Installation
------------
Double-click Install-Ambiance: it asks where Ambiance should go and which
languages to install, your Workbench's ticked, and keeps the settings of
an earlier installation. Not on AGS (which has them), it then offers
modplug.library and xfdmaster.library from Aminet, ticked where LIBS: has
none or an older one; a newer one is never replaced. Or
copy the Ambiance drawer to your hard drive yourself (all its languages
come along), keeping its Fonts drawer next to the program.
On AGS, if it boots straight into its own menu, quit AGS to Workbench
first, then double-click Ambiance.
Languages
---------
English, Deutsch, Francais, Italiano, Espanol, Svenska, Suomi, Dansk,
Norsk, Nederlands, Portugues, Japanese, Greek and Korean. Ambiance
speaks your Workbench's language (Locale prefs) when its catalog is
installed;
Settings > General > Language chooses another. Workbench 3.x has no
Japanese or Korean locale, so they are only ever chosen there: Ambiance
draws them with its own glyphs (Fonts/amb-cjk), needing nothing from
the system. Greek is drawn with Ambiance's own glyphs too, so it needs no
Greek fonts or ReplaceTopaz; it is chosen by itself where Locale prefs
put Greek first. The translations are new: corrections are
welcome (catalogs/*.ct in the source, FlexCat's format).
Controls
--------
Up/Down move (held: faster) Shift+Up/Down page
Fire/Return play a game, module, station or track; open a folder
Right open a folder; on a game, its details
Left/Esc back Esc at menu press twice to quit
A-Z jump to letter Right mouse back
Mouse one click opens a folder or setting; a game or picture is
selected by one click and played by two. The path above a
list (Games > All Games...) links back to each level
Mouse wheel scroll Scroll bar click to page, drag
CD32 pad shoulder buttons: next / previous letter
Pictures Fire views a picture or plays a folder marked with the
play arrow as a slideshow. In the viewer, Left/Right
previous/next, Fire or Space slideshow on/off, Esc back.
Videos Fire plays an animation. Playing: Space, Fire or a click
pause; Up/Down or the wheel volume; Esc, Blue or the right
button stop; the mouse moved shows the controls.
Now Playing Left/Right choose a button, Fire presses it; Space
play/pause; S stop; N/P next/previous; , and . back and
forward; Up/Down or the wheel volume; a click on the bar
jumps there; V, or the cycle gadget at the meters' top
right, the level meters, the spectrum or Flow (the playing
marker in the header and lists follows it; greyed where
the music allows the meters only, as under MHI). F: Flow
on the whole screen (from a window, a screen of its own
in Workbench's mode), or the AmigaAMP plug-in chosen in
Settings. On Flow: move the mouse for its controls,
as a video's (previous, play/pause, next, volume, the
time and a bar to click to jump, and full screen or the
window); Space play/pause, N/P or Right/Left next
and previous, Up/Down volume; F full screen or the
window; Esc, Return, the
right button, fire or a click on the picture to come
back. Opened
from another section (a module's page from Music), its
title says where the music is from: a click there, or G,
goes to that folder; Esc goes back where you were. Esc
goes back, the music playing on.
Settings
--------
General Language, Debug
Display Window (full screen or a Workbench window, where Workbench
can take one), Screen mode (full screen) or Text size (a
window), Style (a laced or RTG screen: the font, those
whose layout fits; RTG: or Smooth), Double buffering
(RTG), Colours (Midnight's navy, Graphite, WB1.3's blue,
Emerald or Amethyst), Visualisation
(Now Playing's level meters, HippoPlayer's spectrum
analyser, or Flow on graphics cards; under MHI the
meters), Full screen visual (F on Now Playing: Flow, or
one of AmigaAMP's visual plug-ins put in Ambiance's
Visuals drawer or AmigaAMP:Plugins; Ambiance answers on
their port as AmigaAMP does, and its screen goes behind
while one runs: Esc in it to come back), Jump scrolling
(very long lists step a letter at a time). Text size, in
a window: Small, Medium, Large or Extra large (a big
Workbench). On a fast Amiga (as measured) the smooth
style's text is blended in 16 steps over what is under
it on a 15 to 32-bit screen; Ambiance/TextBlend "on" or
"off" says otherwise.
Sound Paula, Paula at 14 bits, or AHI (16-bit) for radio,
Plex and music files; MP3 by ambmpega.library
(Ambiance's own), mpega.library or an MHI driver (which
decodes and plays it itself); MP3 quality: automatic
(by this Amiga's speed, measured each run), high or
medium; FLAC by flacdec.library
Folders Where Music, Mods, Pictures and Videos find their files:
the MUSIC:, MODS:, PICTURES: and VIDEOS: assigns on or
off, folders added (Add a folder...) or taken out (Fire
twice); AGS's own drawers are found by themselves
Networking HTTPS: secure connections, with AmiSSL 5 or 6 (radio stations,
signing in at plex.tv)
Radio: the highest bitrate listed, which
radio-browser.info server the lists come from
Plex: on or off, the server, signing in at plex.tv,
lower quality audio
Stream buffer: short, normal or long
Network interface: which one connections go out from
Settings are saved in ENVARC:Ambiance/. If a screen mode does not suit
your display, delete ENVARC:Ambiance/ScreenMode to go back to Automatic.
Debug shows the CPU load and memory use in the header and writes a timing
log to Ambiance.log next to the program (RAM:Ambiance.log if that drawer
is read-only).
Setting up Plex
---------------
1. Settings > Networking > Plex: turn Plex on, then choose your server
under Plex server (servers on the network are found for you).
2. If the server asks for a sign-in: with AmiSSL 5 or 6 installed, turn on
Settings > Networking > HTTPS, then choose Settings > Networking >
Plex > Sign in at plex.tv and enter the code it shows at plex.tv/link
on a phone or computer. Your account's servers then appear under Plex
server. Without AmiSSL, set your Plex token from the Shell:
SetEnv SAVE Ambiance/PlexToken <token>
About > Plex in Ambiance says where to find it.
3. Your music libraries appear under Music, photo libraries at the top
of Pictures.
Not there yet
-------------
- DVD subtitles (other than a menu's forced ones); encrypted (CSS)
discs.
- MPEG video on AGA screens without a ZZ9000.
- Modules played by the Protracker replayer or EaglePlayer's play on
Paula only (those the mixer plays follow Settings > Sound).
History
-------
0.9.2 First public release.
Credits and licences
--------------------
Ambiance (c) 2026 Brian King, under the MIT licence (Licences/LICENSE).
The licence covers the code, not the name: "Ambiance" and its logo identify
this project's own releases, and a modified version released by someone
else must use another name and logo. Source, issues and contributions:
https://github.com/luvwagn/Ambiance
Its EaglePlayer host follows HippoPlayer's, and its spectrum analyser is
HippoPlayer's (MIT, (c) 2017 Kari-Pekka Koljonen; see Licences/CREDITS.txt).
6- and 8-channel modules are mixed the way ProTracker 4.1's 8-channel
mixer does it (MIT, (c) 2026 Akustikrausch (Andreas Wendorf), used by his
leave; ProTracker 4.1: https://github.com/akustikrausch/protracker4).
The Extras drawer holds two Aminet archives, whole and unchanged, for
the installer: modplug-68k (modplug.library 1.0, Thomas Wenzel's port of
libmodplug, which is in the public domain) and xfdmaster (xfdmaster 1.38,
library 39.15, (c) Georg Hoermann and Dirk Stoecker). xfd is free to pass
on but not for profit, its files together and unchanged: Ambiance with it
may not be sold.
FLAC is decoded by flacdec.library (c) 2026 Renaud Schweingruber, with
dr_flac by David Reid (public domain or MIT-0), where it is installed. It
is not included: get it from Aminet, util/libs/flacdec, in its own
unchanged archive.
Fonts: Pixelify Sans (c) The Pixelify Sans Project Authors, Galmuri
(c) 2019-2025 Lee Minseo, Ark Pixel Font (c) 2021 TakWolf, Rubik
(c) The Rubik Project Authors and Geologica (c) 2020 The Geologisk
Project Authors, all under the SIL Open Font Licence 1.1; the full texts
are in the Licences drawer. Radio's station lists come from
radio-browser.info.
Amiga is a trademark of Amiga Corporation. Kodi is a registered trademark of
the XBMC Foundation. Windows and Windows Media Center are trademarks of the
Microsoft group of companies. Plex and Plex Media Server are trademarks of
Plex and used under a license. AGS, WHDLoad and other names belong to their
owners. Ambiance is not affiliated with or endorsed by any of them.
|