multigit-gx 1.8.0

Multigit is a graphical tool designed to simplify working with projects composed of multiple git repositories.

Multigit

by Philippe Fremy at IDEMIA (philippe.fremy at idemia.com)

Multigit is a graphical tool for working with projects composed of multiple git repositories.

If you think that submodules, subtree or Google repo are not for you, you are probably at the right place.

Typically, it lets you:

• fetch or pull on many repositories at the same time
• identify visually which repositories are modified or need an update (push or pull)
• create a new branch in a subset of repositories
• switch to a branch existing only in some repositories (but you don't remember which one)
• perform a commit on multiple repositories at the same time, and push it
• launch your preferred git frontend on an interesting repository
• export your repositories state to a file, for reproducing it on a colleagues computer
• and more...

https://github.com/user-attachments/assets/42327500-bc9d-4b52-82fd-b7dc85aff145

The need arose from my work environment, where a project typically consists of thirty to fifty git repositories. In such environment, every simple git operation becomes a complex task. Thank to Multigit, it becomes simple again. Any git operation like git fetching in the morning is run on all the repositories in one click. When time comes to commit changes and push them, having a graphical interface to locate in the blink of an eye which repositories are modified and need a commit has been a life saver.

Multigit is Open source and developed in Github. It has been developed intially within my employer IDEMIA. I would like to thank them again for allowing me to open source it.

Status

Multigit has been used widely for several years within IDEMIA, it's mature and stable.

Platform support:

• Windows: rock-stable, primary development platform, used everyday
• Linux: stable, but small user base so far. Validated on: Ubuntu 22.04, Ubuntu 24.10 and Linux Mint 22
• MacOs X: working, but with limited user base so far

Installation

Multigit is installation is possible through different formats and on different platforms:

Windows

Classic installer

Classic Windows installer is available on the GitHub release page as Multigit.OpenSource.X.Y.Z.exe. Just run it and look for Multigit in your Applications.

Chocolatey package

Multigit is available as a Chocolatey package, which is the recommended way to install it on Windows. Just run:

    choco install multigit

Linux

Python package

Multigit is available as a Python package on PyPi, but it is recommended to use pipx to install it, as it will be installed in an isolated environment and will not interfere with your system Python or other Python packages.

    $ sudo apt install pipx
    $ pipx install multigit_gx
    $ pipx ensurepath
    (open a new terminal to have pipx in PATH)
    $ multigit

Note: on PyPi, Multigit is registered as multigit_gx because there is already a multigit software . The recommended way is to use pipx to install it:

Adjustments when running on Linux

On Ubuntu:

If you are getting the following error when running Multigit:

qt.qpa.plugin: From 6.5.0, xcb-cursor0 or libxcb-cursor0 is needed to load the Qt xcb platform plugin.
qt.qpa.plugin: Could not load the Qt platform plugin "xcb" in "" even though it was found.
This application failed to start because no Qt platform plugin could be initialized. Reinstalling the application may fix this problem.

Available platform plugins are: offscreen, wayland-egl, vnc, eglfs, minimal, vkkhrdisplay, linuxfb, wayland, minimalegl, xcb.

Aborted

You need to install libxcb-cursor0:

sudo apt install libxcb-cursor0

Then it works.

On a Gnome desktop (typically Ubuntu or Linux Mint)

By default, Qt application have no window borders or decorations, making them difficult to spot. The fix is to install Qt theme or Qt plugin to your desktop environment.

This worked for me by for example:

sudo apt install libxcb-cursor0 libxcb-composite0 
export QT_QPA_PLATFORM=xcb

Future

We are working on providing multigit as a snap and as a flatpak, but it is not available yet.

License

Multigit is released under the Apache 2.0 license.

Multigit depends on several other open source projects:

• Python
• PySide/Qt for Python
• Concurrent Log Handler
• PyInstaller

See the file FULL_LICENSING_INFORMATION.md for details.

Contributions

Contributions are welcome: bug reports, improvements, pull requests. They must be under the Apache 2.0 license.

Multigit is developed both as an open source version and internally at IDEMIA. I will make sure that the Open Source versions thrives. The plan is to share improvements done internally at IDEMIA to the Open Source version on a regular basis.

See the file CONTRIBUTING.md for details .

If you want to exchange with the author, do not hesitate to contact me: philippe.fremy at idemia.com

History and Alternatives

When I started to search how to solve the run one operation on multiple git repositories problem, the only tool I found was Google's repo . But it did not fit my requirements:

• It is command-line based but I wanted a graphical tool
• It requires to learn a new set of commands to operate, whereas I wanted to keep the git process and knowledge.

I also looked at git submodules but for the same reason, I did not like this solution: not graphical, complexifies the workflow and requires learning a new set of commands.

So, Multigit was born. Internally at IDEMIA, people love it for how it made their life simpler in environments with 40 git repositories, without a learning curve for a new tool. Just use your git knowledge.

Since the development of Multigit, other tool with similar functionality have emerged (some of them also named Multigit). However, from my last inspection, they are all command-line tools. Multigit is the only one providing a graphical interface.