Skip to content

Latest commit

 

History

History
133 lines (87 loc) · 5.6 KB

ReadMe.md

File metadata and controls

133 lines (87 loc) · 5.6 KB

M-Droid logo

Build Status FOSSA Status

Unofficial Material Designed client for F-Droid!

This is M-Droid, a drop-in replacement for the F-Droid client. It provides the same features but in a Material Design way that is both nice to see and easy to use.

This project started because I hate the new F-Droid UI while still loving the actual software. And as I like React-Native, this is a good project for me.

Become a patron

See the Medium story - See the Patreon post

Table of Contents

Features

MDroid attempts to mimic F-Droid features as much as possible, in a Material design fashion. Here's a (not ordered) list of actual MDroid's features:

  • Clean UI following the Material Design specifications
  • Fetching multiple repositories
  • Curated main screen showing somes apps from each categories
  • View app's details
  • Download and install any app from repositories
  • Search for apps (fuzzy search, super fast)
  • Manage (add, edit, delete) your repositories

How it works?

Basically you add your repositories of choice (along with the F-Droid, F-Droid Archive & Guardian ones) then the client will send some GET requests to actually get the content of the https://${repoBaseUrl}/index.xml file who's contains the repo.

Then it parse that file by converting the XML to JSON format, for better code efficiency. Cache the parsed stuffs and display the informations in a great way for the user.

That's Simple (c).

Screenshots

The screenshots may not be up-to-date. This is currently an early stage for the project and I'll try to update screenshots as many as possible.

2nd step: Prepare the UI! 3rd step: Display apps informations! 3rd step: moar informations! 3rd-bis step: even mooooar informations! 4th step: Install the app! 5th step: Search (fuzzy)! 6th step: Repositories managment

Default repositories

Here is the list of included repositories by default. There is no way to change which repositories the app will fetch for now, but that's definitly a planned feature.

Contributing

This is a fairly simple project so I doubt anyone is willing to contribute, but if that's the case it super simple. You can either help to catch bugs and report them, send a pull request (ESLint is configured) or just show some interest in the project!

Compile & run

This is a React Native project and by so it is super simple to build&run. Just do the following in a shell:

# Get the source & dependencies
$ git clone https://github.com/SkyzohKey/M-Droid.git
$ cd M-Droid
$ yarn # or npm install

# Run the packager
$ react-native start

# Start the app on a simulator/device
$ react-native run-android --variant=debug # or production for enhanced perfs.

Donations

I currently work on this project during my free-time, but also during my work-time. As I'm my own boss, I take work time to work on personnal projects that I really believes in. But during this time, I don't win any money. I'm not doing that for money.

Anyway, if you consider support me, you can pay me a pack of Monster's cans for moore productive coding, :D.

I accept donations in form of Monero, Bitcoin and Etherum. You can also Patreon me !

Monero

47XpVhUHahViCZHuZPc2Z6ivLraidX7AxbM8b2StdPcQGwjDGY14eqj9ippW7Pdrqj9d2y4xvwChzePQAqG1NvqQ775FKxg

Bitcoin

18BqyV9mNbFLi5HNNnfUprnPJyJDFP59Xh

Ethereum

0xe96357E4Dabd51970Bf8fcF9633Cc0c70712466e

Patreon

Become a patron

If you wish to support me, but doesn't have money for, you can still message me on Wire and give me some free hugs! :D

  • Wire handle: @SkyzohKey

License

This project is licensed under The MIT License.

FOSSA Status