Win32 Binaries

http://www.jestarjokin.net/sw/musicsort_bin_20110619.zip

Python Source

http://www.jestarjokin.net/sw/musicsort_src_20110619.zip

This script (and the binaries) is license under the MIT License.

An explanation follows.

My current tree structure looks something like this:

• Music
  • Albums
    • Genre1
    • Genre2
    • Genre3
  • Misc
    • Genre1
    • Genre2
    • Genre3

My naming conventions for the album directories is like this:
Artist – Year – Album [Aux] (Music Type & Bitrate)

e.g.

Slum Village – 2010 – Villa Manifesto (MP3 192)

The “Aux” label is optional, and can store information like whether the album comes from vinyl, or the label/pressing info, or the CD number in a multi-disc set.

While most tagging software can handle the tag-based information okay, it doesn’t satisfy my requirements for the Music Type & Bitrate. My logic is like this:
Music Type will roughly be the file extension, “MP3″ or “OGG” or “MP4″ or *shudder* “WMA”. (MP4 gets a little complicated, because there are a few different file formats/extensions, for what is basically the same compression technology, e.g. AAC/MP4/M4A)

Bitrate goes like this:

• If all files have the same bitrate, assume it’s a single constant bitrate (CBR).
  • e.g. (MP3 192)
• If there is a mixture of different bitrates, and they’re all divisble by 8000, assume it’s a mixture of CBR. Bitrate value should note that it’s mixed and provide the minimum and maxmium bitrates.
  • e.g. (MP3 mixed, 128-320)
• If all files have a mixture of different bitrates, and no bitraters are perfectly divisible by 8000, assume a variable bitrate (VBR). Also output the average bitrate across all files.

The script has been programmed so that if any value is missing (i.e. artist, year, or album), it will prompt the user to enter a new value for the missing value.

If there are multiple encountered values for any value (such as year), it will ask the user to choose one of the found values, or to enter their own value. The exception is the “artist” field – multiple values will instead default to a value of “VA” (for Various Artists).

Once the script has generated an output folder name, the user is prompted to confirm if it’s okay, or to enter “override” values for any of the information fields.

Because “auxilliary” information is not necessarily available from the tags, this info can be specified at runtime, seperately from other “override” values.

If the user enters any override values, the script will again prompt the user to confirm the output folder name. This will loop as long as the user keeps entering override values or auxilliary information. If the user does not enter “Y” or “Yes” in the confirmation prompt, the script will not attempt to move the folder/music files.

The script can be run across a single input folder, or across all sub-folders in the input folder. If the latter, you can skip processing folders by declining the prompt to confirm the output folder name.

If looking in a folder with no files and only one sub-folder, the script will automatically try to process that sub-folder.

Once the user confirms the output folder name, the script will prompt the user to choose a destination directory. The list of destinations is determined by all sub-folders in a previously defined destination root directory (specified in an external configuration file). For my purposes, I have a root “Album” directory, with a list of sub-folders named by genre. I also ignore any directories beginning with an underscore character, e.g. “_to_sort”. This lets me have an “incoming” directory of albums that require sorting.

The destination directory, and any other information that should not change at runtime, is specified in a seperate configuration file.

This was my first attempt at working with Unicode strings properly. I’m using a Windows (NTFS) system, which stores filenames as Unicode, and the album data could contain Unicode strings. The script will convert any input from the command line, such as initial arguments or any override values, to Unicode, based on the current system encoding.

Future work:

• Support analysis of files without any tags, trying to guess values based on the filename.
• Support for lossless compression (should be pretty simple really, just need to add the right calls to Mutagen).
• Make all MP4 files use the same music type (rather than AAC/MP4/M4A).
• Correct “bitrate” naming of albums that use a mixture of VBR and CBR.
• Support for cancelling the script – currently the only way to cancel is to press CTRL-C, which quits the whole thing.

The mailing list address:

support@lists.jestarjokin.net

You can set up subscriptions and other info here:

http://lists.jestarjokin.net/listinfo.cgi/support-jestarjokin.net

The archives will be located here:

http://lists.jestarjokin.net/private.cgi/support-jestarjokin.net

Win32 Binaries
http://www.jestarjokin.net/sw/scummpacker_bin_20110521.zip

Python Source
http://www.jestarjokin.net/sw/scummpacker_src_20110521.zip

• Fix issue where importing sounds into a MONSTER speech map did not sort the sounds by ID (original offset), resulting in invalid game resources when exporting.

Win32 Binaries
http://www.jestarjokin.net/sw/scummspeaks_bin_20110512.zip

Python Source
http://www.jestarjokin.net/sw/scummspeaks_src_20110512.zip

