Skip to content

Directory Structure

Directory Structure

Cannoli uses an opinionated directory structure heavily inspired by MinUI.

All paths below are relative to the Cannoli Root you picked during initial setup.

Cannoli Root/
├── Art/
├── Backup/
├── BIOS/
├── Collections/
├── Config/
│   ├── arcade_map.txt
│   ├── ignore_extensions_roms.txt
│   ├── ignore_files_roms.txt
│   ├── Launch Scripts/
│   │   ├── Ports/
│   │   └── Tools/
│   ├── Overrides/
│   └── Profiles/
├── Media/
│   ├── Recordings/
│   └── Screenshots/
├── Guides/
├── Overlays/
├── Roms/
├── Save States/
├── Saves/
├── Shaders/
└── Wallpapers/

Config Files

  • ignore_extensions_roms.txt - File extensions to filter out of the games list. One extension per line. Cannoli creates this file automatically with .sav and .srm as defaults.
  • ignore_files_roms.txt - Specific filenames to filter out of the games list. One filename per line. Cannoli seeds it with common non-game files like map.txt, systeminfo.txt, gamelist.xml, and gameslist.xml.
  • arcade_map.txt - Maps arcade ROM filenames to human-readable game titles. Cannoli ships a default mapping, but you can edit this file to add or change entries.

Tags keep things organized!

The folder structure should be fairly obvious but let's clarify a few things.

Nearly everything is sorted using the platform tags as directory names.

The following folders expect subdirectories using the accepted platform tags.

  • Art
  • BIOS
  • Guides
  • Roms
  • Saves
  • Save States

Wait, What?

Sorry that was a shitty explanation.

Say you have a cool rom hack Pokémon - Recharged Yellow for Game Boy Advance.

The rom file name that you'll be copying over is Pokémon - Recharged Yellow.gba.

Referring to the platform tags page, GBA is the tag for Game Boy Advance.

With those two pieces of info you know where everything has to go!

Thing Where It Goes
BIOS Files Cannoli/BIOS/GBA/gba_bios.bin
Box Art Cannoli/Art/GBA/Pokémon - Recharged Yellow.png
Guide File Cannoli/Guides/GBA/Pokémon - Recharged Yellow/Kanto Map.png
ROM Files Cannoli/Roms/GBA/Pokémon - Recharged Yellow.gba
Save Files Cannoli/Saves/GBA/Pokémon - Recharged Yellow.sav
Save States Cannoli/Save States/GBA/Pokémon - Recharged Yellow/Pokémon - Recharged Yellow.state.1

Multi-Disc Games

Multi-disc games go in the same ROM folder. Cannoli auto-bundles them into a single entry.

Roms/PS/
├── Final Fantasy VII (Disc 1).chd
├── Final Fantasy VII (Disc 2).chd
└── Final Fantasy VII (Disc 3).chd

This shows up as Final Fantasy VII in the game list. You can optionally include an .m3u file if you want to control disc order yourself. See Multi-Disc Games for details.