IRiver H320 User manual

The Rockbox Manual
for
Iriver H320 and H340
rockbox.org
September 24, 2008

2
Rockbox
http://www.rockbox.org/
Open Source Jukebox Firmware
Rockbox and this manual is the collaborative effort of the Rockbox team and
its contributors. See the appendix for a complete list of contributors.
c
2003-2008 The Rockbox Team and its contributors, c 2004 Christi Alice
Scarborough, c 2003 Jos´ e Maria Garcia-Valdecasas Bernal & Peter Schlenker.
Version r18615-3.0-080923. Built using pdfL
A
T
EX.
Permission is granted to copy, distribute and/or modify this document un-
der the terms of the GNU Free Documentation License, Version 1.2 or any
later version published by the Free Software Foundation; with no Invari-
ant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of
the license is included in the section entitled “GNU Free Documentation
License”.
THE ROCKBOX MANUAL IRIVER H3XX

CONTENTS 3
Contents
1 Introduction 9
1.1 Welcome ..................................... 9
1.2 Getting more help ................................ 9
1.3 Naming conventions and marks ....................... 10
2 Installation 11
2.1 Overview ..................................... 11
2.2 Prerequisites ................................... 11
2.3 Installing Rockbox ............................... 12
2.3.1 Automated Installation ........................ 12
2.3.2 Manual Installation ........................... 13
2.3.3 Enabling Speech Support (optional) ................. 16
2.4 Running Rockbox ................................ 16
2.5 Updating Rockbox ............................... 16
2.6 Uninstalling Rockbox .............................. 16
2.6.1 Automatic Uninstallation ....................... 17
2.6.2 Manual Uninstallation ......................... 17
3 Quick Start 18
3.1 Basic Overview ................................. 18
3.1.1 The player’s controls .......................... 18
3.1.2 Turning the player on and off ..................... 19
3.1.3 Starting the original firmware ..................... 19
3.1.4 Putting music on your player ..................... 19
3.1.5 The first contact ............................. 19
3.1.6 Basic controls .............................. 19
3.1.7 Basic concepts .............................. 20
3.2 Customising Rockbox ............................. 20
3.3 Charging ..................................... 21
4 Browsing and playing 22
4.1 File Browser ................................... 22
4.1.1 File Browser Controls ......................... 23
4.1.2 Context Menu .............................. 23
4.1.3 Virtual Keyboard ............................ 25
4.2 Database ..................................... 26
4.2.1 Introduction ............................... 26
THE ROCKBOX MANUAL IRIVER H3XX

CONTENTS 4
4.2.2 Initializing the Database ........................ 26
4.2.3 The Database Menu .......................... 26
4.2.4 Using the Database ........................... 27
4.3 While Playing Screen .............................. 28
4.3.1 WPS Key Controls ........................... 29
4.3.2 Peak Meter ............................... 30
4.3.3 The WPS Context Menu ........................ 30
4.4 Working with Playlists ............................. 33
4.4.1 Playlist terminology .......................... 33
4.4.2 Creating playlists ............................ 33
4.4.3 Adding music to playlists ....................... 35
4.4.4 Modifying playlists ........................... 36
4.4.5 Saving playlists ............................. 36
4.4.6 Loading saved playlists ........................ 37
4.4.7 Helpful Hints .............................. 37
5 The Main Menu 38
5.1 Introducing the Main Menu .......................... 38
5.2 Navigating the Main Menu .......................... 39
5.3 Recent Bookmarks ............................... 39
5.4 Files ........................................ 39
5.5 Database ..................................... 40
5.6 Now Playing/Resume Playback ....................... 40
5.7 Settings ...................................... 40
5.7.1 Sound Settings ............................. 40
5.7.2 General Settings ............................. 40
5.7.3 Manage Settings ............................ 40
5.7.4 Theme Settings ............................. 40
5.7.5 Recording Settings ........................... 41
5.8 Recording .................................... 41
5.8.1 While Recording Screen ........................ 41
5.9 FM Radio ..................................... 42
5.10 Playlist ...................................... 43
5.11 Plugins ...................................... 44
5.12 System ...................................... 44
5.13 Quick Screen ................................... 45
6 Sound Settings 46
6.1 Volume ...................................... 46
6.2 Bass ........................................ 46
6.3 Treble ....................................... 47
6.4 Balance ...................................... 47
6.5 Channels ..................................... 47
6.6 Stereo Width ................................... 47
THE ROCKBOX MANUAL IRIVER H3XX

