[Feature Request] Add "Restart" option to Main Menu on Android / Android TV

Open
#20,088 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 2 days

Nobody has claimed this yet.

Assessment

Difficulty
4/5
Estimated time
Over a week
Newbie friendliness
22/100
Issue type
Feature
Clarity
Mostly clear
Activity status
Active
Tech stack
android, c
Domain
mobile-dev

Research direction

The request is for a Restart entry in the Android Main Menu, matching the desktop Main Menu → Restart behavior. The payload names no source files, so the starting point is finding where the desktop restart is implemented in the menu code and how the Android activity handles relaunch. Done would mean a restart option that reloads the app on Android and Android TV, but the issue's comment thread and the maintainers' view on the removed Quit option are not in the payload and should be checked first.

Written by the indexing model from the issue text.

Description

feature request

Is your feature request related to a problem? Please describe.

On Android and Android TV (e.g., Google TV Streamer), changing settings that require a restart requires manually closing or force-stopping and relaunching the app from the OS level.

For example, switching the menu driver:

  1. In RetroArch, navigate to Settings → Driver.
  2. Select Menu (Menu driver to use. (Restart required)) and change the value to rgui (or another driver).

Currently, applying this setting requires one of the following workarounds:

On Android TV (e.g., Google TV Streamer)

  1. Press the HOME button on the remote to exit to the Android TV dashboard.
  2. Navigate to Android TV Settings → Apps → See all apps → RetroArch.
  3. Select Force stop, then select Open to relaunch RetroArch and apply the change.

Aside from being extremely inconvenient, the lack of a built-in restart option creates a real risk of novice users submitting false bug reports when settings fail to apply. Many users will mistakenly assume that simply pressing the Home button and reopening RetroArch from the launcher restarts the app, rather than just backgrounding and resuming the existing process.

On Android (mobile/tablet)

  1. Tap Android's Overview button (from the Three-Button Navigation bar, or swipe up and hold if using gesture navigation).
  2. Swipe up on the RetroArch card to close it.
  3. Reopen RetroArch to apply the change.

Describe the solution you'd like

Add a Restart option to the Main Menu (Main Menu → Restart), matching the behavior available on desktop platforms. This would allow users to quickly reload RetroArch and apply settings that require a restart without leaving the app or manually closing/force-stopping it through Android system settings or the app switcher.


Describe alternatives you've considered

  • Settings → User Interface → Menu Item Visibility → Show 'Quit RetroArch' (enable) — it is disabled on Android releases but enabled on desktop releases.

Additional context

  • Platforms: Android / Android TV (tested on Google TV Streamer)
  • Desktop builds of RetroArch already utilize Main Menu → Restart for this exact workflow, making it a familiar and expected quality-of-life feature for users configuring cores, video/menu drivers, or other restart-dependent settings.
  • Note: The option Settings → User Interface → Menu Item Visibility → Show 'Restart' is visible on desktop releases because they feature Main Menu → Restart. Consequently, this toggle will naturally apply and become available on Android as well once Main Menu → Restart is implemented.
Dominant language
C
Stars
14.6k
Forks
2.4k
Avg merge
2d 5h
Merged PRs (30d)
63

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from libretro/RetroArch

All issues in libretro/RetroArch

Similar issues

More C issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.