                                 EasyH10
                               Version 1.4
                       http://easyh10.sourceforge.net/
                      Copyright (c) 2005-2006 by Nyaochi



==========================================================================
1. Introduction
==========================================================================
EasyH10 is an open source project to develop management software for
iriver H10 digital audio player. It prepares an H10 player without iriver
plus or Windows Media Player 10 based on music and playlist files
transferred manually (e.g., drag-and-drop operation, copy command, rsync
utility, etc). EasyH10 is compatible with iriver H10 5GB, 6GB, and 20GB
models shipped worldwide. EasyH10 works on various platforms such as
Windows 98SE/ME/2000/XP, Linux, MacOS X, and other POSIX-like operating
systems.

EasyH10 is for those users who come to know a bit about digital audio
player and have grown out of a newbie. In contrast with iriver plus and
Windows Media Player 10, EasyH10 does not incorporate unnecessary and
cumbersome features for full-grown users: converting a music CD into music
files; editing media information of music files; transferring music files
from a local HDD to your iriver H10 player; and creating playlists on-
the-fly.

Whether a user finds integrated software useful or annoying depends on the
level of the user. Some users (including me) may prefer another excellent
software for performing the tasks described above. Therefore, EasyH10
assumes a user to be able to: prepare music files with tag information;
transfer music files into iriver H10 player by themselves; and create
playlist files by using an existing software.

Then EasyH10 just does two remaining tasks for your H10 player to be ready
to use:
- Media database construction, which is a necessary process for an H10
  player to display songs in MUSIC mode.
- Playlist conversion, which is also a necessary process for your playlist
  files to become compatible (recognizable) with an H10 player.
In addition to these tasks, EasyH10 imports/exports tuner presets from/to
a text file.

EasyH10 has following features:
- Enumerate media files (MP3/WMA/WAV) located under "\Media\Music" folder
  (for UMS players) or "\Music" folder (for MTP players) and construct an
  H10 media database.
- Update a media database quickly for only added or updated music files.
- Force music files to be ordered according to the track number. You can
  get ordered playback even when you select "All" at "Album" and "Artist".
  selection screen.
- Force music files to be arranged in random order to provide a solution
  to H10's awkward shuffle play (this bug was solved with 2.10 firmware).
- Support Regular Expression Playlist (REP).
- Convert M3U/M3U8/PLS/REP playlist files located in \Media\Playlist
  folder into respective PLP playlist files.
- Convert M3U/M3U8/PLS/REP playlist files under \Media\Music folders into
  respective PLP playlist files and copy them to Media/Playlist folder
- Find/guess missing files referred by playlists.
- Covert only playlists that are updated from the previous conversion.
- Import/export tuner presets from/to a text file.
- Simple GUI/CUI (no heavy skin, graphics, etc.)
- Multi-platform (Windows 98SE/ME/2000/XP, Linux, MacOS X, etc).
- More stable and faster than iriver plus and Windows Media Player 10
  in terms of database construction and playlist conversion.

EasyH10 is distributed under GNU General Public License (GPL).
See COPYING (or COPYING.txt)



==========================================================================
2. More information
=========================================================================
As for more information such as usage, building a binary, frequently asked
questions, etc, please refer to EasyH10 official web page.
http://easyh10.sourceforge.net/



==========================================================================
3. Acknowledgement
==========================================================================
This software uses the following libraries:
- libid3tag
    http://www.underbit.com/products/mad/
    license: GPL (see COPYING.txt)

- iriver.pm (Tha part of this source code was ported from iriver.pmj
    http://www.dryft.net/iriver/
    license: GPL (see COPYING.txt)

- zlib
    http://www.gzip.org/zlib/
    license: zlib licence

- Easier Said Than Done (CRC-32 calculation):
    http://www.netrino.com/Connecting/2000-01/

- RC Localization Tool (LocalizeRC):
    http://www.codeproject.com/tools/localizerc.asp

- TRE (POSIX-compliant regexp matching library; used in Win32 versions):
    http://laurikari.net/tre/
    license: LGPL

Thanks go out to Badger, for the H10DB.hdr structure information,
Toby Corkindale, for the experimental implementation (iRiver.pm), and
Jevin for the CRC calculation in a MisticRiver thread, "H10 database
reverse ingeneering". Without the help of these few, EasyH10 would never
have been born.

EasyH10 was translated into a number of languages by courtesy of
contributors. The complete list of languages and contributors is here:
    http://easyh10.sourceforge.net/download.html

Special thanks to Mike Lewis, for offering Linux environment, klima, for
the logo design, Crashd, for the Wiki hosting, Tim Weston, for the English
revision of Win32 GUI, Brad Fisher, for the English revision of web
contents, Benjamin Seidenberg, for the improvements of POSIX CUI,
MisticRiver, for iRiver users' community, and sourceforge.net for the
project hosting.

I would like to close by saying that how deeply I've been impressed by
your heartwarming letters and comments. These are my treasures.



==========================================================================
4. Contact
==========================================================================
If you find some problem, don't hesitate to report it.

Nyaochi <nyaochi1nyaochi2sakura3ne4jp>
iReplace '1'->'@', '2'->'.', '3'->'.', '4'->'.' respectively)
