- C++ 66.2%
- C 18.5%
- Squirrel 7.5%
- OMNeT++ MSG 2.4%
- Objective-C++ 2.3%
- Other 3%
|
Some checks failed
ARM.yml / MarqueeDisplay: bring back what the manager's copy learned (push) Failing after 0s
Linux-x86_64.yml / MarqueeDisplay: bring back what the manager's copy learned (push) Failing after 0s
MacOS.yml / MarqueeDisplay: bring back what the manager's copy learned (push) Failing after 0s
Windows.yml / MarqueeDisplay: bring back what the manager's copy learned (push) Failing after 0s
The plugin is vendored into arcade-nix's manager, which installs it on the Windows cabinet, and that copy's header says this repository is the source of truth: change it here first, then re-vendor. The changes went the other way and never came back. The copy running on the cabinet is 82 lines ahead of this one, and a Linux cabinet -- which gets the plugin from this repository -- has been running the older version. What it had and this did not: - Logging with file() instead of system(). The shell-out spawned a cmd.exe per line, and on Windows each one flashed a console window over the wheel, twice per selection change -- a visible fault caused entirely by the diagnostics, while the plugin itself was working. - The emulator and whether a game is playing, in current.json, so a viewer can tell a selected game from a running one. - The screensaver read from ScreenSaverActive on every tick, as well as from the transitions, so a frontend restarted mid-saver -- an update, a crash, a regeneration -- does not leave the marquee on a logo all night. - mkdir asked once per directory rather than on every write. Byte for byte the manager's current copy, minus its note about being vendored, so the two can be compared by diff from here on. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_011NoerDqPz1XM6oWsv5G5wi |
||
|---|---|---|
| .github/workflows | ||
| config | ||
| debian | ||
| extlibs | ||
| marquee-display | ||
| resources | ||
| src | ||
| util | ||
| .editorconfig | ||
| .gitattributes | ||
| .gitignore | ||
| .travis.yml | ||
| build-and-deploy-wsl.bat | ||
| build-and-deploy-wsl.ps1 | ||
| build-and-deploy.bat | ||
| Compile.md | ||
| Layouts.md | ||
| License.txt | ||
| Makefile | ||
| Manual.md | ||
| Readme.md | ||
Attract-Mode Plus is a graphical frontend for launching command-line emulators. It offers robust list filtering capabilities, and employs a versatile scripting language to showcase an extensive range of image, video, and audio formats. Compatible with Windows, Linux (x86, x86-64, ARM, Raspberry Pi), and Mac OS X.
Releases • Manual • Discord • Coding Reference • Compiling • WIP
Attract-Mode Plus is a fork of Attract-Mode, enhanced by numerous community-driven improvements, fixes, and features. Licensed under the terms of the GNU General Public License, version 3 or later.
⏱️ Quickstart + Mame + Windows
Attract-Mode Plus is a blank canvas that requires external assets to operate effectively.
Although
Snapsare essential,Videosgreatly enhance the frontend experience.
- 👾 Application - Emulators and Roms to launch
- Attract-Mode Plus - extract to
C:\attract-mode-plus - Mame - extract to
C:\mame - Roms - place in
C:\mame\roms
- Attract-Mode Plus - extract to
- 🎨 Artwork - Images and Videos to show
- 📚 Additional - Category, Series, Languages, and Players information
- catver.ini - place in
C:\mame\folders - series.ini - place in
C:\mame\folders - languages.ini - place in
C:\mame\folders - nplayers.ini - place in
C:\mame\folders
- catver.ini - place in
Tip
Select -
Up/Down
Accept/Back -Return/Escape
Configure -Tab
Fullscreen/Window -F11
- 🚀 Launch
C:\attract-mode-plus\attractplus.exe - 🌏 Select your language
- 📡 Auto-detect emulators >
Yes - 💾 Found 1 emulator >
Import - 🎉 Attract-Mode Plus is ready to play!
⚙️ Basic Configuration
Controls • Emulators • Romlists • Artwork • Displays • Filters • Global Filters • Favourites • Tags • Layouts • Plugins • Modules • Displays Menu • Clones • Files • Updates
Fine-tune Attract-Mode Plus to fit your needs.
🕹️ Controls
Configure the input bindings to suit your device - navigation is a good place to start.
- Configure > Controls
- Previous / Next Page - Scroll by an entire page
- Previous / Next Letter - Skip to the next letter
- Previous / Next Filter - Switch between Filters
- Previous / Next Display - Switch between Displays
- Displays Menu - Toggle the Displays Menu
Hold multiple keys to create combos.
🔍
C:\attract-mode-plus\config\attract.cfg
🛠️ Emulators
Emulators specify how Executables run Roms.
- Configure > Emulators >
mame- Executable >
C:\mame\mame.exe - Command Arguments >
[name] - Working Directory >
C:\mame
- Executable >
Launches
C:\mame\mame.exe [name]where[name]is substituted with the selected Romlist entry name.🔍
C:\attract-mode-plus\emulators\mame.cfg
📜 Romlists
Romlists are created by scanning Rom Paths for files matching Rom Extensions.
- Configure > Emulators >
mame- Rom Path(s) >
C:\mame\roms - Rom Extension(s) >
.zip;.7z - Info Source/Scraper >
listxml - Additional Import File(s) >
your;ini;files;here - Generate Collection/Romlist - Rebuild the Romlist
- Rom Path(s) >
Additional Import Filesand the Mame-onlylistxmlscraper augment the Romlist to support advanced Filtering.🔍
C:\attract-mode-plus\romlists\mame.txt
🎨 Artwork
Artwork is associated with Romlist entries that have matching names.
- Configure > Emulators >
mame- snap >
C:\mame\snap;C:\mame\video - marquee >
C:\mame\marquee - wheel >
C:\mame\wheel
- snap >
Configure > Emulators > mame > Scrape Artworkcan import some artwork, but with reduced control over the results.🔍
C:\attract-mode-plus\scraper\mame
📽️ Displays
Displays determine what the frontend presents to the user.
- Configure > Displays >
mame- Layout >
BasicPlus- The Theme - Collection/Romlist >
mame- The Roms - Filter >
All- The Lists
- Layout >
Multiple Displays can share the same Romlist, each with its own Layout and Filters.
🔍
C:\attract-mode-plus\config\displays.cfg
🔬 Filters
Filters are rule-sets that organise Romlists into concise, structured Lists.
- Configure > Displays > mame
- Add Filter >
The 90's- Add Rule
- Target >
Year - Comparison >
contains - Filter Value >
199
- Target >
- Add Rule
- Add Filter >
Filter Valueis a regular expression that matches Romlist fields.🔍
C:\attract-mode-plus\config\displays.cfg
🔭 Global Filters
Global Filters refine the Romlist for the entire Display.
- Configure > Displays > mame
- Global Filter
- Add Rule
- Target >
Category - Comparison >
does not contain - Filter Value >
Mahjong
- Target >
- Add Rule
- Global Filter
Use to exclude Roms from all Filters within the Display.
🔍
C:\attract-mode-plus\config\displays.cfg
⭐ Favourites
Displays are created with two Filters, one of which is a "Favourites" List.
All- Show all Roms in the RomlistFavourites- Show favourite Roms in the Romlist
Use the
Add/Remove Favouritescontrol to toggle a Rom's "Favourite" status.🔍
C:\attract-mode-plus\romlists\mame.tag
🏷️ Tags
Custom Tags can be added to Roms, allowing Filters to generate personalised Lists.
- Configure > Displays > mame
- Add Filter >
Party Games- Add Rule
- Target >
Tags - Comparison >
contains - Filter Value >
party
- Target >
- Add Rule
- Add Filter >
Use the
Add/Remove Tagscontrol to add a Tag namedpartyto your Roms.🔍
C:\attract-mode-plus\romlists\mame\party.tag
🎞️ Layouts
Layouts are themes that define the appearance and behaviour of a Display.
- Configure > Displays > mame
- Layout >
Select a Layout - Layout Options >
Varies by Layout
- Layout >
Layout Options belong to the Layout - they are common to all Displays that use it.
A multitude of Layouts can be found on Discord or the Forum.
- While some explore technical possibilities, others are total conversions.
- A select few are passion projects, featuring hand-crafted Layouts for close to a thousand individual Games.
- With some basic coding you can even create your own!
As community-generated content, Layouts can vary in quality.
🔍
C:\attract-mode-plus\layouts
🔌 Plugins
Plugins run atop the Layout, providing additional features across all Displays.
- Configure > Plugins > SearchPlus
- Enabled >
Yes - Show >
Custom1- The control that shows the Keyboard
- Enabled >
Use the
Plugin Optionscontrol to configure the last viewed Plugin.🔍
C:\attract-mode-plus\plugins
📦 Modules
Modules are shared libraries that provide functionality to Layouts. Popular Modules such as inertia, animate, and wheel are bundled with Attract-Mode Plus.
Modules do not require enabling. If a Layout isn't working, run
attractplus-console.exeto inspect console warnings. Refer to the Layout's Readme for information about required files.🔍
C:\attract-mode-plus\modules
🏟️ Displays Menu
The Displays Menu can be configured to use a Layout. Setting it to show on startup makes it the "root" Menu to which other Displays return.
- Configure > Displays > Displays Menu Options
- Layout >
Select a Layout
- Layout >
- Configure > Settings >
- Startup Mode >
Show Displays Menu
- Startup Mode >
Artwork for the
Displays Menumust match theDisplayorRomlistname, located in themenu-art/<resource>subfolder.🔍
C:\attract-mode-plus\menu-art\snap\mame.png
🐑 Clones
Rom clones are grouped into sub-menus, which are opened by selecting the Rom.
- Configure > Settings >
- Group Clones >
Yes
- Group Clones >
Use the
Backcontrol to exit the clone sub-menu.
📁 Files
Configuration files can be edited while Attract-Mode Plus is running.
Close the menu to avoid changes being overwritten by the frontend. Preserve the file's formatting to ensure it remains readable.
Use the
Reload Configcontrol to reload all configuration files.
📬 Updates
A notification will appear at startup whenever an update is available. Visit the Releases page to download it.
Extract the new version over your existing files - your configuration will remain intact.