https://github.com/sheimi/SGit

A Git client for Android.
https://github.com/sheimi/SGit

Last synced: 3 months ago
JSON representation

A Git client for Android.

• Host: GitHub
• URL: https://github.com/sheimi/SGit
• Owner: sheimi
• License: gpl-3.0
• Created: 2013-08-26T15:23:45.000Z (almost 11 years ago)
• Default Branch: master
• Last Pushed: 2021-11-18T17:21:26.000Z (over 2 years ago)
• Last Synced: 2024-01-08T17:33:33.667Z (6 months ago)
• Language: Java
• Homepage: http://tiny.cc/sgit
• Size: 23.9 MB
• Stars: 348
• Watchers: 29
• Forks: 112
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • License: COPYING

Lists

• awesome-git - SGit - Git client for Android 4.x (Client)
• awesome-git-cn - SGit - 为 Android 4.x 量身定制的 Git 客户端。 (客户端)

README

        
A Git client for Android.

# This project is no longer being maintained. Further development on this app is now being done in the [MGit project](https://github.com/maks/MGit). Please submit all PRs and issues there.

## Notes

[![Join the chat at https://gitter.im/sheimi/SGit](https://badges.gitter.im/sheimi/SGit.svg)](https://gitter.im/sheimi/SGit?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)

[![Build Status](https://travis-ci.org/sheimi/SGit.svg?branch=master)](https://travis-ci.org/sheimi/SGit)

 * All repositories are stored in `[sdcard dir]/Android/data/me.sheimi.sgit/files/[repo name]`. If you want to delete this app, you can manually backup repositories from this location.

 * The GitHub repo of this project is: [sheimi/SGit](https://github.com/sheimi/SGit).

 * If you encounter any issues (bugs, crashes, etc.) and want to help improve this project, please open an issue on [GitHub](https://github.com/sheimi/SGit/issues/new) describing: what the issues are; and how they were caused, to allow for re-creation and fixing of bugs.

 * This app is for Android v4.x. It **might** work on Android v2.x, but will not be supported officially due to lack of resources for testing.

## 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 (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 ` (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 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

 * Private key passphrase

 * Submodule support

 * Dark theme

 * Commits related to a file

 * Commit graph (low priority)

## License

[GPLv3](./LICENSE)

## Help

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

Fork from this repo: [sheimi/SGit](https://github.com/sheimi/SGit), create a new branch, commit your changes and then send a pull request against the **master** branch of this repo.