CONTENTS 5
6.7 Crossfeed ..................................... 48
6.8 Equalizer ..................................... 49
6.9 Dithering ..................................... 51
7 General Settings 52
7.1 Playback ..................................... 52
7.2 Playlist ...................................... 56
7.3 File View ..................................... 57
7.4 Database ..................................... 58
7.5 Display ...................................... 58
7.6 System ...................................... 61
7.6.1 Start Screen ............................... 61
7.6.2 Battery .................................. 61
7.6.3 Disk ................................... 62
7.6.4 Time and Date .............................. 62
7.6.5 Idle Poweroff .............................. 62
7.6.6 Limits .................................. 62
7.6.7 Car Adapter Mode ........................... 63
7.7 Bookmarking .................................. 63
7.8 Language ..................................... 64
7.9 Voice ....................................... 64
8 Theme Settings 67
9 Recording Settings 69
9.1 Format ...................................... 69
9.2 Encoder Settings ................................. 69
9.3 Frequency .................................... 69
9.4 Source ...................................... 70
9.5 Channels ..................................... 70
9.6 File Split Options ................................ 70
9.7 Prerecord Time ................................. 70
9.8 Clear Recording Directory ........................... 70
9.9 Clipping Light .................................. 71
9.10 Trigger ...................................... 71
9.11 Automatic Gain Control ............................ 72
9.12 AGC clip time .................................. 73
10 Plugins 74
10.1 Games ...................................... 74
10.1.1 Blackjack ................................. 74
10.1.2 BrickMania ............................... 75
10.1.3 Bubbles ................................. 76
10.1.4 Chessbox ................................. 77
THE ROCKBOX MANUAL IRIVER H3XX

CONTENTS 6
10.1.5 Chopper ................................. 78
10.1.6 Dice .................................... 78
10.1.7 Doom ................................... 79
10.1.8 Flipit ................................... 81
10.1.9 Jewels .................................. 82
10.1.10 MazezaM ................................ 83
10.1.11 Minesweeper .............................. 84
10.1.12 Pacbox .................................. 85
10.1.13 Pegbox .................................. 86
10.1.14 Pong ................................... 87
10.1.15 Robotfindskitten ............................ 88
10.1.16 Rockblox ................................. 88
10.1.17 Rockblox1d ............................... 89
10.1.18 Sliding Puzzle .............................. 90
10.1.19 Snake ................................... 91
10.1.20 Snake 2 .................................. 91
10.1.21 Sokoban ................................. 92
10.1.22 Solitaire ................................. 93
10.1.23 Spacerocks ................................ 94
10.1.24 Star .................................... 95
10.1.25 Sudoku .................................. 96
10.1.26 Wormlet ................................. 97
10.1.27 Xobox .................................. 100
10.2 Demos ...................................... 101
10.2.1 Bounce .................................. 101
10.2.2 Credits .................................. 101
10.2.3 Cube ................................... 102
10.2.4 Demystify ................................ 103
10.2.5 Fire .................................... 103
10.2.6 Logo ................................... 104
10.2.7 Mandelbrot ............................... 104
10.2.8 Mosaique ................................ 105
10.2.9 Oscilloscope ............................... 106
10.2.10 Plasma .................................. 107
10.2.11 Snow ................................... 107
10.2.12 Starfield ................................. 108
10.2.13 VU meter ................................ 108
10.3 Viewers ...................................... 109
10.3.1 Shortcuts ................................. 109
10.3.2 Chip-8 Emulator ............................ 110
10.3.3 JPEG viewer ............................... 111
10.3.4 Midiplay ................................. 112
10.3.5 MPEG Player .............................. 112
10.3.6 PPM viewer ............................... 114
THE ROCKBOX MANUAL IRIVER H3XX

