OrlSoft MPeg eXtension
Version 2.10

OrlSoft MPeg eXtension is the special software project for everyone working with audio compression. It helps you process lots of files useful and quickly, copy your audio CDs to a compressed format, decode and re-encode files, change and update files' information tags and more. At this moment OSMPX has the complete implementation of three audio compression formats: MPEG 1.0 Audio Layer III (MP3), Ogg Vorbis and MPEGplus.

OSMPX consists of two interfaces: the batch processor (use it from system command line like any other console application) and the GUI module for working with files, encoding, decoding, different files and its information tags processing and more necessary and useful features. If you have a lot of compressed files, this one is for you! This powerful program will help you in many ways, so you'll stop using other programs like this. I hope :))

GUI: graphic user interface

GUI module looks like a Windows Explorer but with some additional specials and features. You could see only drives, folders, MP3, M3U, WAV, OGG, MPC, MP+ and LQT files, all other files OSMPX hides from you. Each file has a displayed name and size, compressed files shows some more information - bitrate, playing time and some tags data: artist, track title, mix/version, album title and year. For your comfort we colorize different bitrates and years with red, blue, green, gray and black colors.

OrlSoft MPeg eXtension

From the main program menu and from context menus you may run almost all command line features with some additions: playing/enqueeing files (works well with WinAMP and Sonique audio players), playing/enqueeing folder contents, rename or delete any file or folder, customized advanced encoding/rename/update, massive and advanced tags update, audio CDs copy & compress... Moreover, OSMPX remembers a number of user options, last used encode mode, last browsed folder, 10 folders history, it can add an icon to system tray, load with Windows, add some shell extensions and more.

View and edit information tags

You can view and edit MP3 and MPEGplus properties and ID3v1/ID3v2 tags by choosing "Properties" option of "Compressed audio" menu or from a context menu at a compressed file. Any tags values can be reviewed, changed and then saved by click on OK button. For your comfort we provide an exchange mechanism between ID3v1 and ID3v2 tags. Note: this refers to MP3 and MPEGplus files only.

╠╨3/MPC/MP+ files properties

Ogg Vorbis file properties has a little bit different appearance. Moreover, you may only review properties and tags data, you can't edit and save new info, this feature haven't been implemented yet.

Ogg Vorbis file properties

Massive and advanced tags update

Massive tags update is an excellent tool for updating some tags in a large number of files. This batch mode lets you tape common values for one or more tags. After you press the OK button, OSMPX will update all corresponding tags for all selected files in the main form. Clean fields means "no change" for corresponding tags, such tags in files will remain unchanged.

Massive tags update

Advanced tags update is more powerful version of batch update. In addition to processing common values for some tags, you may change any tag of any selected file. You may also change tags case for current or all columns to "First letter of the first word" or "First Letter Of Each Word".

Advanced tags update

Try this! But don't forget that this operation can't be undone! After you press the OK button, OSMPX will update all selected files with new tags values.

Advanced rename

Advanced rename is the complete GUI implementation of the powerful command line "rename files by tags data" feature.

Advanced rename

User may choose from one of the following 5 preset file naming formats or set your own rename template as a combination of codes listed below. Default user template could be set up in program options dialog.

1:   Artist - TrackTitle.MP3
2:   Artist - TrackTitle (Mix).MP3
3:   TrackTitle (Mix).MP3
4:   Artist\TrackTitle (Mix).MP3
5:   Artist_-_TrackTitle_(Mix).MP3 (special formatting for Internet - no special symbols, no spaces)
6:   Use custom user template (firmware setting is "%N. %A - %T [%M]").

%N - track number like 01..99
%A - artist name
%T - track title
%M - mix/version/comments
%L - album title
%Y - publishing year
%W - post-formatting like mode 5

All these codes may be taped in any order and could be expanded with any allowed filename symbols. All empty pairs of round "()", square "[]" and brace "{}" brackets, duplicated spaces will be removed.

It is possible to enable search in subfolders and playlists update while renaming files. If you enable automatic playlists update, only those files will be renamed which are included in at least one playlist in the current folder. All playlists will be correctly updated with new filenames, even if some files are included in more than one playlist.

Advanced encoding

