Short: Full-screen media centre for the Amiga Author: Brian King Uploader: codepoet hotmail com (Brian King) Type: mus/play Version: 0.9.2 Requires: 68020+, Kickstart 3.1+; flacdec.library for FLAC Architecture: m68k-amigaos >= 3.1.0 Distribution: Aminet 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 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.