CONTENTS 7
10.3.7 Rockboy ................................. 114
10.3.8 Search .................................. 115
10.3.9 Sort .................................... 115
10.3.10 Text Viewer ............................... 115
10.3.11 VBRfix .................................. 117
10.3.12 ZXBox .................................. 118
10.4 Applications ................................... 119
10.4.1 Battery Benchmark ........................... 119
10.4.2 Calculator ................................ 121
10.4.3 Chess Clock ............................... 122
10.4.4 Clock ................................... 123
10.4.5 Disk Tidy ................................ 125
10.4.6 Keybox .................................. 126
10.4.7 Lamp ................................... 127
10.4.8 Metronome ............................... 127
10.4.9 Random Folder Advance Configuration ............... 127
10.4.10 Stats ................................... 128
10.4.11 Stopwatch ................................ 129
10.4.12 Text Editor ................................ 129
11 Advanced Topics 131
11.1 Customising the User Interface ........................ 131
11.1.1 Getting Extras .............................. 131
11.1.2 Loading Fonts .............................. 131
11.1.3 Loading Languages .......................... 131
11.1.4 Changing Colours ........................... 131
11.1.5 Changing Filetype Colours ...................... 132
11.1.6 Loading Backdrops ........................... 132
11.2 Configuring the WPS .............................. 132
11.2.1 WPS – General Info ........................... 132
11.2.2 WPS – Build Your Own ........................ 132
11.3 Managing Rockbox Settings .......................... 135
11.3.1 Introduction to .cfg Files. ...................... 135
11.3.2 Specifications for .cfg Files. ..................... 136
11.3.3 The MANAGE SETTINGS menu .................... 137
11.4 Firmware Loading ............................... 137
11.4.1 Using ROLO (Rockbox Loader) .................... 137
A File formats 138
A.1 Supported file formats ............................. 138
A.2 Supported audio formats ............................ 139
B WPS Tags 140
B.1 Status Bar .................................... 140
THE ROCKBOX MANUAL IRIVER H3XX

CONTENTS 8
B.2 ID3 Info ...................................... 140
B.3 Power Related Information .......................... 141
B.4 File Info ...................................... 141
B.5 Playlist/Song Info ................................ 142
B.6 Runtime Database ................................ 142
B.7 Sound (DSP) settings .............................. 142
B.8 Hold Switches .................................. 143
B.9 Virtual LED ................................... 143
B.10 Repeat Mode ................................... 143
B.11 Playback Mode Tags .............................. 143
B.12 Images ...................................... 144
B.13 Alignment .................................... 145
B.14 Conditional Tags ................................ 145
B.15 Real Time Clock ................................. 146
B.16 Other Tags .................................... 146
C Config file options 147
D User feedback 152
D.1 Bug reports .................................... 152
D.1.1 Rules for submitting new bug reports ................ 152
D.2 Feature ideas ................................... 152
D.2.1 Rules for submitting a new feature idea ............... 152
D.2.2 Features we will not implement ................... 153
E Changelog 154
E.1 What is new since v2.5? ............................ 154
E.1.1 New features .............................. 154
E.1.2 Enhancements .............................. 155
E.1.3 New codecs supported ......................... 156
F Credits 157
G Licenses 160
G.1 GNU Free Documentation License ...................... 160
G.2 The GNU General Public License ....................... 168
THE ROCKBOX MANUAL IRIVER H3XX

