Ü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