faq
MGit is essentially a fork of the excellent SGit app to continue development of that codebase. The reason for forking is that the original author of SGit was no longer able to maintain the project and while I took over as maintainer of the project for a period of time, after discussions with SGit's author, my preference was to continue the work in a new project and be able to publish the app on Google Play myself, thus being able to provide some sponsorship of the project by Manichord Pty Ltd to enable me to spend more time working on it. See next question for the projects goals.
- Quite simply to be the best Git GUI client available not just for Android but on any platform.
- To build my goal to build an active community around MGit and encourage participation, active contributors will be invited to have write access and if it becomes big enough, MGit will be moved
- To also provide a usable git client for use on Chrome(books/boxes) now that Google has announced the availability of Play on ChromeOS.
As per the original project, MGit will always be free and never have ads.
Contributions of all kinds are most welcome! If you are able to do Android development fork from this repo, create a new branch, commit your changes and then send a pull request against the master branch of this repo.
If you are not a developer, other contributions such as translations, documentation, bug reports, feature requests and helping answer other users questions are all most welcome too!
A chat room has been set up on Gitter.
Adding a root certificate for a self signed certificate is done at the OS level on Android. Instructions for how to do it for Android 4 on-wards can be found here
If you are using 2FA on Github you will need to use a Personal Authentication Token as your password, please see the Github docs for more details on how to generate a token.
Using ssh with a private key with no password, the url syntax is:
[email protected]:username/my-repo-name.git
The "local path" is the folder name that the repo will get within the set root folder for MGit's repos. This can be changed in MGit's settings.
Importing a private ssh key can be done in MGit's settings also. Unfortunately the UI is not very good at the moment, what you need to do to select the private ssh key file is press the menu button:
then navigate to the file in your devices file-system and click on it to select it, If you accidentally add an incorrect file, you can remove it from the list of private key files but long pressing on it and then pressing the delete (rubbish bin) menu item.
Unfortunately MGit does not yet support SSH private keys that are password protected but I've bumped that issue to the top of my todo list (#66) as its been so widely requested.
You can also use a username & password with SSH, but in this case you need to include the username in the URL (there is an outstanding issue to fix this also #41) so the syntax you need for that is:
ssh://[email protected]/path/to/repository
Yes you can install MGit from F-Droid here