Übersicht | GitFinder Widget

📕 Übersicht Homepage :pushpin: Übersicht Widgets :page_facing_up: Widgets GitHub Repo

Display your Git projects on your macOS desktop with Übersicht.

Open projects versioned with Git with the Finder or Xcode and GitFinder displays statistics of them.

It looks for current branches, remote branches, total branches, files added, modified, untracked and ignored, and projects ahead, behind state.

The program also check if project has been modified to apply modification and add the new git project to the list with a nice animation.

Additionally, you add additional Git project paths in the Config file.

Finder: Scans for visible windows containing a folder versioned with Git
XCode: Open the active XCode Project

Installation

Put the widget into the Übersicht Widget folder and the folder which contains the NodeJS script elsewhere.

I have a folder for the Übersicht widget, and a folder for the Command Scripts like this:

📂 Ubersicht
:file_folder: Widgets
:file_folder: Command

Change command path

Change the absolute path of the command in the widget script.

command: "/usr/local/bin/node /full/path/to/the/Command/GitFinder.command/GitFinder.js"

Download Latest

GitHub > Ubersicht-GitFinder > Latest Release

config.json

Edit the config.json located in the command folder to personalise the widget.

{
    "additionals_paths": [],
    "prefs": {
        "backStyle": {
            "background-color": "rgba(0,0,0,0.3)",
            "border": "solid 1px rgba(255,255,255,0.1)",
            "color": "white"
        },
        "applyBackStyle": false,
        "showMark": true,
        "showSize": true,
        "position": "TL|20|20",
        "statsAfter": false,
        "statsBigger": false,
        "showIgnored": true,
        "autoFade": false,
        "autoFadeTimeout":8000
    }
}

additionals_paths: Absolute paths list of static Git Projects
backStyle: Change the background appearence
applyBackStyle: Apply the custom style
showMark: Show the name at bottom left
showSize: Show the project folder size
position:
- Top Left: TL|left_margin|top_margin
- Top Right: TR|right_margin|top_margin
- Bottom Left: BL|left_margin|bottom_margin
- Bottom Right: BR|right_margin|bottom_margin
- Center on screen: C|0|0
statsAfter: If true display the stats after the branch
statsBigger: Bigger font for stats
showIgnored: Display/Hide ignored files counter
autoFade: Auto fade widget on inactivity
autoFadeTimeout: Auto fade timeout

Versions

v0.4
- Remove duplicates projects
- Open active XCode Project
v0.3
- Time format
- Enhance stop function
v0.2
- Display Project Size (config: showSize: true)
- Large projects name are displayed correctly
- Minimized windows in the dock are also displayed

neoswallow / Ubersicht-GitFinder