No description
  • C++ 66.2%
  • C 18.5%
  • Squirrel 7.5%
  • OMNeT++ MSG 2.4%
  • Objective-C++ 2.3%
  • Other 3%
Find a file
Charles Daoust b904fdef15
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
MarqueeDisplay: bring back what the manager's copy learned
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
2026-09-12 15:34:31 -04:00
.github/workflows CI: Fix ARM workflow 2026-07-17 12:41:56 +01:00
config MarqueeDisplay: bring back what the manager's copy learned 2026-09-12 15:34:31 -04:00
debian Release 3.2.3 2026-04-03 10:21:31 +01:00
extlibs Revert Squirrel Regex 2026-06-02 22:31:15 +08:00
marquee-display Add Linux marquee display (port of MarqueeDisplay.exe) 2026-08-27 10:58:07 -04:00
resources Add PlayedSession Stat 2026-06-06 11:28:48 +08:00
src Find a layout's font when it is named without an extension 2026-09-12 15:32:30 -04:00
util Add util/win/build-static-release.sh for Windows cross-builds 2026-08-27 10:58:07 -04:00
.editorconfig Fix sound handling when interrupted by game launch 2018-07-29 11:05:25 -07:00
.gitattributes Embed Language Files 2025-07-18 16:14:38 +08:00
.gitignore Update .gitignore 2026-08-02 22:27:20 +01:00
.travis.yml Fixed travis error and updated Compile.md 2020-09-26 01:23:40 +01:00
build-and-deploy-wsl.bat AttractMode Plus customizations: MarqueeDisplay plugin, build scripts, source tweaks 2026-08-27 10:58:07 -04:00
build-and-deploy-wsl.ps1 AttractMode Plus customizations: MarqueeDisplay plugin, build scripts, source tweaks 2026-08-27 10:58:07 -04:00
build-and-deploy.bat AttractMode Plus customizations: MarqueeDisplay plugin, build scripts, source tweaks 2026-08-27 10:58:07 -04:00
Compile.md AttractMode Plus customizations: MarqueeDisplay plugin, build scripts, source tweaks 2026-08-27 10:58:07 -04:00
Layouts.md Update Layouts.md 2026-08-05 14:48:09 +01:00
License.txt Initial commit. 2013-07-01 22:44:27 -07:00
Makefile AttractMode Plus customizations: MarqueeDisplay plugin, build scripts, source tweaks 2026-08-27 10:58:07 -04:00
Manual.md Add PlayedSession Stat 2026-06-06 11:28:48 +08:00
Readme.md Add Quickstart Guide 2025-12-07 22:09:07 +08:00

Logo

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 Snaps are essential, Videos greatly enhance the frontend experience.

  • 👾 Application - Emulators and Roms to launch
  • 🎨 Artwork - Images and Videos to show
    • Snaps - extract to C:\mame\snap
    • Videos - extract to C:\mame\video - Standard Quality
    • Logos - extract to C:\mame\wheel
    • Marquees - extract to C:\mame\marquee
  • 📚 Additional - Category, Series, Languages, and Players information

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

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

Additional Import Files and the Mame-only listxml scraper 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

Configure > Emulators > mame > Scrape Artwork can 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

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

Filter Value is 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

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 Romlist
  • Favourites - Show favourite Roms in the Romlist

Use the Add/Remove Favourites control 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

Use the Add/Remove Tags control to add a Tag named party to 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 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.

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

Use the Plugin Options control 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.exe to 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
  • Configure > Settings >
    • Startup Mode > Show Displays Menu

Artwork for the Displays Menu must match the Display or Romlist name, located in the menu-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

Use the Back control 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 Config control 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.