CHAPTER 1. INTRODUCTION 9
1 Introduction
1.1 Welcome
This is the manual for Rockbox. Rockbox is an open source firmware replacement for
a growing number of digital audio players. Rockbox aims to be considerably more
functional and efficient than your device’s stock firmware while remaining easy to use
and customisable. Rockbox is written by users, for users. Not only is it free to use, it
is also released under the GNU General Public License (GPL), which means that it will
always remain free both to use and to change.
Rockbox has been in development since 2001, and receives new features, tweaks and
fixes each day to provide you with the best possible experience on your digital audio
player. A major goal of Rockbox is to be simple and easy to use, yet remain very cus-
tomisable and configurable. We believe that you should never need to go through a
series of menus for an action you perform frequently. We also believe that you should
be able to configure almost anything about Rockbox you could want, pertaining to
functionality. Another top priority of Rockbox is audio playback quality – Rockbox,
for most models, includes a wider range of sound settings than the device’s original
firmware. A lot of work has been put into making Rockbox sound the best it can, and
improvements are constantly being made. All models have access to a large number
of plugins, including many games, applications, and graphical “demos”. You can load
different configurations quickly for different purposes (e.g. a large font for in your car,
different sound settings for at home). Rockbox features a very wide range of languages,
and all supported models also have the ability to talk to you – menus can be voiced and
filenames spelled out or spoken.
1.2 Getting more help
This manual is intended to be a comprehensive introduction to the Rockbox firmware.
There is, however, more help available. The Rockbox website at http://www.rockbox.org/
contains very extensive documentation and guides written by members of the Rockbox
community and this should be your first port of call when looking for further help.
If you cannot find the information you are searching for on the Rockbox website there
are a number of support channels you should have a look at. You can try the Rockbox
forums located at http://forums.rockbox.org/. Another option are the mailing lists which
can be found at http://www.rockbox.org/mail/. From that page you can subscribe to the
lists and browse the archives. For searching the list archives simply use the search field
that is located on the left side of the website. Also you can ask on IRC. The main channel
THE ROCKBOX MANUAL IRIVER H3XX

CHAPTER 1. INTRODUCTION 10
for Rockbox is #rockbox on irc://irc.freenode.net. A bunch of helpful developers and
users are usually around. Just join and ask – if someone knows the answer you’ll usu-
ally get an answer pretty quickly. More information including IRC logs can be found
at http://www.rockbox.org/irc/. We also have a web client for joining the rockbox IRC
channel so there is no need for you to install additional software to your computer.
If you think you have found a bug please make sure it actually is a bug and is still
present in the most recent version of rockbox. You should try to confirm that by using
the above mentioned support channels first. After that you can submit that issue to our
tracker. Refer to section D(page 152) for details on how to use the tracker.
1.3 Naming conventions and marks
We have some conventions especially on naming that are intended to be consistent
throughout this manual.
Manufacturer and product names are formatted in accordance with the standard
rules of English grammar, e.g. “Iriver playback is currently unsupported”. Manufac-
turer and model names are proper nouns, and thus are written beginning with a capital
letter.
This manual has some parts that are marked with icons on the margin to help you
finding important parts or parts you could skip. The following icons are used:
Note: This indicates a note. A note starts always with the text “Note”. For easier finding b
of notes we have put this an icon in the margin like here. Notes are used to mark infor-
mation that could help you or indicate a possible “weirdness” in rockbox that would
be explained.
Warning: This is a warning. In contrast to notes mentioned above, a warning should be !
taken more seriously. While ignoring notes will not cause any serious damage ignoring
warnings could cause serious damage. If you are new to rockbox you should really read
the warnings before doing anything that is warned about.
This icon marks a section that is intended especially for the blind and visually im- ¸
paired. As they cannot read the manual in the same way sighted people do we have
added some additional descriptions. If you are not blind or visually impaired you most
likely can completely skip these blocks. To make this easier, there is an icon shown in
the margin on the right.
Links to the wiki are abbreviated by the name of the wiki page. Those names are still
linked so you can simply follow them like any other link in this manual. If you want
to access a wiki page manually go to Zhttp://www.rockbox.org/wiki/ and type the
page name in the “Go” box at the top of the page. Links to wiki pages are also indicated
by the symbol Zin front of the page name.
THE ROCKBOX MANUAL IRIVER H3XX