Skip to content


RetroAchievements are a way to log your achievements on oldschool console games. It is integrated into RetroArch and is only supported by select cores (see list below).

IMPORTANT NOTE: The RetroAchievements feature is continuously being worked and improved. Then if you downloaded (or even worse: bought) a custom RetroPie image, there's a chance you have an outdated RetroArch version and face compatibility issues with the achievements feature. For a better experience, it's recommended to use the official RetroPie image and keep RetroArch and libretro cores up to date.

You first need to create an account at and then add your credentials to /opt/retropie/configs/all/retroarch.cfg

cheevos_username = "yourusername"
cheevos_password = "yourpassword"
cheevos_enable = true

The Hardcore Mode disables the savestates and is optional. If you want to enable it add this line too:

cheevos_hardcore_mode_enable = true

If you want to see some more RetroAchievements related message right after launching a game (such as successfull login and the number of cheevos you have unlocked) you can use the Achievements Verbose Mode:

cheevos_verbose_enable = true

Since RetroArch 1.6.8 the RetroAchievements Leaderboards feature is also supported. You can enable it with this config:

cheevos_leaderboards_enable = true

Supported Systems:

  • NES
  • SNES
  • Game Boy
  • Game Boy Color
  • Game Boy Advance
  • Nintendo 64
  • Nintendo Virtual Boy
  • Mega Drive / Genesis
  • SG-1000
  • Master System
  • Game Gear
  • Neo Geo Pocket
  • Neo Geo Pocket Color
  • Atari 2600
  • Atari 7800
  • Atari Lynx
  • PC Engine
  • ColecoVision
  • Arcade (Neo Geo, CPS1, CPS2 and CPS3) - only with fbalpha core.
  • PC-8800 - unfortunately there's no libretro core for it. You'll have to use their Windows-only emulator RAQUASI88

A libretro core compatibility list with RetroAchievements can be found in libretro docs.

RetroAchievements Messages

A common user question is "How do I increase the size of the RetroAchievements messages on RetroArch?".

Actually this configuration is done by changing the font size of all the RetroArch messages, not only the RetroAchievements related ones. How to do it:

Open the file /opt/retropie/configs/all/retroarch.cfg and change the line with video_font_size. Values between 26-32 should be good on a 40" TV.

If you are used to configure RetroArch with RGUI (not the default on RetroPie), you can go to Settings -> Onscreen Display -> OSD Message Size and change it.