After download

First-time setup checklist

Use this page after the app opens. It keeps the path short: confirm the package, stay inside legal boundaries, choose folders, check controls, and keep a rollback option.

Setup boundaries

This guide does not provide or explain how to obtain keys, firmware, ROMs, or copyrighted game content. Use only materials you are legally entitled to use and follow project documentation for app-specific prompts.

Clean setup walkthrough

A short, compliant first-run sequence without content sourcing instructions.

  1. Open the app Start from a package you downloaded from the Download page.
  2. Confirm legal content boundaries This guide does not provide or explain how to obtain keys, firmware, ROMs, or copyrighted game content.
  3. Choose a library folder Point the app at folders you manage and can back up.
  4. Check controls and graphics Verify the basics before chasing deeper issues.
  5. Update or roll back carefully Canary moves quickly, so keep a working fallback path.

Setup steps

Move through these checks in order before changing deeper settings.

Open the app

Start from a package you downloaded from the Download page.

  • Launch the extracted app or package once before changing settings.
  • If a system prompt appears, confirm the file name and source before continuing.
  • Keep the original archive until the app opens successfully.

Confirm legal content boundaries

This guide does not provide or explain how to obtain keys, firmware, ROMs, or copyrighted game content.

  • Use only materials you are legally entitled to use.
  • Follow project documentation and your local law for any system file questions.
  • Do not use third-party bundles that claim to include everything in one package.

Choose a library folder

Point the app at folders you manage and can back up.

  • Use a dedicated folder rather than a random downloads directory.
  • Avoid moving files while the app is scanning the library.
  • Refresh or restart the app if a folder change does not appear right away.

Check controls and graphics

Verify the basics before chasing deeper issues.

  • Open settings and confirm your input device is visible.
  • Keep GPU drivers current and try the graphics API recommended by the app.
  • On Steam Deck, start from Desktop Mode if Game Mode controls block a dialog.

Update or roll back carefully

Canary moves quickly, so keep a working fallback path.

  • Note the current version before replacing a working build.
  • Keep Stable nearby when you want a calmer fallback.
  • Use Releases to return to a previously working project-published asset.

Minimum requirements

Check the system basics before troubleshooting a package that will not open.

Area Requirement Note
Operating system Windows 10/11, modern Linux, macOS, or SteamOS Use the package that matches your platform.
Memory 8 GB RAM minimum, 16 GB recommended Larger libraries and demanding titles may need more.
Graphics Modern GPU with current Vulkan, OpenGL, or Metal support Driver updates fix many startup and rendering issues.
Storage Enough free space for the app, settings, and user-owned content This site does not provide game files or system files.
Steam Deck SteamOS x64 using Linux packages Start with the x64 AppImage, not ARM64.
Download Canary Troubleshoot

Last checked: