README.md 11 KB
Newer Older
Ainola's avatar
Ainola committed
1
<img src="https://img.xda-cdn.com/1alP20gvsfJQN9MXLIcblm7aWSo=/https%3A%2F%2Fi.ibb.co%2FScPXnxz%2FFG-2.png" alt="Aurora Logo"><br/><img src="https://www.gnu.org/graphics/gplv3-88x31.png" alt="GPL v3 Logo">
Rahul Patel's avatar
Rahul Patel committed
2

Ainola's avatar
Ainola committed
3
# Aurora Store: A Google Playstore Client
Rahul Patel's avatar
Rahul Patel committed
4

Ainola's avatar
Ainola committed
5
*Aurora Store* is an **unofficial**, FOSS client to Google's Play Store with an elegant design. Not only does Aurora Store download, update, and search for apps like the Play Store, it also empowers the user with new features.
Rahul Patel's avatar
Rahul Patel committed
6

Ainola's avatar
Ainola committed
7
For those concerned with privacy, *Aurora Store* does not require Google's proprietary framework (spyware?) to operate; It works perfectly fine with or without GooglePlayService or [MicroG](https://microg.org/). However, those still reliant on those services are welcome to use *Aurora Store* as well!
Rahul Patel's avatar
Rahul Patel committed
8

Ainola's avatar
Ainola committed
9
While *Aurora Store* was originally based on Sergei Yeriomin's [Yalp store](https://github.com/yeriomin/YalpStore), v3.0 is a clean & complete rewrite from scratch that follows Material Design and runs on all devices running Android 5.0+.
Rahul Patel's avatar
Rahul Patel committed
10

Rahul Patel's avatar
Rahul Patel committed
11 12 13 14 15 16 17
# Screenshots

<img src="https://gitlab.com/AuroraOSS/AuroraStore/raw/master/fastlane/metadata/android/en-US/phoneScreenshots/ss001.png" height="400"><img src="https://gitlab.com/AuroraOSS/AuroraStore/raw/master/fastlane/metadata/android/en-US/phoneScreenshots/ss002.png" height="400">
<img src="https://gitlab.com/AuroraOSS/AuroraStore/raw/master/fastlane/metadata/android/en-US/phoneScreenshots/ss003.png" height="400"><img src="https://gitlab.com/AuroraOSS/AuroraStore/raw/master/fastlane/metadata/android/en-US/phoneScreenshots/ss004.png" height="400">
<img src="https://gitlab.com/AuroraOSS/AuroraStore/raw/master/fastlane/metadata/android/en-US/phoneScreenshots/ss005.png" height="400"><img src="https://gitlab.com/AuroraOSS/AuroraStore/raw/master/fastlane/metadata/android/en-US/phoneScreenshots/ss006.png" height="400">
<img src="https://gitlab.com/AuroraOSS/AuroraStore/raw/master/fastlane/metadata/android/en-US/phoneScreenshots/ss007.png" height="400">

Rahul Patel's avatar
Rahul Patel committed
18 19
# Features

Ainola's avatar
Ainola committed
20
* Free/Libre software
Rahul Patel's avatar
Rahul Patel committed
21 22
  -- Has GPLv3 licence

Ainola's avatar
Ainola committed
23 24
* Beautiful design
  -- Built upon latest Material Design guidelines
Rahul Patel's avatar
Rahul Patel committed
25

Ainola's avatar
Ainola committed
26
* Anonymous accounts
Rahul Patel's avatar
Rahul Patel committed
27 28 29 30 31
  -- You can log in and download with anonymous accounts so you don't have to use your own account

* Personal Accounts
  -- You can download purchased apps or access your wishlist by using your own Google account