Encoding in OSMPX could be done in different ways. The easiest way is to select some files in the main form, then choose desired encoder and encoding mode in context menu. This mode is the most quick and the easiest but when you use this mode, all result files won't have any information tags.

The most complex tool for encoding some files at once with tags creation is "Advanced encoding" mode. With this tool you may quickly and handy choose the encoder and the desired encoding mode, encode lots of files at once and immediately create all the needed information tags. Just select some files in the main OSMPX form and choose "Advanced encoding..." in the context menu, and you'll see the form like this:

Advanced encoding

Select encoder and encoding mode, enter common information for all files, track titles for each file and the differences from common values.

This tool has heavy features for files processing. You may turn on the pre-processing: trim silence at the beginning and at the end of files; normalize volume level, including channel-separated normalization (useful for different volume level of channels). In addition to this you may choose options to delete all source wave files and power off computer after the encoding process finished.

After all changes were made, all that you need is to click on "Encode" button and stand by while OSMPX is processing your files.

Audio CDs copy & compress

OSMPX has a special extra powerful batch mode intended for copying audio compact discs and conversion them to compressed audio formats. In "Tools" menu choose "Compress Audio CD" or just press F11 key.

Audio CDs copy & compress

First of all you need to enter the information about your CD. This could be made in two ways. If you have connected to Internet, insert CD into your first CD drive (if you have more than one device of this type), press "Read CD Info" button. Then after some time, CD info will be filled up from Internet CD database.

Attention! CD info are reading from CDDB.COM. If you have an active Internet connection but get the "timeout" error, please contact your network administrator, because your server may have a firewall-like program preventing from unauthorised access. OSMPX needs an access to cddb.cddb.com address via port 8880 for reading CD database.

Another frequently recieved error "no exact match" means that your CD was not found in database. In this situation you may use the second way to enter CD information - manual input. Press "Simulate CD" button and enter CD tracks count in the dialog.

Then you have to input CD info such as artist name, album title, publishing year and genre into the proper fields. Enter all tracks titles by pressing Enter or making mouse doubleclick on the proper track in the list. All information will be written to result compressed files' information tags later.

OSMPX has the special ability to process compilations encoding. Set up "Compilation" checkbox and input tracks titles by the "Artist / TrackTitle / Mix" template. All unnecessary quotes will be ignored i.e. names like "Artist" / "TrackTitle" / "Mix" are correct.

All entered information could be saved to a special-format MXC file for any future purposes (for example, if you will encode this CD later or for using CD information in OrlSoft Music DataBase application) - press the "Save" button. For loading information from MXC file press the "Load" button.

CD compression is the two-step process. First step is to copy tracks from CD to your hard drive. This operation can be done with Audio grabber tool (CD DAE 99 grabber is included in OSMPX), press the "Audio grabber" button. The temporary folder for copied files could be entered into field "Source WAVe files placed here" or selected in "Browse for folder" window after pressing the "..." button.

Audio grabber copies audio tracks from CD to audio files in WAVe (PCM) format. The tool look like this:

To start simply select the tracks and press the start button. CD DAE verifies the quality by extracting the tracks twice and comparing the audio data. During the extraction process the waveform is displayed. The first time the track is extracted this waveform is displayed in grey. When the track is extracted again to detect the errors, the color of the waveform shows the number of errors.

If all are green - the quality of the wave file is perfect, there's no need to listen to the wave file. The yellow parts shows that the wave file contains errors. However, if there are not many errors then the wave file sounds ok. Wave files with low number of errors sounds fine in most cases but it's always a good idea to verify the quality by listening to the bad sections. Note that CD DAE always shows the worst case. So even if there is only one error this will be shown in the graph. If you see red parts this tells you that this track is demaged, so it is very bad, full of pops, clicks and static noise. You can still see grey lines from the first time the track was extracted which means that the drive returned different data the second time.

Error Correction. If errors are detected you should slow down the drive (in the main screen) and extract the tracks again. If the tracks still contain errors you have to rely on the error correction of the drive. When the drive detects errors, the bad samples are not returned. Instead the average of the previous and the next error-free sample is returned. If there are too many consecutive errors, the drive returns digital silence. Note that not all drives use error correction with audio tracks. In this case the drive returns garbage and the faulty samples will be heard as load static noise.

