Übersicht | GitFinder Widget

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

Display your Git projects on your Mac OS X desktop with Übersicht. GitFinder scans Finder visibles windows and displays statistics for your Git projects.

It looks for current branch, remote branch, total branches, files added, modified, untracked and ignored, and project 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.

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.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