Cocoon Shell

Settings Guide

Find Cocoon's appearance and library settings. Manage integrations and system options.

Settings Guide

Open Settings from the Settings tile or the Start menu. It is also in the App Drawer. Use Search to find an option by name.

Personalization

Change how Cocoon looks and sounds:

  • Themes and accent colors
  • Icons and highlights
  • Animations
  • Wallpapers and hero artwork
  • Grid and dock layout
  • Music and sound effects
  • Jingles
  • Folder style and Now Playing style

See Customization and Themes. Audio options are covered in Audio & Music.

Library & Data

Manage your games and their files:

  • Add platforms and ROM folders
  • Choose emulators and launch options
  • Rescan your library
  • Download or clear artwork and game information
  • Show games you previously hid
  • Change folder sorting
  • Import from or export to ES-DE
  • Refresh Cocoon’s platform list

See Emulator Setup and Scraping. Linked ES-DE libraries are covered in ES-DE Integration.

Integrations

Connect optional services:

ServiceAdds
SteamGridDBGame artwork
ScreenScraperArtwork and game information
RetroAchievementsRetro achievement progress
SteamAchievements and friends. Chat is also included
DiscordRich Presence and Cocoon friend activity
Notification accessNotifications and conversations. Replies and media controls use the same permission

System & Advance

Manage Cocoon and your device:

  • Single-screen and dual-screen behavior
  • External display behavior
  • Game session and playtime tracking
  • Language
  • Backup and restore
  • Home layout reset
  • Logs for troubleshooting
  • Restarting Cocoon
  • Resetting app data

Reset App Data clears Cocoon’s settings and library, then starts setup again. The ROM folder stays in place. Create a backup first.

About Cocoon FE

View the installed version and credits. This tab also contains community links and support options.

On this page