Second step is, in fact, the encoding process, does in main window of "Audio CDs copy & compress" mode.

Before you start, please input these parameters: the path to a folder, where OSMPX would place result files, encoding mode (encoder and one of encoding mode presets plus 3 user presets for LAME encoder).

OSMPX lets you make some pre-processing before encoding: trim digital silence ("garbage" pauses) and normalize volume level. For activation of these and some more options please set the corresponding checkboxes.

After doing all the descibed above operations simply press the "Start compress" button..

To prevent result files from duplicated names and for your comfort OSMPX does renaming of all result files by "Artist - TrackTitle (Mix).╠╨3" tempalte. Playlists will have names like "[Year] Artist - AlbumTitle.m3u".

Options

I hope OSMPX has all rights to be named "true" multimedia application. Beeing a true GUI application OSMPX has the customized user options subsystem. Most of user parameters (windows size and position, fields and checkboxes values) are always saved and restored by the software. Moreover, OSMPX has some special options which are common for all the application. In the main form choose "Options..." from the "Tools" menu or simply press F12 key.

Options dialog consists of four tabs. At the first tab the most common parameters are placed .

1 - load system tray agent together with Windows (speeds up your work and gives quick access to some features);
2 - when user double clicks on file, open file properties instead of playing the file;
3 - always delete source wave files after encoding process finished (this effects advanced encoding and audio CDs copy & compress too);
4 - enable native ID3v2 support for MPEGplus files (incompatible with old versions of MPEGplus decoder and plugins);
5 - show encoder, decoder and trim windows while processing (disabling this option is useful for lots of background processing in order to stop popping up windows disturbing you)
6 - set this process priority while endcoding, decoding and processing files (this doesn't effect GUI operations);
7 - custom user files renaming template for automatic and advanced files rename.

On the second tab there are some options for integrating OSMPX into Windows shell - adding some new options to Explorer context menus fro files and folders.

The third tab intended to LAME encoding - here you may set three custom LAME encoding presets. If you are professional in LAME encoding or you just miss some LAME modes, feel free to use this options. Your presets then be available in every encoding form.

The fourth tab gives you the control of trim and normalization processes while encoding and decoding files.

Digital silence trim is the recommended option, because it saves your tracks from having "garbage" - wasted silence(pause) at the beginning and at the end of track.

Normalization is the next useful option. Turn it on when encoding compilations to prevent files from having different volume levels. Normalization process will change volume levels to "Normalize audio level to" field value, but it effects only those files which corresponds to greater and smaller threshold levels. Channel-separated normalization intended for tracks with different volume levels of left and right channels. But if difference found will be less than 0.5db this option won't have any effect.

If you don't want to use normalization, the "reduce level by 0.5 db" option is for you! Use it on most tracks because it will prevent encoded files from strange clicks and digital distortion. Use it all the way!

Hot keys

OSMPX provides a wide range of hot keys for quick access to its features. In the main form you may use these keys:

F1 - this manuals;
Ctrl-F1 - some words about the program;
Alt-F1 - change drive (as in file managers like Far and NC);
F3 - browse for another folder;
F5 - refresh folder contents;
F6 - rename file or folder under cursor;
F8 - delete all selected files and folders including all subfolders;
F11 - audio CDs copy & compress;
F12 - options;
Ctrl-W - close the program and tray agent;
Ctrl-E - run advanced encoding for all selected files;
Ctrl-D - decode all selected files;
Ctrl-G - make playlist for all files in the current folder;
Ctrl-P - play all files in the current folder;
Ctrl-L - enquee all files in the curent folder to player (works well with WinAmp and Sonique);
Ctrl-R - advanced files rename;
Ctrl-U - massive tags update;
Ctrl-I - advanced tags update;
Ctrl-Enter / Alt-3 - file properties (as in Winamp);
Alt-Enter / X - play all selected files;
Shift-Enter - enquee all selected files to player (works well with WinAmp and Sonique);
Ctrl -, Ctrl +, * - select files (+/- to select/deselect one-type files, * to inverse selection);

Audio CDs copy & compress

Alt-F1 - browse for source wave files folder;
Alt-F2 - browse for target compressed files folder;
Ctrl-R - read CD info from CDDB.COM;
Ctrl-S - save CD info to MXC file;
Ctrl-L - read CD info from MXC file;
Ctrl-Enter - start compression process;

In most of all forms Ctrl-Enter equals to a click on begin buttons ("OK", "Encode", "Start compess", etc).

Command line interface

The software has a wide range of useful functions, which could be run directly from a system command line. It's nice to those people who used to work with shell applications like Far Manager, Windows Commmander, Norton commander, etc.

All parameters are listed and described in the table below. The first line of each block defines function syntax (all symbols and parameters, enclosed in square brackets are optional). Next part of each block is a described function and its parameters definition. And the last line(s) are some examples.

View and Edit compressed file information
OSMPX <FileName>
After execution you'll see a form where you'll be able to view and edit all of the information tags included within the file given. Sorry, you can't edit Ogg Vorbis files, this feature isn't implemented yet.
OSMPX "C:\Music\Dance\DJ BOBO - Together.MP3"
OSMPX "C:\Music\Clayderman.ogg"
Create/Change ID3 tags directly from command line
OSMPX /ch[ange] <Wildcard> [/a "Artist"] [/t "Track Tile"] [/l "Album Title"] [/y Year] [/m "Mix/Version Information"] [/tn TrackNumber] [/genre "Genre"]
Use this for creating and updating some ID3 tags. A single file or a group of files can be processed at one time. The main parameter /ch (or /change) must be taped first. Of cause, file name or a wildcard must be included too. All other parameters are optional, and their order does not signify. For this feature and for most of all others ID3v1 and ID3v2 tags are equivalent.
OSMPX /ch *.MP3 /a "Boney M 2000" /l "Boney M 2000" /y 1999
OSMPX /ch Track01.MP3 /a "Boney M 2000" /t "Sunny" /l "Boney M 2000" /y 1999 /m "Club Mix"
Rename all compressed files
OSMPX /r[ename] [<Wildcard>] /fn [/s] [/template "CustomRenameTemplate"]
This will rename compressed files in the current folder by a name template:
/f1       Artist - TrackTitle.MP3
/f2       Artist - TrackTitle (Mix).MP3
/f3       TrackTitle (Mix).MP3
/f4       Artist\TrackTitle (Mix).MP3
/f5       Artist_-_TrackTitle_(Mix).MP3 (special formatting for Internet - no special symbols, no spaces)
/f6       Use custom user template (firmware setting is "%N. %A - %T [%M]").

%N - track number like 01..99
%A - artist name
%T - track title
%M - mix/version/comments
%L - album title
%Y - publishing year
%W - post-formatting like /f5 mode

All codes may be taped in any order and may be expanded with any allowed filename symbols. All empty pairs of round "()", square "[]" and brace "{}" brackets, duplicated spaces will be removed.

Default user template could be set up in program options dialog. You may override it by optional parameter /template. Rename process will affect all compressed files by default, but you may set up any filter you need by a Wildcard. Include optional parameter /s to search in subfolders too.

Attention! This function will affect ONLY compressed files, all your playlists will remain unchanged.

OSMPX /r /f2 /s
Automatic Rename of playlists and compressed files
OSMPX /a[uto]r[ename] [<Wildcard>] /fn [/s] [/template "CustomRenameTemplate"]
This will read playlists in the currect folder, rename all compressed files they includes by a name template and update playlists with new songs filenames. If some song is included in more than one playlist, OSMPX will do correct name translation - all such playlists will be updated. All other syntax parameters works like in the previous operation.
OSMPX /ar /f2 /s
Copy playlist to a specified folder
OSMPX /±opy <PlaylistFile> [/to <DestinationFolder>]
If you need to copy playlist with songs from different folders to one folded (for example to burn a CD-ROM) you may need this feature. You tape a playlist name and a destination folder. Then OSMPX will create a subfolder called like a playlist name and copy all songs from your playlist to that folder. Result song file names will remain unchanged but with a prefix: (nnn), where nnn is a song number in playlist.
OSMPX /copy "C:\Music\Dance\DJ BOBO - Level 6.M3U" /to "T:\Sorted"
Encoding
OSMPX /e[ncode] bitrate|mode [<Wildcard>] [/trim | /notrim] [/fgh | /lame | /ogg] [/reducelevel | /rdl]
This function will encode all files by wildcard with the same options at once. You'll set up encoding parameters to use for all files given by wildcard. Files wildcard is an optional parameter, by default it is *.WAV.

Encoding mode is setting up by a bitrate|mode parameter. For MP3 encoding it can be one of: 128, 160, 192, 224, 256, 320, VBR, ABR nnn, s1|s2|s3. The default mode is 320 kbps using LAME encoder. If you select 128 kbps mode you may select which encoder to use: L3ENC or LAME, by default OSMPX uses LAME. This option can be overrided by /fgh and /lame options. Taping "VBR" will tell OSMPX to use VBR mode of LAME encoder. ABR mode is a brand new LAME's desired average bitrate mode, the best encoding mode for MP3. Parameter nnn is the desired average bitrate from 110 to 310 kbps. Modes s1|s2|s3 correspond to custom user presets you set up in Options.

For Ogg Vorbis encoding you have two ways: chosing encoding mode (1 - 112 kbps, 2 - 128 kbps, 3 - 160 kbps, 4 - 192 kbps, 5 - 256 kbps, 6 - 350 kbps) or encoding bitrate (112, 128, 160, 192, 256, 350) together with special parameter /ogg. All Ogg Vorbis modes are 100% VBR, i.e. the average bitrate won't be equal the specified value.

For encoding to MPEGplus format just tape mode as one of MPEGplus firmware presets: thumb, radio, standard, xtreme, insane or one of these codes: mpp1, mpp2, mpp3, mpp4, mpp5.

Use optional parameter /trim | /notrim to trim or not silence at the beginning and at the end of WAVe files. This will turn ON normalization if it was checked before in Options.

Optional parameter /reducelevel will turn on "Reduce input level by 0.5db" mode for strong clipping audio files prevent them from added distortion while future decodings.

OSMPX /encode abr 256 /trim
OSMPX /encode 160 track??.wav /notrim /ogg
OSMPX /encode 320 "C:\Music\Mastering\DJ BOBO - Mystasia.wav" /trim
Decoding
OSMPX /d[ecode] [<Wildcard>] [/sync] [/fgh | /lame]
This function will decode all files by a given wildcard at once. You won't need to decode each file separately. Wildcard is optional, by default it is *.*. This means all compressed files in the current folder.

For MP3 we use and we recommend to use LAME for decoding files. This is the default option, but you may select decoder by yourself: /lame and /fgh options will help you. Optional parameter /sync is destined for L3DEC decoding. It tells L3DEC to resynchronize after synchronization loss, otherwise it won't. For Ogg Vorbis and MPEGplus files OSMPX uses their own decoders.

OSMPX /decode
OSMPX /decode track??.wav
Make Playlist
OSMPX /makelist [<PlaylistFileName>] [/s] [/paths]
Scan current folder (and all subfolders if you'll tape /s parameter) for all MP3 and OGG files, sort them by name, and then create a new #EXTM3U playlist. PlaylistFileName is optional, by default it is !Playlist.m3u. Include /paths if you want to include full path to song file names in the result playlist.
OSMPX /makelist /s /paths
OSMPX /makelist C:\Music\MyMusic.m3u
WAVe files digital silence processing and normalization (WaveTrim)
OSMPX /w[ave]t[rim] [<Wildcard>] [/fn] [/before NNN] [/after NNN] [/nf] [/nb] [/z | /zx | /zxx] [/raw]
[/norm[alize]] [/norm_level NNN] [/norm_above NNN] [/norm_below NNN] [/norm_sep]
This feature helps you to trim silence at the beginning and at the end of WAVe files. This processing is strongly recommended before encoding. Moreover, OSMPX will help you while preparing audio data for CDDA media burning. Red Book standard claims that each track must have some frames (a frame is 1/75 sec) of digital silence at the beginning and at the end of it. This required preventing audio from having strange cracks and clicks at pauses.

Wildcard is optional, by default it is *.WAV.

/fn parameter is a mode selector:

/f0       trim file, i.e. remove silence before and after audio data (used by default)
/f1       format as standard audio cd track (2 frames before audio, 5 - after)
/f2       format as 1st track of cd (30 frames before, 5 - after)
/f3       format as last cd track (2 frames before, 60 - after)
/f4       format audio as 1st track of nonstop cd (30 frames before, 0 - after)
/f5       format audio as last track of nonstop cd (0 frames before, 60 - after)

/before NNN and /after NNN can be combined with /f0 if you need to select a different template. NNN is a needed frames count (1/75 sec).

/nf - NO FORMAT mode - i.e. don't do anything, just scan for silence.
/nb - NO BACKUP - don't leave BACKUP files (delete them).
/z - ZERO mode - "silence" means only digital zero samples (used by default).
/zx - ZERO EXTENDED mode - interpret 0000$-0007$ and FFF8$-FFFF$ as a digital silence (very useful mode for encoding, trims all background noise at cd pauses).
/zxx - SUPER ZERO mode - interpret 0000$-00FF$ and FF00$-FFFF$ samples as a digital silence (useful for nonstop compilations).
/raw - RAW AUDIO mode - treat input file as a RAW PCM 16 bit 44100 Hz file, then process silence trim and create standard RIFF(WAVE) header.


Since version 2.01 OSMPX has a brandnew powerful feature: optional volume level normalization, turns ON with /normalize. Parameter /norm_level NNN sets up the desired volume level in percents for all files, the default value is 95 (equals to -0.5db). Parameters /norm_above NNN and /norm_below NNN are the threshold levels: normalize only if peak level is above or below NNN (defaults are 98 and 85). All NNN values are percents (% symbol doesn't needed). Use /norm_sep option to turn on the channel separated normalization (useful for files with different peak levels in left and right channels). If peak levels difference is less than 0.5db, this parameter will be omitted.
OSMPX /wt Track??.WAV /f0 /zx /nb
process all Track??.WAV files, prepare them for encoding - trim silence including samples 0000$-0007$ and FFF8$-FFFF$
OSMPX /wavetrim Track??.WAV /f1 /z /nb
process all Track??.WAV files, prepare them for CDDA burning according to Red Book standard.
Virtual scissors: split file
OSMPX /split <FilePathName> /offset nnn
This function splits input file and creates two new files by the given offset value. OSMPX splits file without making any format checking, i.e. virtual split is a byte-by-byte process. All input file data from the beginning to nnn-1 position will be written to the new file with s_ prefix, all other data will be in file with prefix e_. Offset value can be taped in hex - just add 0x prefix to it.
OSMPX /split Sample01.MP3 /offset 0x5EA0
OSMPX /split C:\Music\Sample03.MP3 /offset 1259
Virtual knife: crop file
OSMPX /crop <FilePathName> [/start nnn] [/end nnn]
When you need to crop a file, i.e. if you want to delete all file data from the beginning to some file position and from some another (later) position to the end of a file, you use virtual crop. Just set start and end offsets and all work will be done by OSMPX in only some seconds... Offset values can be taped in hex - just add 0x prefix to it. By default /start offset is 0, /end offset is equal to file size. When working with MP3 and MPEGplus files OSMPX will preserve ID3 tags data from being lost.
OSMPX /crop Sample01.MP3 /start 1024
OSMPX /crop Test\Sample3.MP3 /start 1024 /end 0x563ED0
OSMPX /crop D:\Audio\Test\Sample6.MP3 /end 0x563ED0
MXC files generation
OSMPX /makemxc <PlaylistFilePathName> [/to <DestinationFolder>] [/compilation]
This function was implemented especially for OrlSoft Music DataBase users (it's used in the Add New Album Wizard). MXC files came from OSMPX's Audio CD Compression feature and are 100% compatible with it. However, you may use these files for any other purpose. Use /compilation mode for compilation playlist info file generatings.
OSMPX /makemxc "C:\Music\Dance\DJ BOBO - Level 6.m3u" /to "T:\Sorted"

This readme file isn't complete program documentation, I have no time to write it :(. Russian version is a little bit more concrete but it isn't complete too. If someone wants help me, please don't hesitate to contact: orlsoft@hotmail.com.

Go to OrlSoft Project's website and check download section for the latest program update.

Have a nice encoding!

Thank you for trying OrlSoft MPeg eXtension
Andrew P. Aspidov

Copyright © 1999-2001 Andrew P. Aspidov.