Guide-WiiU/docs/user-guide/aroma/getting-started.md

Aroma {docsify-ignore-all}

Aroma is a work-in-progress environment and the successor to Tiramisu.

What is Aroma?

Aroma is an environment like Tiramisu, which can be booted through the Environment Loader.
Aroma, just like Tiramisu, uses the same Mocha version, support for setup modules, and comes with the Autoboot Module, which includes the boot selector and Quick Start support.
Aroma comes with several additional features, including a plugin system and a new way of launching homebrews.

What can I do with Aroma?

For a detailed overview check out this blogpost. A quick summary is given below.

Modules

Aroma supports modules, which unlike setup modules, always run in the background.
This allows further extending the functionality of the console.

Plugins

Plugins, similarly to modules, are also running in the background.
They can enhance the experience of the console by changing and providing additional features.
Plugins can be configured using a configuration menu, which can be opened using a button combination.

Wii U Homebrew Bundles

Wii U Homebrew Bundles (WUHB) are a new way of launching homebrew.
These .wuhb files contain the main executable and can directly include icon and banner images and additional content.
With the homebrew_on_menu plugin, WUHB files can be directly launched from the Wii U menu, just like official channels.

What are the limitations?

Due to technical limitations, a lot of old homebrew applications will no longer work with Aroma.
This includes all .elf homebrews, but also some .rpx homebrews, which don't implement necessary functionality properly.
These homebrews need to be updated with support for Aroma. To run old homebrews you need to boot the Tiramisu environment.
Launching homebrews through the now outdated Homebrew Launcher is no longer possible with Aroma.

Besides the limitations mentioned above, note that Aroma is still a beta release. Not everything has been tested yet, and additional issues might be discovered.