-C, --construct

Construct a media database from music files located under the music directory. EasyH10 enumerates all MP3/WMA/WAV files in the music directories, obtains the media information (e.g., title name, artist name, album name, genre name, track number, bitrate, sample rate, etc.) from the found files, and generates a set of database files in the database directory.

-n, --new

Discard an existing database and rebuild a new one from scratch.

-i, --incremental

Enable incremental update mode. EasyH10 obtains the media information from files that have been updated or added since the last database construction. This mode stores the timestamp of each music file into the database to detect an update.

-c, --clean

Clean unused database entries in the existing database. Whenever playing a music track, the iRiver H10 player duplicate the database entry for the track. But the previous database entry will never be used in the future. This option removes such unused entries from the database.

-U, --update

Update a media database from music files located under the music directory. This option is actually an alias of options -Cis.

-o, --order=TYPE

Choose a playback and displaying order in the MUSIC mode. Selecting an order except for default inserts a space just before track titles. This space is a special character to control the playback order, but you may not notice it because the player uses a proportional font by default.

d, default

Leave the player to arrange music tracks in a default order determined by the firmware. EasyH10 will not make any attempt to change the playback order. The playback order will be the same as that created by iriver plus and Windows Media Player 10. If you have an H10 player running on UMS 2.04 firmware, the playback order will be a numerical order of track numbers.

t, tracktitle

Force an alphabetical order of track titles. This order is useful if you added the track number at the head of each track name (e.g., "01 song name").

f, filename

Force an alphabetical order of file names. This order is useful if you added the track number at the head of each file name (e.g., "01_songname.mp3").

n, tracknumber

Force a numerical order of track numbers. The track number must be associated with each music file. This order is the most recommended option if you want to listen to the music as if you listened to a CD. It arranges music tracks in a numerical order of track numbers even when entering all-tracks-by-an-artist navigation.

c, complete

Force a random order (shuffle) for any cases. The iRiver H10 player will turn into a shuffle-only player.

a, album

Force a random order when playing music tracks in an album and numerical order of track numbers when entering all-tracks-by-an-artist or all-tracks-with-a-genre navigation.

l, all

Force a random order when playing all titles and numerical order of track numbers when playing music tracks in an album.

-z, --source=METHOD

Specify a method for obtaining media information. This option was introduced for users who want to make use of directory layout rather than tag information. EasyH10 provides nine templates for specifying the source from which the music information is obtained.

m

Tag information in music files (DEFAULT). This is the recommended option if the tag is written into music files properly.

[g]p

Parse path names to obtain (genres and) artists. This template assumes directories in the music directory to represent artist names. Other fields (i.e., album name, genre name, track title, and track number) are extracted from the tag.

[g]pa

Parse path names to obtain (genres,) artists, albums. This template assumes directories in the music directory to represent artist names and directory names from artist directories to represent album names. A path letter '/' in the album directories are replaced with a space. Other fields are extracted from the tag.

[g]pa[n]t

Parse path names to obtain (genres,) artists, and albums; parse file names to obtain (numbers and) titles. This template assumes file names to represent track titles in addition to [g]pa template. Specifying n assumes two letters at the head of file names to represent track numbers. It skips space and '_' letters followed by the two digits to extract track titles.

-P, --playlist

Convert playlist files in the playlist directory. Setting this option converts M3U/M3U8/PLS files located in the playlist directory and writes respective PLA/PLP playlist files.

-M, --music

Convert playlist files in the music directories. Setting this option converts M3U/M3U8/PLS files located under the music directories (including sub-directories) and writes respective PLA/PLP files to the playlist directory.

-r, --reconvert

Overwrite the existing PLP/PLA playlist files to force conversion.

-g, --guess-missing

Guess path names of missing music files in a playlist. Setting this option tries to correct the location of music files referred by a playlist by trying a possible combinations of the path to the music folder and path to the music file referred by the playlist.

-f, --find-missing

Find path names of missing music files in a playlist. Setting this option tries to correct the location of a music file referred by a playlist by searching for the music file in the music directories that have the same file name. Finding two or more music files that have the target file name, EasyH10 selects a music file with a path name that is the most similar to the original one.

-k, --skip-missing

Skip missing music files in a playlist. Setting this option indicates EasyH10 to continue the playlist conversion only with music files found in the H10 player. The default behavior for a missing music file is to cancel the conversion for the playlist.

-t, --model=MODEL

Specify a model template. EasyH10 uses this file to identify an iRiver H10 model. By default, model template files are copied into ${PREFIX}/share/easyh10/model by the installer. You may specify one of these template files.

If no model template is specified, EasyH10 finds a default template (easyh10.model) in the following directory/order: the current directory; ${H10ROOT}/easyh10/model; ${H10ROOT}/model; and ${H10ROOT}. Therefore, you may copy a template file to these locations so that EasyH10 will read it automatically.

--gen-model=MODEL,FW_MIN_VERSION,FW_MAX_VERSION

Create a model template from an existing database. This option is only for EasyH10 developpers. Do not use this option.

-X, --install-model

Install the model template specified by -t option into the player. This will make a copy of the template file as ${H10ROOT}/easyh10.model.

-d, --dbpath=DATABASE

Specify the path to the database. This option overwrites the default value ${H10ROOT}/System/DATA.

-m, --musicpath=MUSIC

Specify the path to the music files. This option overwrites the default value ${H10ROOT}/Media/Music for UMS players or ${H10ROOT}/Music for MTP players.

-p, --playlistpath=PLAYLIST

Specify the path to the playlist files. This option overwrites the default value ${H10ROOT}/Media/Playlist for UMS players or ${H10ROOT}/Playlists for MTP players.

-e, --encoding=SE

Specify a character encoding used by the operating system (DEFAULT: UTF-8). EasyH10 converts path/file names from the specified encoding into UCS-2 using iconv.

-w, --tagencoding=TE

Specify a character encoding for parsing non-unicode tags. EasyH10 converts non-unicode tags embedded in ID3v1, ID3v2, and Riff WAVE into UCS- using iconv.

-D, --dump

Output a database dump in plain text format.

-V, --version

Show version number and exit.

-h, --help

Show this help message and exit.

-v, --verbose

Verbose mode.