Latest GitHub version as a ZIP file:
https://github.com/mdoege/MT-GitSync/archive/master.zip (v4.2; updated 2017-03-19)
GitHub repo:
https://github.com/mdoege/MT-GitSync
License: CC0
(For developers: Tools for maintaining the mod list are in the gitsync-devel repository.)
Screenshot
Features
- Works on Windows, macOS (OS X), and Linux
- 1,627 mods in included database (subgames and texture packs are also added now, but they are not very complete yet)
- You can also enter author/repository name manually
- Dependencies get installed automatically
- Also supports Gitorious/Bitbucket/etc. repository URLs
- Click "Info" to open the forum topic for a mod in the web browser
You need:
- Python (3.x or 2.7) from https://www.python.org/downloads/windows/ (Windows) or Homebrew ("brew install python", OS X)
- git from http://git-scm.com/downloads or Homebrew ("brew install git"; OS X)
- The git binary must be somewhere in your path. On Windows this is an option you have to select in the git installer!
- On some Linux distributions such as Ubuntu, Tkinter is not installed by default, so python-tk (for 2.7) or python3-tk are needed too.
First set up the path to your MT mods directory by clicking on the "Set directory" button. Then you can either install a new mod (enter GH user name +"/" + repo name and click Install; clone URLs from others sites like Bitbucket or Gitorious also work) or update all mods. You can also select a mod from the built-in mod database.
"Info" opens the GitHub page for the currently selected mod. The "Sorted" checkbox toggles between the default view (sorted A-Z) and the most recent view (latest additions to the mod database at the top.) For some mods, ratings from Krock's MT mod database are displayed, e.g. "[+3/-1]" means three upvotes and one downvote. Repositories prepended with "0>>>" (at the top of the list by default) are already downloaded.
Instead of a mods directory, you could also point this utility e.g. to a "worldmods/" folder in a world directory. Or to your textures folder to clone and update texture packs from GitHub in this way. This tool is fairly general-purpose and works for other git repositories too, not just MT mods.
This program will show an error message in the activity log area if e.g. you try to add a mod that is already installed. So it should be pretty safe to use and not screw up you mods directory.
Notes for mod creators
Make sure git is configured not to pull if a different branch is checked out locally. This should be the standard safe behavior for new git installations, but older git configs might be set up for different default behavior.
A directory containing the file "._MTGITSYNC_IGNORE_" will be skipped during updates, so this is a way to protect mods you are developing yourself. After an update, the program will also print a summary about skipped mods. Don't forget to add this filename to your .gitignore however, otherwise the file will be uploaded to the GitHub repo too and will block updates for everyone else who uses MT-GitSync!