mmexplore

The MME explorer interface command line client

Syntax:

mmexplore [-d metadata] [-m device] [-f filter [regex] ]
          [-M msid] [-o display file] [-q database]
          [-r resolve] [-s sort] [-w window]

Runs on:

ARM, PowerPC, SH, x86

Options:

-d metadata
The metadata to display. Valid values are none, all or name. If not specified, the default is name. If this option isn't specified, you can set the metadata to display from the command-line once mmexplore is running.
-f filter [regex]
How to apply the regular expression to use when filtering explored files. Valid values are:

The expression must be enclosed in double quotation marks. For example: # mmexplore -f "pass .mp3$". If this option is not specified, the default value is none.

-m device
The device to browse. If not specified, the default is /dev/mme/default.
-M msid
The mediastore ID (MSID) to explore. If this option isn't specified, you can set the MSID from the command-line once mmexplore is running.
-o display file
Set the display file for output. Valid values are stout, none or a valid filepath and filename. If this option is not specified, the default value is stout.
-q database
The MME database. If not specified, the default is /dev/qdb/mme.
-r resolve
Flag instructing mmexplore to resolve playlists. Valid values are all and none. If not specified, the default is none.
-s sort
Data or metadata to use to sort explored files. Valid values are:

If this option is not specified, the default value is none.

-w window
The size of the window (number of explored items) to display. If not specified, the default is 20.

Description:

The mmexplore is a command-line utility that allows you to explore mediastores using the MME's explore API. For more information about the MME's explorer API, see the chapter Unsynchronized Media in the MME Developer's Guide, and the relevant functions in the MME API Library Reference.


Note: The QNX Aviage multimedia suite includes the source for this utility.

Supported commands

The mmexplore CLI supports the following commands.

b
Go back one explored level in the display window.
d metadata
Set or change the metadata to display; see mme_explore_info_get() in the MME API Reference. Valid values are none, all or name.
e item
Set the offset at which to start displaying items in the display widow. The mmexplore displays the path, offset and number of child items found for the path. For example:
Entering item "/xplore/gracetest" (offset 1).
Item '/xplore/gracetest' has 663 child items.
Display range (x,y) or all (a) or none (n)?

Enter the range of items to display (for example, 1,20 for the first 20 items), a for all items, or n for no items.

g flag
Instruct mmexplore to resolve the contents of playlists. Set to 1 to resolve playlists, or to 0 to not resolve playlists. The default is 0.

You need to resolve playlists to see or play their contents.

m msid
Start exploring the mediastore specified by the path in msid, and create and set a tracksession for the items in the window; see mme_explore_start(), mme_newtrksession() and mme_settrksession().
n path
Enter the path to an item on a mediastore.
p offset
Play the track specified by offset in the display window. At present, mmexplore plays only individual tracks, as specified by this command.
q
Quit mmexplore.
r
Refresh the contents of the explorer display window.

Display codes

The table below describes the display codes mmexplore uses to identify items it lists in its window. It places these codes in the second column of its item lists.

Code Meaning
D Folder (Directory)
DP Directory Playlist (folder); the item is a folder that is actually a playlist. PFS devices provide these types of playlists.
F File
P Playlist (file)
PF Playlist entry converted to a Filename
PI Playlist Item (not converted to a filename)

Examples:

The sample below shows a short mmexplore session:

# mmexplore

MME Media Store eXplorer Example
h		Show this information.
m <n>		Select media store ID <n>.
e <n>		Explore item indexed as <n>.
n <path>	Explore item named <path>.
b		Go up to parent item.
p [<n>]		Play folder or file index <n>.
r		Redisplay current view.
d <type>	Set metaData type 'all', 'none' or 'name' (default).
g 0|1		Get flags; 1 means resolve playlists directly.
q		Quit.

Media Stores:
Rows: 2  Cols: 3
Names:	+msid+name+mountpath+
00000:	|1|HardDrive|/|
00001:	|2|RALLY2|/fs/hdumass10-dos-1|

# m 2

Exploring media store ID 2.
Item '2' has 3 child items.
1 F  <unknown>         /=RALLY2
2 D  <unknown>         /xplore
3 D  <unknown>         /mp3

# e 2

Entering item "/xplore" (offset 2).
Item '/xplore' has 2 child items.
1 D   <unknown>        /xplore/gracetest
2 F   <unknown>        /xplore/typescript

# e 1

Entering item "/xplore/gracetest" (offset 1).
Item '/xplore/gracetest' has 663 child items.
Display range (x,y) or all (a) or none (n)?
# 1,10

Displaying all items from start to item 10.

1 F  Bye Bye Bye            /xplore/gracetest/('N Sync) No Strings Attached [01] Bye Bye Bye.mp3
2 F  Voices Carry           /xplore/gracetest/('Til Tuesday) Voices Carry [05] Voices Carry.mp3
3 F  Back To Paradise       /xplore/gracetest/(.38 Special) Flashback The Best Of .38 Special [01] Back To ...
4 F  Hold On Loosely        /xplore/gracetest/(.38 Special) Flashback The Best Of .38 Special [02] Hold On ...
5 F  Back Where You Belong  /xplore/gracetest/(.38 Special) Tour De Force [02] Back Where You Belong.mp3
6 F  I'm Not In Love        /xplore/gracetest/(10cc) The Original Soundtrack [02] I'm Not In Love.mp3
7 F  Blackmail              /xplore/gracetest/(10cc) The Original Soundtrack [03] Blackmail.mp3
8 F  Brand New Day          /xplore/gracetest/(10cc) The Original Soundtrack [05] Brand New Day.mp3
9 F  Ambitionz Az A Ridah   /xplore/gracetest/(2Pac) All Eyez On Me (Book One) [01] Ambitionz Az A Ridah.mp3
10 F  Dancing Queen         /xplore/gracetest/(ABBA) Gold [01] Dancing Queen.mp3

# p 10

Playing folder "/xplore/gracetest" item 10.

# q

See also:

mmecli, mmplexplore