Sc2gears Manage StarCraft 2 Replays

Sc2gears is a general StarCraft 2 utility for everyone who is interested in the game (either a player or just a game analyzer).

The program is written in Java, so everyone can use it: Windows, MAC OS-X and Linux users (and others where you can install Java SE).

Click here to download

Installation

Download the newest version from this page: Downloads. Extract the zip to anywhere you like. You're done!

Download the latest release

Sc2gears for all operating systems (Windows, Linux and MAC OS-X):  Sc2gears-0.82  (1.28 MB)

Note that on Linux and MAC OS-X you have to set executable permission on the starter script. Open a console/terminal, navigate to the Sc2gears folder where you extracted it, and execute the following command:

Linux: "chmod +x Sc2gears-linux.sh"
OS-X: "chmod +x Sc2gears-os-x.sh"

It only has to be done once. After that you can start Sc2gears with the following command:

Windows: double click on the "Sc2gears-win.cmd"
Linux: "./Sc2gears-linux.sh"
OS-X: "./Sc2gears-os-x.sh"

Update from an older release

Sc2gears contains an automated self-updater. It should notify you on startup if a new version is available if you didn't disable it. Just press the "Update" button when it pops up. You can force an update check in the About menu. The self-updater will delete/overwrite all files outside of the "User content" folder, and it will keep your lists, settings and logs (they are saved in the "User content" folder).

If the self-updater doesn't work for you, just download manually the latest release, extract it to anywhere, and optionally copy the "User content" folder from the old version to keep all your settings and logs.

Requirements

You just need Java Runtime Environment 6.0 or newer (Java 6.0 Update 10 or newer is required for the Nimbus theme).

Nothing else is required, you don't even need StarCraft 2 to run this program.

You can install Java here: http://java.com/

Sc2gears is not a 3rd party program!

Sc2gears is an independent program: it does not interact with StarCraft 2, it does not read or modify StarCraft 2's memory. Sc2gears is legit by Blizzard's terms of use.

That being said, you can use it anywhere, with or without any other launchers or programs, and you can never be banned for using it.

Replay search

The replay search operates on a replay source. A replay source is a set of folders and StarCraft 2 replay files. A replay source will appoint a set of StarCraft 2 replay files which are either listed in it explicitely, or which are inside one if its listed folders recursively.

This set of replays will be then filtered by fields provided by the user. The output of this filtering process is the result of the search.

Search filters:

Basically you can search by any fields that are stored and parsed from the replay: file name, map name, player names, match-ups, units that were trained, buildings that were built, all kinds of abilities/spells what were used. You can even search replays by the in-game chat messages.

There is a search group for every property that you can search by. There is a logical AND connection between search groups. Search groups consist of search fields. Inside of a search group each search field can define a condition to the replay property belonging to the search group. Search fields inside of a search group are connected with logical OR.

For example if you want to search for replays that was played on the map "Metalopolis" and contains a player named "Dakota" or "TheWinds", then this is how you can do it:

* Enter the map name "Metalopolis" to the map name search group
* Enter the name "Dakota" to the player name search group.
* Add another field to the player name search group (click on the green plus icon), and enter the name "TheWinds".

Game Length filter: you can specify game length in 3 formats: either a number of seconds (example: 120), in min:sec format (example: 23:20) or in hour:min:sec (example: 1:30:0).

Providing the filters is optional: if you leave all filter fields unchanged, the search process will list all replays denoted by the replay source.

Replay search

The replay search operates on a replay source. A replay source is a set of folders and StarCraft 2 replay files. A replay source will appoint a set of StarCraft 2 replay files which are either listed in it explicitely, or which are inside one if its listed folders recursively.
This set of replays will be then filtered by fields provided by the user. The output of this filtering process is the result of the search.
Search filters:
Basically you can search by any fields that are stored and parsed from the replay: file name, map name, player names, match-ups, units that were trained, buildings that were built, all kinds of abilities/spells what were used. You can even search replays by the in-game chat messages.
There is a search group for every property that you can search by. There is a logical AND connection between search groups. Search groups consist of search fields. Inside of a search group each search field can define a condition to the replay property belonging to the search group. Search fields inside of a search group are connected with logical OR.
For example if you want to search for replays that was played on the map "Metalopolis" and contains a player named "Dakota" or "TheWinds", then this is how you can do it:

• Enter the map name "Metalopolis" to the map name search group
• Enter the name "Dakota" to the player name search group.
• Add another field to the player name search group (click on the green plus icon), and enter the name "TheWinds".

Game Length filter: you can specify game length in 3 formats: either a number of seconds (example: 120), in min:sec format (example: 23:20) or in hour:min:sec (example: 1:30:0).
Providing the filters is optional: if you leave all filter fields unchanged, the search process will list all replays denoted by the replay source.
Replay search features:

• You can assemble, load and save replay sources. The replay source files are UTF-8 encoded text files.
• You can save and load replay lists. Replay lists are UTF-8 encoded CSV text files which means you can even open them with Excel for example for further processing. You can also comment replays which will be saved in the replay list file.
• Double click on a replay will open it in a Replay analyzer. Right click on the replay will give you advanced replay operations.
• You can rearrange the replay list columns by dragging the column headers, and you can sort by any column by clicking on the column header (clicking again will reverse the list).

Performance: Sc2gears is capable of loading thousands of replays almost instantly from replay lists, and in a few seconds from replay sources.

When you right click on the selected replays on a results tab, you will have the following advanced replay operations available:

