Skip to content

Getting Started

Important

Android Version Compatibility ≥ 9

Cannoli requires Android 9 or newer. Development and testing happen on Android 11 and newer, so Android 9 and 10 may have rough edges.

Installing Cannoli

You can snag the latest APK from the GitHub Releases.

First Launch

After installing you will have the Cannoli app.

On your first run you will be prompted for permission to manage all files.

Turn that on and hit the back arrow.

Allow file permissions

Once enabled you will have the simplest setup question to answer.

Do you want the Cannoli folder on internal storage, the SD Card (if present) or a custom location? Really that's it!

Cannoli Folder

Make your choice and hit continue.

Cannoli will then do some light housekeeping make sure everything is put into place.

Loading Content

You will then land on a pretty barren main menu.

No Content

While you are free to add content however you'd like, the easiest way is with Nonna's Kitchen, a built-in web client for uploading ROMs, box art, saves, and more from any browser on your network.

If you prefer to manage files manually, see the Directory Structure page for where everything goes.

Android TV

On Android TV, Cannoli maps the TV remote's media keys to launcher navigation:

  • Back → Back
  • Play / Pause → Start
  • Rewind → West face button
  • Fast-Forward → North face button

This only applies to launcher navigation. In-game input goes through your usual profile bindings.