Getting Started¶

Important

Cannoli requires Android 9 or newer.

Important

Cannoli needs about 600 MB of free space to install or update. Once installed it uses about 500 MB.

I am working on reducing this for devices with limited storage.

Installing Cannoli¶

You can snag the latest APK from the GitHub Releases.

First Launch¶

Once you have the Cannoli APK installed open it up.

You will be greeted by this screen on first launch.

First Launch

Here you will be prompted for permission to manage all files and to select where to place the Cannoli Root Folder.

Cannoli needs this All Files Access to read your ROMs and write saves, box art, guides, and the rest of the directory tree it manages on shared storage. Without it the launcher can't do anything.

Let's grant this permission first.

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!

Make your choice and hit continue.

Cannoli will then do some light housekeeping to 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.