• Open replay in analyzer
• Watch replay: if StarCraft II is not running, this will start it and begins to play the replay
• Copy replays
• Move replays
• Pack replays into a ZIP archive (with or without file paths)
• Rename replays based on a template you specify
• Delete replays
• Open the replay's folder

A simple-to-use but powerful Race match-up filterThis filter allows you to search replays where specific races were used. You can enter race letters you're looking for. Symbols (in English): P - Protoss, T - Terran, Z - Zerg, R - Random, v to separate teams, * to match all races. Examples: ZvT, TvR, Tv*, ZPvPT, ZZv**, ZTP.

If you don't provide team separation just race letters, it will list replays where the indicated races were used. Example: if you search for "ZPT*", it will list replays where all races were used, and there was at least a 4th player. If you provide team separation, it will list replays where the grouped races were in the same team.

The "Exact match" property in case of this filter means: if it is checked, only replays that have exactly the same amount of teams and races as specified will be listed. For example ZvZ without exact match will also list ZTvZP for example. ZvZ with exact match will only list ZvZ.

Note 1: if you have a replay of TvR which turned out to be TvZ, it will match both "TvR" and the "TvZ" patterns, but not the "TvP" pattern for example.

Note 2: if you have a replay of TvZ (chosen T and Z, not random), it will not match the "TvR" pattern.

Note 3: the race letters are the first letters of races [b]in the language of Sc2gears[/b]! For example in Swedish the letter for Random is 'S'. The tool tip shows the proper letters of races in the language of Sc2gears.

Note 4: the Race match-up filter can be combined with the Match-up filter of course, but care must be taken as they might work against each other (for example searching for "1v1" and "**v**" will never give any results).

Replay analyzer

The replay analyzer is meant to show various information about a replay, and show some statistics about the game and players in it.
Currently it has the following areas:

• Charts and player actions: displays the actions of the players, and draws various charts.
• Game info: a simple text panel showing important information about the replay.
• In-game chat: a formatted text panel showing the in-game chat with time stamps and with the player's in-game colors. You have option to show the conversation in paragraphs.
• Map preview: it shows a zoom-able icon of the map the game was played on.

When you want to open a replay file, you will see a replay preview (info+map preview image) on the file chooser dialog for the selected replay so you will know if that's the replay you want to open. This applies to all file chooser dialogs where you have to select replays.
Features of the charts tab:

• 3 chart types as of now:
• APM: Displays the APM charts of the players over time. APM means Actions Per Minute, it's a measurement of how active a player is, how many actions he/she issues averaging to 1 minute.
• Hotkeys: Displays the hotkeys usage of players over time. By hotkeys in this case we mean unit grouping: assinging a group of uints (or buildings) to a number, or to press that number to select the group.
• Builds/Tech: Displays the build, train, research and upgrade actions of the players over time.
• On the APM chart you can set the granularity in pixels and the curve approximation (linear or cubic).
• On the Hotkeys chart you can visualize the Assign and Select hotkeys (you can hide select hotkeys).
• On the Builds/Tech chart you can visualize the Build, Train, Research and Upgrade actions. You can enable/disable any of it, and you can choose whether to display workers if Train actions are displayed.
• A colored action list with action icons is displayed below the charts, you can filter it by action types. Action colors can be inverted, icon size can be changed (or hid).
• You can jump to a specified frame, you can search text in the action, and you can filter them by the entered text. The filter text are in logical AND connection by default, you may enter OR between them to specify a logical OR connection. Hotkeys: CTRL+J jump, CTRL+S search, CTRL+F filter.
• You can fast switch between charts with CTRL+number. For example CTRL+1 for APM, CTRL+2 for Hotkeys etc.
• You can fast zoom in with CTRL+I and zoom out with CTRL+U.
• Right click on the chart opens the Replay operations menu.

Applied to all chart types:

• Every chart can be zoomed. If a chart is zoomed, you can simply drag it to scroll (or traditionally use the scrollbar).
• You can choose to display all players on 1 common chart, or to put each on a separate one.
• You can choose to display time info in seconds or in frames.
• You can choose to display charts using the players' in-game colors, or with the same color.
• You can enable/disable any of the players.
• The chart marker and the selected action is synchronized to each other.

Miscellaneous

Sc2gears as an application has several miscellaneous features:

• Multi-platform release
  There is one single download for all operating systems (Windows, Linux, Mac OS-X).
• Multi-language user interface
  If your language is missing, you are welcome to translate the main (English) language file to your language and submit the translation. You can find more details on the Translation page.
• Multiple Document Interface (MDI)
  Several replay analysis, replay search etc. can be open at a time, and each has its own internal window which can be sized, moved, iconified etc.
  Additional internal window key shortcuts:
  
  
  

  	Close active	Switch to next window	Context menu	Restore size	Switch between the navigation tree and internal windows
  Shortcut:	CTRL+F4	CTRL+TAB	CTRL+SPACE	CTRL+F5	F6

  (Note that CTRL+F4 is also used to navigate through tabs.)
• Multi-threading technology: you can run several replay searches, analyzers etc. parallel in different internal windows without one blocking you or another task.
• Several Look and Feels (Graphical Themes)
  Some look good but might be slow (Nimbus), some are fast but might be ugly (CDE/Motif). Metal is a middle way between speed and nice look. Choose what suits you best.
  Changing the Look and Feel works without restarting Sc2gears, but it is recommended to restart after changing theme to fully take effect.
• Supports full-screen mode (press F11 to enter/exit fullscreen mode)
• Automated self-updater
  You only have to download Sc2gears once, the automated self-updater will notify you of new versions, and updates itself with your confirmation. All your custom files and settings will be kept safe.
• Supports system tray, can be minimized to tray