Repo discovery is difficult and build instructions are out of date

[foresto]

I spent all week troubleshooting various TWRP build issues, only to learn today that the source code I had synced was out of date. Why? Because discovering the correct repo to use is nearly impossible.

So far, I have found three separate repos that look official:

https://github.com/omnirom/android_bootable_recovery/
https://github.com/TeamWin/android_bootable_recovery/
https://github.com/TeamWin/Team-Win-Recovery-Project/

Every single one of them, along with the twrp.me FAQ, directs users here for build instructions:

https://forum.xda-developers.com/showthread.php?t=1943625

As of today, those instructions (posted in 2012) still say to use this repo:

https://github.com/omnirom/android_bootable_recovery/

After reporting a bug I found in that repo today, I was told that it's not the correct one after all, and was made to feel like it was my own fault for foolishly using the wrong repo. The one that literally all of your projects (that I have found so far) say to use.

For the love of sanity, I hope you folks will untangle all this. Clear, correct, non-conflicting instructions posted where people can easily find them would be very helpful. Some indication of which repos are deprecated would be a great help, too. I hate to think of others wasting as much of their time on this as I have this week.

[CaptainThrowback]

Those instructions also say that if you choose to use the minimal manifest, then everything you need should already be included. The minimal manifest is actively updated while the XDA thread isn't (as the thread owner is dealing with real life presently).

So there's no need try and figure out which repo is the correct one, as the right one is included in the source already. The thread and other locations will be updated when possible, but in the meantime, please be patient and just use the minimal manifest.

[foresto]

Those instructions also say that if you choose to use the minimal manifest, then everything you need should already be included.

Ah, yes, more conflicting instructions, this time referring to the minimal manifest, which lives in yet another repo, with a yet another github owner, and is arguably even less discoverable than the others unless you're already following the instructions that I was told today are wrong. This seems to help prove my point.

The thread and other locations will be updated when possible, but in the meantime, please be patient and just use the minimal manifest.

It's nice to finally know what to use. Thanks for your attention.

[khanra17]

I share a similar concern that has persisted long after the initial question was asked.

Specifically, I noticed that https://github.com/omnirom/android_bootable_recovery/ hosts an Android 14 branch, suggesting it might not be deprecated. However, this repository lacks branches for Android 13 and 12. On the other hand, https://github.com/TeamWin/Team-Win-Recovery-Project/ includes branches for Android 13 and 12.

Could you kindly provide clarification on the distinct roles and purposes of each repository?

[CaptainThrowback]

I share a similar concern that has persisted long after the initial question was asked.

Specifically, I noticed that https://github.com/omnirom/android_bootable_recovery/ hosts an Android 14 branch, suggesting it might not be deprecated. However, this repository lacks branches for Android 13 and 12. On the other hand, https://github.com/TeamWin/Team-Win-Recovery-Project/ includes branches for Android 13 and 12.

Could you kindly provide clarification on the distinct roles and purposes of each repository?

The only repo that matters for TWRP is https://github.com/TeamWin/android_bootable_recovery

The Omni repo hosts Omni recovery, not TWRP, and the old Team-Win-Recovery-Project repo is not current, despite what branches might be present there. I hope that clears it up.