-
Notifications
You must be signed in to change notification settings - Fork 36
Options
The available command line options for RocksmithToTab are given in the help text:
Usage: RocksmithToTab archive.psarc [-a bass,lead] [-s song1,song2]
-l, --list List songs contained in the archive. No conversions are
performed.
-s, --songs Comma-separated list of tracks to include. (default: all)
-a, --arr Comma-separated list of arrangements to include. (default:
all)
-t, --split Create a separate file for each arrangement.
-d, --diff (Default: 255) Difficulty level.
-o, --outdir (Default: .) Path to the directory where tabs should be created.
-f, --format (Default: gp5) File output format, currently either 'gp5',
'gpx' or 'gpif'.
--help Display this help screen.
You must specify a Rocksmith .psarc archive as an input file. The psarc contains any number of Rocksmith arrangements; the on-disc content is included in the \Path\To\Rocksmith2014\songs.psarc. The dlc subdirectory contains all the Rocksmith 2014 DLC that you bought in separate psarc files, and also the Rocksmith 1 on-disc and dlc songs, if you bought them.
Please note: The RocksmithToTab executable I provide for download was built for the Windows platform and can only convert psarcs for the Windows platform. Their filename typically ends in a _p, as opposed to _m for Mac versions. If you want to use the program on the Mac, you will have to try and build it yourself against a Mac version of the Rocksmith Toolkit.
The converted tabs in .gp5 or .gpx format are typically created in the current working directory, i.e. in the directory from which you started the RocksmithToTab.exe. If you use drag'n'drop in the explorer, then the working directory is where the psarc file is located. If you want to change the output directory, you can use the option -o \desired\output\path.
The default output format is gp5, which can be opened by Guitar Pro 5, Guitar Pro 6 and TuxGuitar. You can change the output format with the option -f gpx. This will produce tabs in the Guitar Pro 6 format, which in some rare cases works more reliably, but can only be opened by Guitar Pro 6 and special versions of TuxGuitar. You can also select -f gpif, which is very similar to gpx. A gpx file is essentially a file container, which includes at least one file, the score.gpif, which is an XML document that fully describes the tab. With the gpif output, you get this XML file directly. This output format is primarily useful for debugging purposes, but it can also be opened by Guitar Pro 6.
By default, RocksmithToTab will convert all songs inside the given psarc. If you want to limit the conversion to only a certain song or songs, you can specify them with -s song1,song2, where the -s parameter takes a comma-separated list of song identifiers to convert. You can get the identifiers with the list option, -l.
By default, RocksmithToTab will convert all arrangements for a given song. If you want to convert only certain arrangements, or change the order of the arrangements, use the -a lead,combo1,rhythm switch, which takes a comma-separated list of arrangements. Again, use the -l switch to find out which arrangements are available for which songs.
By default, all selected arrangements for a song are saved into a single tab file as multiple tracks. However, if you specify the -t option, the arrangements will be split into separate files, one for each arrangement. There is a rare problem with putting several arrangements into the same file, because due to Guitar Pro's structure, they all share the same measures and, therefore, time. Normally, this is not an issue, but there is at least one song (Red Fang - Number Thirteen) where at certain points the measure structure differs between the arrangements, and if the song is converted to a single file, this will lead to issues. If you encounter such cases, use the -t switch.
By default, RocksmithToTab will export the highest available difficulty level for each song. If you want to export a lower level, you can specify it with -d 5. 0 is the lowest available difficulty level, whereas the maximum depends on each song.
Not happy with the default settings? Create a .bat file to call RocksmithToTab with your own preferred defaults! See here.