Commit ca472c3c authored by Izzy's avatar Izzy

adding README

parents
This project is about the F-Droid compatible repo running at https://apt.izzysoft.de/fdroid/
There's no code maintained here. The main purpose of this project is to enable
you to actively contribute to the repo (e.g. by suggesting apps that should be
added or removed), as well as to reach out for help. Suggestions for other
improvals are of course welcomed, too.
## What is the IzzyOnDroid Repo?
It is an F-Droid style repository for Android apps, provided by [IzzyOnDroid].
Applications in this repository are official binaries built by the original
application developers, taken from their resp. repositories (mostly Github).
You can find a more detailed description [here][1].
## What is the purpose behind it?
Many users are not happy with their devices' ties to Google, so they try to cut
them back as far as possible. Not being bound to Google's Play Store is part of
that – but the choice of apps is quite restricted outside Playstore if you
don't want to replace one „evil“ with another (i.e. switching to another
„walled garden“ like the Amazon Store) and still have the comfort of updates.
The *IzzyOnDroid* repo wants to increase the number of apps available to this
group.
## Why another repository – hasn't F-Droid its own?
Indeed it has, and a very good one at that. But they also have very strong
[inclusion criteria][2] many apps cannot meet, or are not yet ready to meet
(most common examples include „blobs“ or dependencies on proprietary
frameworks). That's where the *IzzyOnDroid* repo jumps in: Most of those apps
are acceptable here, as the requirements are lower. So while e.g. preparing to
meet the stronger criteria „over there“ (it's always preferable to aim for
that), an app can be temporarily hosted here. Other apps also have their
permanent place at *IzzyOnDroid* because they won't ever get rid of those
dependencies – for example if those are a central part of the app's
functionality.
## How can I get my favorite app listed there?
This is what this project here at GitLab was set up for: use the issues to
propose new apps. Of course, first make sure the app you wish to add isn't
already there. Then, also check it meets the requirements below.
## What are the requirements an app must meet to be included with the repo?
The app …
* should be free and Open Source
* must be targeted at end users (so no libraries, proof-of-concept demos, etc.)
* its code must be freely accessible, preferably at [Github], [GitLab], [NotABug] or a similar platform
* that code repository should have a proper description so it gets clear what it is
* the `.apk` file must be available from the project. Currently, *IzzyOnDroid* can work with files
* attached to Github `releases/`
* uploaded inside a Github repository as „part of the code“
* fixed URLs (like `https://example.com/app-latest.apk`) which can be redirects, but the web server must provide a `Last Modified` header
Running on private ressources (no funding), *IzzyOnDroid* usually reserves up
to 20 megabytes per app. That's at the same time the upper size limit for
single `.apk` files. If multiple files can fit in this limit, the repo holds up
to 3 versions. Also, certain categories of apps are not accepted – e.g. games.
Exceptions are made, but not often.
[IzzyOnDroid]: https://android.izzysoft.de/
[Github]: https://github.com/
[GitLab]: https://gitlab.com/
[NotABug]: https://notabug.org/
[1]: https://apt.izzysoft.de/fdroid/index/info
[2]: https://f-droid.org/wiki/page/Inclusion_Policy "F-Droid Inclusion Policy"
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment