You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
**Download the [latest build](http://builds.phere.net/GitX/development/GitX-dev.dmg)* for OS X 10.8 Mountain Lion and newer. OS X 10.7 Lion and 10.6 Snow Leopard users please see *Older releases* below.
57
-
* Browse the [project releases page](https://github.com/rowanj/gitx/releases) for milestones and preview builds.
58
-
* Jump straight to the [latest milestone build](https://github.com/rowanj/gitx/releases/latest)
59
-
60
-
GitX-dev uses the [Sparkle](http://sparkle.andymatuschak.org/) framework for in-app updates; so once you have version 0.11 (December 2011) or later, you can check for or update to new builds from the GitX menu at any time, or opt-in for automatic updates.
61
-
62
-
## Older releases
63
-
64
-
Milestone releases are uploaded to the [GitHub project releases page](https://github.com/rowanj/gitx/releases).
65
-
66
-
Older binary archives (predating the GitHub releases system) are available on the [GitHub project downloads page](https://github.com/rowanj/gitx/downloads).
67
-
68
-
The last build compatible with OS X Lion (10.7) is [0.15.1949](http://builds.phere.net/GitX/development/GitX-dev-1949.dmg), from July 27th 2014. Among the reasons that OS X 10.7 support has been dropped is that it does not fully support ARC, application sandboxing, and other modern programming features like XPC services. It also breaks in ways that cannot be reproduced on newer platforms, and so has been a disproportionate support load; and a poor experience for users on this platform.
69
-
70
-
The last build compatible with OS X Snow Leopard (10.6) is [0.14.81](http://builds.phere.net/GitX/development/GitX-dev-81.dmg), from February 4th 2013. Among the OS X features that Snow Leopard does not support is Objective-C ARC, which is now the only non-deprecated memory management system on OS X.
71
-
72
-
OS X Mountain Lion (10.8) support for new builds will be ending soon, probably around Q2 2015.
73
-
74
-
The maintainence strategy will be as with Snow Leopard and Lion,
75
-
a legacy build will be earmarked for any new installs on these platforms.
76
-
77
-
78
-
# Features
79
-
80
-
The project is well underway, and based on the solid foundations of GitX and
81
-
GitX (L), used day-to-day by our developers. We consider GitX-dev to be
82
-
close to feature-complete, with very few workflows dependant on manual
83
-
command-line `git` usage.
84
-
85
-
* History browsing of your repository
86
-
* See a nicely formatted diff of any revision
87
-
* Search based on author or revision subject
88
-
* Look at the complete tree of any revision
89
-
* Preview any file in the tree in a text view or with QuickLook
90
-
* Drag and drop files out of the tree view to copy them to your system
91
-
* Support for all parameters git rev-list has
92
-
* Good performance on large (200+ MB) repositories
93
-
94
-
# Development
95
-
96
-
Developing for GitX-dev has a few requirements above and beyond those
97
-
for mainline GitX.
98
-
99
-
Most third-party code is referenced with Git submodules, so [read up](http://book.git-scm.com/5_submodules.html) on those if you're not familiar.
100
-
101
-
* Very recent Xcode install, 5.1 release strongly recommended.
102
-
* Most development is done on OS X Mavericks, earlier host platforms may or may not work at all.
103
-
*`Homebrew` and `xctool` for running Objective-Git’s `bootstrap` script.
104
-
*`CMake` with a working command-line compiling environment for building `libgit2`.
105
-
*`node.js` for building `SyntaxHighlighter` (not necessary unless you're updating SyntaxHighlighter itself.)
106
-
107
-
To get GitX-dev to compile locally you need to:
108
-
109
-
1. Clone the repository locally: `git clone https://github.com/rowanj/gitx.git`
110
-
2. After cloning it `cd gitx` and then recursively initialize all submodules: `git submodule update --init --recursive`
111
-
3. Then prepare objective-git by running its bootstrap script: `cd objective-git && ./script/bootstrap`
112
-
4. Then compile objective-git `cd objective-git && ./script/update_libgit2`
113
-
114
-
After that you should be able to open the Xcode project and build successfully.
115
-
116
-
# License
117
-
118
-
GitX is licensed under the GPL version 2. For more information, see the attached COPYING file.
119
-
120
-
# Usage
121
-
122
-
GitX itself is fairly simple. Most of its power is in the 'gitx' binary, which
123
-
you should install through the menu. the 'gitx' binary supports most of git
124
-
rev-list's arguments. For example, you can run `gitx --all` to display all
125
-
branches in the repository, or `gitx -- Documentation` to only show commits
126
-
relating to the 'Documentation' subdirectory. With `gitx -Shaha`, gitx will
127
-
only show commits that contain the word 'haha'. Similarly, with `gitx
128
-
v0.2.1..`, you will get a list of all commits since version 0.2.1.
129
-
130
-
# Helping out
131
-
132
-
Any help on GitX is welcome. GitX is programmed in Objective-C, but even if
133
-
you are not a programmer you can do useful things. A short selection:
134
-
135
-
* Give feedback
136
-
* File [bug reports](https://github.com/rowanj/gitx/issues?labels=Bug) and [feature requests](https://github.com/rowanj/gitx/issues?labels=Feature).
0 commit comments