Ainola's avatar
Ainola committed
32 33 34 35
* [Exodus](https://exodus-privacy.eu.org/) integration
  -- Instantly see trackers an app is hiding in its code

# What's new in v3?
Rahul Patel's avatar
Rahul Patel committed
36

Ainola's avatar
Ainola committed
37 38 39
  * Built-in download manager
  * Improved notification manager
  * Improved blacklist manager & filters
Rahul Patel's avatar
Rahul Patel committed
40
  * New UI based on latest Material Design guidelines
Ainola's avatar
Ainola committed
41 42
  * Support for split/bundled APK installations

Rahul Patel's avatar
Rahul Patel committed
43 44 45

# Downloads

Ainola's avatar
Ainola committed
46 47 48
  * Aurora OSS: [Nightlies](http://auroraoss.com/Nightly/)
  * XDA Forum: [Thread](https://forum.xda-developers.com/android/apps-games/galaxy-playstore-alternative-t3739733)
  * F-Droid: [Link](https://f-droid.org/en/packages/com.aurora.store/)
Rahul Patel's avatar
Rahul Patel committed
49

Ainola's avatar
Ainola committed
50
  `Aurora Store v3 is still in development! Bugs are to be expected! Any bug reports are appreciated.`
Rahul Patel's avatar
Rahul Patel committed
51

Ainola's avatar
Ainola committed
52
# Frequently Asked Questions
Rahul Patel's avatar
Rahul Patel committed
53

Ainola's avatar
Ainola committed
54
* <b>What is the difference between Aurora Store and Google's Play store?</b>
Rahul Patel's avatar
Rahul Patel committed
55

Ainola's avatar
Ainola committed
56
  Unlike Google's Play Store, *Aurora Store* doesn't track your downloads or the apps you use. We respect your privacy. Aurora is also unaffected by Google marking your device as *uncertified* or lacking of necessary Google apps.
Rahul Patel's avatar
Rahul Patel committed
57

Ainola's avatar
Ainola committed
58 59 60
* <b>Is *Aurora Store* a fork of YalpStore?</b>

  Technically, no. the *Aurora Store* v3 is written from scratch, but it does share some code from YalpStore.
Rahul Patel's avatar
Rahul Patel committed
61 62 63

* <b>How can I report a bug or suggest something?</b>

Ainola's avatar
Ainola committed
64 65 66
  You can open issues [here](https://gitlab.com/AuroraOSS/AuroraStore/issues), or you can join our [Telegram Developement Group](https://t.me/AuroraSupport).

* <b>How do I join/contribute to *Aurora Store*?</b>
Rahul Patel's avatar
Rahul Patel committed
67

Ainola's avatar
Ainola committed
68
  I am open to any kind of suggestions/feature request! you can either mail me at [[email protected]](mailto:[email protected]) or ping me on [Telegram](https://t.me/whyorean).
Rahul Patel's avatar
Rahul Patel committed
69

Ainola's avatar
Ainola committed
70
* <b> Why create *Aurora Store*?</b>
Rahul Patel's avatar
Rahul Patel committed
71

72
  Because Google's Play store disappoints with a lack of features; Play is also proven to be [spyware/malicious](https://www.gnu.org/proprietary/malware-google.html).
Ainola's avatar
Ainola committed
73
  Unfortunately, we cannot always get by with just FOSS apps, so *Aurora Store* helps us retrieve apps from the Google Play repository without having to trouble you and your device with Google Apps.
Rahul Patel's avatar
Rahul Patel committed
74

Ainola's avatar
Ainola committed
75
* <b>Do I need Google Play Services to use *Aurora Store*?</b>
Rahul Patel's avatar
Rahul Patel committed
76

Ainola's avatar
Ainola committed
77
  No. *Aurora Store* was built to access the Google Play store without any kind of Google services. It doesn't care if you use it with or without Google Play Services/MicroG.
Rahul Patel's avatar
Rahul Patel committed
78

Ainola's avatar
Ainola committed
79
* <b>What is the FakeStore?</b>
Rahul Patel's avatar
Rahul Patel committed
80

Ainola's avatar
Ainola committed
81
  Some poorly-designed apps detect if Google Play is missing and punish the user by misbehaving. The FakeStore is a stub that disguises itself as the Play store: FakeStore shares the same package name as the Play store (`com.android.vending`). This prevents some apps from crashing.
Rahul Patel's avatar
Rahul Patel committed
82

Ainola's avatar
Ainola committed
83
* <b>Is it safe to use Aurora store?</b>
Rahul Patel's avatar
Rahul Patel committed
84

85 86
  Aurora is fully open source and verified by FDroid. If you're talking about the safety of the apps in the store, it just gets them from the same place
  that the PlayStore would, and are verified by Google. A lot of dangerous stuff seems to sneak past them though, so as a rule of thumb, don't download anything
Rahul Patel's avatar
Rahul Patel committed
87 88
  which you're not sure about.

Ainola's avatar
Ainola committed
89
* <b>What data does *Aurora Store* send to Google?</b>
Rahul Patel's avatar
Rahul Patel committed
90

91
  *Aurora Store* does its best to send the least identifiable information possible. It does send list of package names of your installed apps (for fetching updates).
Ainola's avatar
Ainola committed
92
  It also sends your search queries and your downloads for obvious reasons.
Rahul Patel's avatar
Rahul Patel committed
93

Ainola's avatar
Ainola committed
94
* <b>Do I need to use my own Google account to log in?</b>
Rahul Patel's avatar
Rahul Patel committed
95

Ainola's avatar
Ainola committed
96
  Nope. *Aurora Store* can log you in with a dummy account so that nothing gets linked to your own account.
Rahul Patel's avatar
Rahul Patel committed
97

Ainola's avatar
Ainola committed
98
* <b>Why would I use my own account? Is it safe?</b>
Rahul Patel's avatar
Rahul Patel committed
99

100
  You can use your own account to download apps purchased by you or to access your wishlist. However, you may want to be careful as Google retains
Ainola's avatar
Ainola committed
101
  the right to block any account. It might be worth using a dummy account for that reason.
Rahul Patel's avatar
Rahul Patel committed
102

Ainola's avatar
Ainola committed
103
* <b>How do I log in if I have two-factor authentication enabled?</b>
Rahul Patel's avatar
Rahul Patel committed
104

Ainola's avatar
Ainola committed
105
  You just need to get an app password from the Google dashboard and use that to login into *Aurora Store*.
Rahul Patel's avatar
Rahul Patel committed
106

Ainola's avatar
Ainola committed
107
* <b>How do I purchase paid apps?</b>
Rahul Patel's avatar
Rahul Patel committed
108

Ainola's avatar
Ainola committed
109
  Purchase the apps from the [Google Play website](https://play.google.com/store), then log in using your own account in *Aurora Store* to download them.
Rahul Patel's avatar
Rahul Patel committed
110

Ainola's avatar
Ainola committed
111
* <b>Can Aurora store verify licences?</b>
Rahul Patel's avatar
Rahul Patel committed
112 113 114

  Not yet. All you can do at this point is pester the dev of the licenced app to give you an alternative method for verification.

Ainola's avatar
Ainola committed
115
* <b>Can I use Aurora store to get paid apps for free?</b>
Rahul Patel's avatar
Rahul Patel committed
116 117 118

  No. Get out.

Ainola's avatar
Ainola committed
119
* <b>What is the FDroid filter?</b>
Rahul Patel's avatar
Rahul Patel committed
120

121
  Since F-Droid signs APKs with its own keys, the Play store variants of apps cannot be installed over them. The F-Droid filter excludes all the apps
Rahul Patel's avatar
Rahul Patel committed
122 123
  it finds with FDroid signatures on your device to prevent such conflicts.

Ainola's avatar
Ainola committed
124
* <b>What is the spoofing feature?</b>
Rahul Patel's avatar
Rahul Patel committed
125

126
  Spoofing allows you to pretend to be any other device at any other location in the world in order to download geo-restricted apps. You can use your own custom device
Rahul Patel's avatar
Rahul Patel committed
127 128
  configs by dropping the .properties file in the Downloads directory (Settings -> Downloads -> Download Path).

Ainola's avatar
Ainola committed
129
* <b>How does *Aurora* install apps?</b>
Rahul Patel's avatar
Rahul Patel committed
130

Ainola's avatar
Ainola committed
131
  *Aurora Store* can install apps in 3 ways:
Rahul Patel's avatar
Rahul Patel committed
132
    * Manual - Whenever an app is downloaded, it will open the manual installation screen. This doesn't require root or system perms.
Ainola's avatar
Ainola committed
133 134
    * Root/System - By giving Aurora Store root or system permissions, it will automatically install apps in the background as soon as they are downloaded.
    * *Aurora Services* - By installing *Aurora Services* as system app, *Aurora Store* can automatically install app upon download completion in background.
Rahul Patel's avatar
Rahul Patel committed
135

Ainola's avatar
Ainola committed
136 137 138 139 140 141 142
* <b>How do I use *Aurora Services*?</b>

  1. Install *Aurora Services* (preferably to the system).
  2. Open *Aurora Services* and follow the initial set-up instructions
  3. Open *Aurora Services*' settings and choose Aurora Services it as an install method.

  You don't need to give *Aurora Store* system or root grants; *Aurora Services* handles all install and uninstall requests in the background.
Rahul Patel's avatar
Rahul Patel committed
143 144
  
  Get Aurora Services from [here](https://gitlab.com/AuroraOSS/AuroraServices)
Rahul Patel's avatar
Rahul Patel committed
145

Rahul Patel's avatar
Rahul Patel committed
146
* <b>How to give *Aurora Services* system permissions?</b>
Rahul Patel's avatar
Rahul Patel committed
147

Rahul Patel's avatar
Rahul Patel committed
148
  You need to either manually push the APKs to `/system/priv-app`, or install the Magisk module from the [Telegram Group](https://t.me/AuroraSupport), will also attach the same in future release tags (>3.0.7)
Rahul Patel's avatar
Rahul Patel committed
149

Ainola's avatar
Ainola committed
150
* <b>Can Aurora Download and install Split or Bundled APKs?</b>
Rahul Patel's avatar
Rahul Patel committed
151 152 153

  Yes, with or without root.

Ainola's avatar
Ainola committed
154
* <b>How can I submit/improve translations ?</b>
Rahul Patel's avatar
Rahul Patel committed
155

156
  Go to [POEditor](https://poeditor.com/join/project/54swaCpFXJ), and inform me when done.
Ainola's avatar
Ainola committed
157
  (I typically keep track of translations progress, but it's possible that I missed a contribution. If you don't receive a reply, please remind me!)
Rahul Patel's avatar
Rahul Patel committed
158

Ainola's avatar
Ainola committed
159
* <b>Why do I have two *Aurora Store* installations after installing the new builds?</b>
Rahul Patel's avatar
Rahul Patel committed
160 161 162

  Because the v3 is a completely new rewrite, it comes with a new package name. You can uninstall the older one or keep it if you want.

Ainola's avatar
Ainola committed
163
* <b>Why are the versions on F-Droid and XDA labs outdate? When will they be updated ?</b>
Rahul Patel's avatar
Rahul Patel committed
164

165
  Aurora Store is still in a development phase right now; Only infrequent, stable builds will be uploaded there. F-Droid's review & build process is also quite lengthy.
Rahul Patel's avatar
Rahul Patel committed
166 167
  You can always grab the latest tests builds either from the [Telegram Group](https://t.me/AuroraSupport) or from [AuroraOSS](http://auroraoss.com/Nightly/)

Ainola's avatar
Ainola committed
168 169 170 171
* <b>"Please add support for F-Droid/Amazon/Yada repositories!"</b>

  No, this is a Play store client only. Different clients for different services (^_~)

Rahul Patel's avatar
Rahul Patel committed
172
* <b>Installation fails without warning post downloads</b>
173

Rahul Patel's avatar
Rahul Patel committed
174 175 176 177 178 179 180
  Bundled Apps can't be installed on OEM ROMs due to shameless mods like (VirusCheck, Tracker Stats) 
  
  Workarounds: (Any 1 of the following)
  
  1. Turn off vendor optimizations (like MIUI Optimizations) [OR]
  2. Enable "Enforce Native Installer" from Aurora->Settings->Installations. [OR]
  3. Use rooted install method
181

Ainola's avatar
Ainola committed
182
 `If you are an Android App Developer and find something that can be improved/fixed/added, feel free to make a pull request.`
Rahul Patel's avatar
Rahul Patel committed
183 184 185 186 187 188 189 190 191 192 193

# Aurora Store uses the following Open Source libraries:

* [RX-Java](https://github.com/ReactiveX/RxJava)
* [ButterKnife](https://github.com/JakeWharton/butterknife)
* [OkHttp3](https://square.github.io/okhttp/)
* [Glide](https://github.com/bumptech/glide)
* [Fetch2](https://github.com/tonyofrancis/Fetch)
* [PlayStoreApi-v2](https://github.com/whyorean/playstore-api-v2)

# Aurora Store is based on following projects:
Rahul Patel's avatar
Rahul Patel committed
194 195 196 197 198 199

* [YalpStore](https://github.com/yeriomin/YalpStore)
* [AppCrawler](https://github.com/Akdeniz/google-play-crawler)
* [Raccoon](https://github.com/onyxbits/raccoon4)
* [SAI](https://github.com/Aefyr/SAI)

Rahul Patel's avatar
Rahul Patel committed
200
[<img src="https://f-droid.org/badge/get-it-on.png" alt="Get it on F-Droid" height="60">](https://f-droid.org/packages/com.dragons.aurora/) [<img src="https://poeditor.com/public/images/logo_small.png" alt="Join POEditor">](https://poeditor.com/join/project/54swaCpFXJ)