Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sheimi/SGit
A Git client for Android.
https://github.com/sheimi/SGit
Last synced: about 2 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 (over 11 years ago)
- Default Branch: master
- Last Pushed: 2021-11-18T17:21:26.000Z (about 3 years ago)
- Last Synced: 2024-08-04T04:04:30.231Z (5 months ago)
- Language: Java
- Homepage: http://tiny.cc/sgit
- Size: 23.9 MB
- Stars: 357
- Watchers: 31
- Forks: 111
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: COPYING
Awesome Lists containing this project
- awesome-git - SGit - Git client for Android 4.x (Client)
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
[](https://gitter.im/sheimi/SGit?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
[](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.