• Complete rewrite. Breaks all compatability with old versions.
• Supports SCUMM v4, v5, and v6 games, as well some v3 games.
• Outputs some information (such as headers) to XML format.
• No longer need to explicitly state the order of each block.
• All object data are contained within their own sub-folder.
• Local scripts are contained within their own sub-folder.
• License changed from “public domain” to the MIT/X11 license.

Win32 Binaries
http://www.jestarjokin.net/sw/scummpacker_bin_20110425.zip
Python Source
http://www.jestarjokin.net/sw/scummpacker_src_20110425.zip

SCUMM Image Encoder v2 r1

• Updated to work with ScummPacker v3
• New option to “freeze” the palette, preventing the original palette from being updated.
• New option to specify the quantization (number of colours in the palette)
• License changed from “public domain” to the MIT/X11 license.

Win32 Binaries

http://www.jestarjokin.net/sw/scummimg_bin_20110425.zip

Python Source

http://www.jestarjokin.net/sw/scummimg_src_20110425.zip

And that’s it!

I’m afraid I have no intention on performing any further work on my SCUMM tools. I will still perform maintenance work, and will consider feature requests, but I will be focusing on other projects.

• Big overhaul! Redesigned how ScummSpeaks works; it now stores mappings of sounds to lines of speech, saved in an XML file, and both the text and sounds must be exported to game resources as a final step. (You will need to manually use ScummTr to insert the text back into the game directory.)
• You now need to import an existing text file and sound resource, in order to create and work on a Speech Map.
• Adds support for BUN resources, as used by The Dig.
• Support for metadata such as lip-synching tags.
• Includes a small utility, “trspack”, to decode and encode the *.TRS file used in The Dig, which stores subtitles for cutscenes.
• Import/Export Sounds now uses XML files for each sound, to provide information on which line number the sound should be played on.
• Removed all support for original game sound resources that use VOC files; ScummSpeaks now only works on sound resources that have been compressed with the ScummVM tools (compress_scumm_sou and compress_scumm_bun).
• Better dialog for “scummtr”, effectively giving it a nice frontend.
• Binary distribution includes the “scummtr” executable.
• More alert messages when things have finished processing, or errors have occurred.
• Text comments and sound comments are stored in the Speech Map XML file.
• In the sound list display, if no custom comment for a sound has been entered, it will display the associated line of dialogue from the text file.
• You can now sort by some columns.
• New manual.

Win32 Binaries
http://www.jestarjokin.net/sw/scummspeaks_bin_20101021.zip

Source
http://www.jestarjokin.net/sw/scummspeaks_src_20101021.zip

Manual
http://www.jestarjokin.net/sw/scummspeaks_manual.html

Scummbler v2 r13

• Much more accurate error reporting.
• Pyparsing library now included in the source (I’ve had to modify it in order to support better error reporting).
• Fix example script in the manual (escape codes were “\x033″ instead of “\x03″).

Source/Python Script

http://www.jestarjokin.net/sw/scummbler_src_20100820.zip

Win32 Binaries

http://www.jestarjokin.net/sw/scummbler_bin_20100820.zip

—

Scummpacker v2 r2

• Added support for General Midi sound blocks (“GMD”), as possibly found in the Sam and Max WIP demo. Added by request, so you can insert new music into games.

Source/Python Script

http://www.jestarjokin.net/sw/scummpacker_src_20100810.zip

Win32 Binaries

http://www.jestarjokin.net/sw/scummpacker_bin_20100810.zip

—

I’ve also made some minor changes to the web page (previous versions history is now hidden by default, use points rather than pixels for fonts, enlarge font sizes).

• Fix drawBox modifying main opcode instead of auxilliary opcode.
• Fix drawObject using wrong sub-opcode.
• Fix saveVerbs/restoreVerbs outputting the wrong opcode.
• Fix SetPalColor outputting a word instead of a byte for last parameter.
• Fix the auxilliary opcode values for SetPalColor, drawBox, setRGBRoomIntensity.
• Supports new descumm formatting, also with support for legacy descumm. Some workarounds in place since descumm’s output is still a bit buggy.

Binary:
http://www.jestarjokin.net/sw/scummb…n_20100803.zip
Source:
http://www.jestarjokin.net/sw/scummb…c_20100803.zip

I’m going to try and update more often and not just use this blog for software updates. That reminds me, I think Scummbler is broken for SCUMM V4 scripts – I really need to upload a fixed version some time.

Source/Python Script

http://www.jestarjokin.net/sw/scummbler_src_20091007.zip

Win32 Binaries

http://www.jestarjokin.net/sw/scummbler_bin_20091007.zip