The trial version of GitFinder is fully functional for 30 days. After that period, GitFinder will work with ONLY ONE git repository, the first one you browse into in Finder after launching GitFinder. All other git repositories will be ignored (no icon badges nor commands in the contextual and toolbar item menus).
Icon badges and menu commands in Finder are provided by a Finder extension embedded in GitFinder. The first thing to check is if GitFinderSync extension is enabled. It should be automatically enabled the first time you launch GitFinder, but perhaps something went wrong with OS extension system. Open System Preferences > Extensions, there should be Finder section in the list to the left of the window. Reveal Finder section and in the list that appears on the right there should be GitFinderSync extension listed. Tick the checkbox on the left of extension name to enable it.
If GitFinderSync extension is enabled, but you still don't see any badges nor git menu commands while GitFinder is running, check if the extension is running as well. Open Activity Monitor application and see if the process named GitFinderSync is running. If it is not, then it wasn't started by the OS. GitFinderSync extension is started by the OS, not by GitFinder itself. In order to ensure reliable starting or the extension, GitFinder HAS to be installed in either /Applications (OS applications folder) or ~/Applications (your home applications folder). Installing GitFinder in any other location DOES NOT ensure successful start of the extension. It may work, but it also may not.
If GitFinderSync is running but you still don't see icon badges nor git menu commands, perhaps you forgot to add folders where your repositories reside into Repo Folders in GitFinder preferences. This has to be done due to a way Finder extensions work (and partially due to GitFinder's sandboxed nature). Go to GitFinder > Preferences > Repo Folders and add your repository folders. Note that you don't need to add to the list separate folder for each repository. If, for example, all your repositories are located in a single folder, you can add only that parent folder. GitFinder will look for repositories down the folder hierarchy.
If everything above is fine, and you still don't see icon badges (but you do see git menu commands), GitFinder extension may be colliding with other Finder extensions. This happens if your git repository folder is monitored by multiple Finder extensions. In such case, please make sure GitFinderSync extension comes first in System Preferences > Extensions > Finder. You can reorder extensions in the list by simple drag and drop.
Note for Dropbox users: official Dropbox application shows icon badges and dropbox menu commands only for folder set in Dropbox preferences (the default is ~/Dropbox). However, Dropbox Finder extension monitors your ~/Documents (home documents folder) as well even though it doesn't show any badge, nor does it offer any Dropbox menu command for it. If your git repository is located anywhere in ~/Documents, make sure GitFinderSync is above Dropbox Finder Integration in the list of extensions in System Preferences > Extensions > Finder.
Finally, some system folders cannot be monitored by Finder extensions. Such folders are iCloud Drive, /System and /Library (system and system library folders). If your git repository is located inside those folders (which is highly unlikely), GitFinder cannot show icon badges nor offer git menu commands.
Icon badges shown in Finder and provided by GitFinder are divided in two groups:
Here is the complete list:- file is up-to-date (no changes)
GitFinder integration is provided by a Finder extension GitFinderSync, which primary function is integration with Finder. Hence, GitFinder doesn't integrate with other file managers for macOS.
Currently, GitFinder integrates with the following diff tools:
The following merge tools are supported:
In order to use supported tool, GitFinder's scripting support needs to be installed. The first time you try to use diff/merge tool from GitFinder, it will offer you to install scripting support. Just follow a single step procedure. After that, all installed tools from the lists above will automatically appear in the GitFinder > Preferences > Git Config.
GitFinder doesn't use git command line tool for its functioning, it solely relies on using a separate library for git operations. This means any kind of collision between GitFinder and any other client (including git command line tool) is not possible. You can use GitFinder with any other git client running at the same time.
In a sad case of wanting to get rid of GitFinder, it's easy as dragging its icon to the Trash and emptying the Trash. In a highly unlikely case of getting alert "The item “GitFinder” can’t be moved to the Trash because some of its extensions are in use", open Activity Monitor, find GitFinderSync process, select it and perform Force Quit on it. After that you'll be able to delete GitFinder.
Forgot your license key?
Feature request or bug report?
If you are on GitHub, the fastest way is to use GitFinder bug and issue tracker.
Not on GitHub or have a sales issue, bug report, feature request, feedback?
Please use the form below.