jumkey / MGit

A Git client for Android.

A Git client for Android.

This is a continuation of the SGit project (https://github.com/sheimi/SGit)

Notes

• If you encounter any issues (bugs, crashes, etc.) and want to help improve this project, please open an issue on GitHub describing: what the issues are; and how they were caused, to allow for re-creation and fixing of bugs.
• This app requires minimum of for Android v4.x.

Supported Features

• Create local repositories
• Clone remote repositories
• Pull from origin
• Delete local repositories
• Browse files
• Browse commit messages (short)
• Checkout branches and tags
• HTTP/HTTPS/SSH are supported (SSH without private key passphrase)
• Username/Password authentication is supported
• Search local repositories
• Private keys management
• Manually choose code language
• git diff between commits (to be enhanced)
• Import copied repositories (that is, you can copy a repository from computer and import to SGit)
• Checkout remote branches
• Merge branches
• Push merged content
• Edit file (you must have some app that can edit file)
• Commit and push changed files (commit all changes)
• Committer information
• Prompt for password
• Choose not to save password and username (will not be saved in disk but may be temporarily saved in memory)
• git status
• Cancel when cloning
• Add modified file to stage
• git rebase
• git cherrypick
• git checkout <file> (reset changes of a file)

Quick start

Clone a remote repository

1. Click on the + icon to add a new repository.
2. Enter remote URL (see URL format below).
3. Enter local repository name - note that this is not a full path since SGit stores all repositories in the same directory on the mobile device.
4. Username - username to use to clone the remote repo.
5. Password - password to use to clone the remote repo.
6. Click the Clone button.
7. If all the credentials are correct, SGit will download the repository (all branches) to your device.

Create a local repository

1. Click on the + icon to add a new repository.
2. Click on Init Local to create a local repository.
3. Enter the name for this repository when prompted.
4. A local repo will be created.

URL format

SSH URLs

• SSH running on standard port (22): ssh://username@server_name/path/to/repo
• SSH running on non-standard port: ssh://username@server_name:port/path/to/repo
• username is needed - by default, SGit tries to connect as root.

HTTP(S) URLs

• HTTP(S) URL: https://server_name/path/to/repo

To Do List

Future enhancements are tracked on Github

License

GPLv3

Help

If you want to help improve this project, contributions, especially translations are very welcome.

Fork from this repo, create a new branch, commit your changes and then send a pull request against the master branch of this repo.