Skip to content

Update install-android.md: Installation via Obtainium, and DeGoogle notice#1109

Open
davidhedlund wants to merge 57 commits intolibretro:masterfrom
davidhedlund:patch-30
Open

Update install-android.md: Installation via Obtainium, and DeGoogle notice#1109
davidhedlund wants to merge 57 commits intolibretro:masterfrom
davidhedlund:patch-30

Conversation

@davidhedlund
Copy link
Contributor

@davidhedlund davidhedlund commented Jan 8, 2026

  • Added "Installation via Obtainium (recommended)" section.
  • Noted that the F-Droid release is incomplete.
  • Included notices about DeGoogling.
  • Described RetroArch APK package variants and how to perform multi-package installation.

Make the "Installation notes" and its sub-sections visible in the menu bar
@davidhedlund davidhedlund changed the title Update install-android.md: Complement for #1107 Update install-android.md: Another complement for #1107 Jan 8, 2026
DeGoogle notices
Removed Yalp Store, not maintained
Added "Installation via Obtainium" section
The F-Droid release is incomplete
@davidhedlund davidhedlund changed the title Update install-android.md: Another complement for #1107 Update install-android.md: Installation via Obtainium, and DeGoogle notice Jan 9, 2026
You don’t need to be signed in to adjust Play Protect settings
improve "sideloading" text
Install unknown apps
Improved phrasing for sideloading steps
The step to disable Play Protection is complex and should be read carefully to ensure success on all Android devices.
@fpscan
Copy link
Collaborator

fpscan commented Jan 9, 2026

I'm not sure about Obtanium being recommended.

Completed the Obtainium installation guide
@davidhedlund
Copy link
Contributor Author

davidhedlund commented Jan 9, 2026

I'm not sure about Obtanium being recommended.

The primary question is whether to recommend automated installation/upgrade methods like F-Droid or Obtainium over manual ones. I believe we should. If others agree, then Obtainium should be the recommended option, as the F-Droid release is still incomplete.

I encourage anyone interested in forming their own opinion to try Obtainium from F-Droid firsthand. It’s become one of the most popular Android apps for download automation in recent years—for example, it ranks among the top apps in the GitHub Store—for good reason. It’s also worth noting that Obtainium is Android TV–friendly, making it suitable for use across all Android devices, and it is downloading the apks from the buildbot archive which also is used for manual downloads.

Added: "The only difference is that Obtainium automates this process and provides update notifications, helping users stay current and avoid reporting issues from outdated versions."
Added: "It’s also worth noting that Obtainium is Android TV–friendly, making it suitable for use across all Android devices"
Moved “Installation via Obtainium” section below “Manual Downloads” and removed “(recommended)” from its heading.
@davidhedlund
Copy link
Contributor Author

I'm not sure about Obtanium being recommended.

I’ve moved the “Installation via Obtainium” section below “Manual Downloads” and removed “(recommended)” from its heading, so this PR should now be ready for approval.

@hizzlekizzle
Copy link
Contributor

I think this looks good overall, but the F-Droid stuff sounds a little negative. Perhaps it would make sense to explain why it's the way it is, like:

F-Droid comes with a minimal set of assets to keep the installation size down. You'll want to stop by the Online Updater to fetch the complete assets, autoconfiguration profiles, etc. for a complete installation.

Updated the "Installation via F-Droid (incomplete)" section. Most issues in libretro/RetroArch#16126 have been solved, but I've submitted this report since the issue persists across Google streaming devices:
* F-Droid release missing assets for armeabi-v7a ABI (32-bit ARM), pixelated fonts and icons - libretro/RetroArch#18756
@davidhedlund
Copy link
Contributor Author

I think this looks good overall, but the F-Droid stuff sounds a little negative. Perhaps it would make sense to explain why it's the way it is, like:

F-Droid comes with a minimal set of assets to keep the installation size down. You'll want to stop by the Online Updater to fetch the complete assets, autoconfiguration profiles, etc. for a complete installation.

I've spent a few hours today thoroughly reinvestigating all significant F-Droid-related issues that affect many users. See the commit:

Following hizzlekizzle's advice (libretro#1109 (comment)), added note that the F-Droid RetroArch release ships with minimal assets to reduce APK size, and requires using the Online Updater (Main Menu → Online Updater) to match the retroarch.com release.
@davidhedlund
Copy link
Contributor Author

I think this looks good overall, but the F-Droid stuff sounds a little negative. Perhaps it would make sense to explain why it's the way it is, like:

F-Droid comes with a minimal set of assets to keep the installation size down. You'll want to stop by the Online Updater to fetch the complete assets, autoconfiguration profiles, etc. for a complete installation.

I followed your advice: e286614

Thank you!

Added a new "RetroArch APK Package Variants" section with a table (6 builds: universal/stable/nightly + arch-specific aarch64/ra32) with Android 7.0+ multi-package compatibility notes distinguishing package name handling pre/post-Nougat.
@davidhedlund
Copy link
Contributor Author

Added

Android 7.0+ (Nougat): Supports multi-package handling. This makes it possible to install the universal package (com.retroarch) alongside the appropriate architecture-specific build (com.retroarch.aarch64 or com.retroarch.ra32, depending on device) without forcing an upgrade.

See 996997f for context.

Clarified instructions for installing stable and nightly builds on the same device.
Move "Installing both stable and nightly builds on the same device" under "Android 7.0+ (Nougat)"
Rename the "Compatibility Notes" section to "Multi-Package Handling"
Removed my duplicated text that I already added under the "RetroArch APK Package Variants" section
Added "Universal APK" section
Move the "RetroArch APK Package Variants" section to the topmost position. This section defines essential technical terminology, package types, architecture support, and installation compatibility referenced throughout the rest of the document. Add the remaining sections under a "Sources" section.
Fix buildbot section
RetroArch Plus note: Despite the implication of superiority in its name, RetroArch Plus builds support approximately 80 fewer cores than APKs from retroarch.com across all variants.
Added "RetroArch (stable 32/64-bit, Play Store)" and "RetroArch Plus (stable 64-bit only, Play Store)" sections
Improve "RetroArch (stable 32/64-bit, Play Store)" section
Improve "RetroArch Plus (stable 64-bit only, Play Store)" section
Fix "Installation via Google Play servers (obsolete)" sectional indentations
On Android versions prior to 8.0, the APK installation prompt displays a pre-checked "Allow this installation only" checkbox—uncheck it to quickly install RetroArch updates, which is especially relevant when subscribing to daily RetroArch Nightly downloads via Obtainium.
Incorporated a table of custom RetroArch APK package variants into each section.
Improved top table
Added "Overview" table section
Added "Title" column to the overview table
Converted the overview table to HTML to enable a colspan header.
improve multi-package installation examples
general improvements
Add subsections for issues to maintain clean section names. Improve the "Google Play servers" section.
Fix "Google Play servers" sub-section names
add stable and nightly links to the overview table
Added "Compatibility of `com.retroarch.ra32` on 64-bit ARM Devices" section
Improve "Compatibility of `com.retroarch.ra32` on 64-bit ARM Devices" section
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants