Iaudio Iaudio M3 Use and care manual

The Rockbox Manual
for
Iaudio M3
rockbox.org
December 16, 2014

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-2013 The Rockbox Team and its contributors, c 2004 Christi Alice
Scarborough, c 2003 José Maria Garcia-Valdecasas Bernal & Peter Schlenker.
Version rUnversioned. Built using pdfL
A
T
E
X.
Permission is granted to copy, distribute and/or modify this document under
the terms of the GNU Free Documentation License, Version 1.2 or any later
version published by the Free Software Foundation; with no Invariant Sec-
tions, 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 (version rUnversioned directory-141216) Iaudio M3

Contents 3
Contents
1. Introduction 11
1.1. Welcome ..................................... 11
1.2. Getting more help ............................... 11
1.3. Naming conventions and marks ........................ 12
2. Installation 13
2.1. Before Starting ................................. 13
2.2. Installing Rockbox ............................... 13
2.2.1. Automated Installation ........................ 14
2.2.2. Manual Installation .......................... 15
2.2.3. Finishing the install .......................... 16
2.2.4. Enabling Speech Support (optional) ................. 16
2.3. Running Rockbox ................................ 16
2.4. Updating Rockbox ............................... 17
2.5. Uninstalling Rockbox ............................. 17
2.5.1. Automatic Uninstallation ....................... 17
2.5.2. Manual Uninstallation ......................... 17
2.6. Troubleshooting ................................. 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. Putting music on your player ..................... 19
3.1.4. The first contact ............................ 19
3.1.5. Basic controls .............................. 20
3.1.6. Basic concepts ............................. 20
3.2. Customising Rockbox ............................. 20
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
4.2.2. Initializing the Database ........................ 26
The Rockbox manual (version rUnversioned directory-141216) Iaudio M3

Contents 4
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.5. Hotkeys ..................................... 37
5. The Main Menu 38
5.1. Introducing the Main Menu .......................... 38
5.2. Navigating the Main Menu .......................... 38
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. Playback Settings ........................... 40
5.7.3. General Settings ............................ 40
5.7.4. Theme Settings ............................. 40
5.7.5. Recording Settings ........................... 40
5.7.6. Manage Settings ............................ 41
5.8. Recording .................................... 41
5.8.1. While Recording Screen ........................ 41
5.9. FM Radio .................................... 42
5.10. Playlists ..................................... 43
5.11. Plugins ..................................... 44
5.12. System ...................................... 44
5.13. Quick Screen .................................. 45
5.14. Shortcuts .................................... 45
6. Sound Settings 47
6.1. Volume ..................................... 47
6.2. Bass ....................................... 47
6.3. Volume Limit .................................. 47
6.4. Treble ...................................... 48
6.5. Balance ..................................... 48
The Rockbox manual (version rUnversioned directory-141216) Iaudio M3

Contents 5
6.6. Channels .................................... 48
6.7. Stereo Width .................................. 48
6.8. Crossfeed .................................... 49
6.9. Equalizer .................................... 50
6.10. Dithering .................................... 52
6.11. Timestretch ................................... 53
6.12. Compressor ................................... 53
7. Playback Settings 55
7.1. Shuffle ...................................... 55
7.2. Repeat ...................................... 55
7.3. Play Selected First ............................... 56
7.4. Fast-Forward/Rewind ............................. 56
7.5. Anti-Skip Buffer ................................ 56
7.6. Fade on Stop/Pause .............................. 56
7.7. Party Mode ................................... 56
7.8. Crossfade .................................... 56
7.9. Replaygain ................................... 58
7.10. Track Skip Beep ................................ 59
7.11. Auto-Change Directory ............................ 59
7.12. Constrain Auto-Change ............................ 59
7.13. Last.fm Log ................................... 59
7.14. Cuesheet Support ................................ 60
7.15. Skip Length ................................... 60
7.16. Prevent Track Skipping ............................ 60
7.17. Rewind Before Resume ............................. 60
7.18. Rewind on Pause ................................ 61
8. General Settings 62
8.1. Playlist ..................................... 62
8.2. File View .................................... 62
8.3. Database .................................... 64
8.4. Display ..................................... 64
8.5. System ...................................... 66
8.5.1. Battery ................................. 66
8.5.2. Disk ................................... 67
8.5.3. Limits .................................. 67
8.5.4. Use Shortcuts Menu Instead of Quick Screen ............ 68
8.5.5. Keyclick ................................. 68
8.6. Startup/Shutdown ............................... 68
8.6.1. Start Screen ............................... 68
8.6.2. Idle Poweroff .............................. 69
8.6.3. Sleep Timer ............................... 69
8.7. Bookmarking .................................. 69
The Rockbox manual (version rUnversioned directory-141216) Iaudio M3

Contents 6
8.8. Automatic resume ............................... 71
8.9. Language .................................... 72
8.10. Voice ....................................... 72
8.11. Hotkey ...................................... 74
9. Theme Settings 75
10.Recording Settings 77
10.1. Format ...................................... 77
10.2. Encoder Settings (MP3 only) ......................... 77
10.3. Frequency .................................... 77
10.4. Source ...................................... 78
10.5. Channels .................................... 78
10.6. Mono Mode ................................... 78
10.7. File Split Options ................................ 78
10.8. Prerecord Time ................................. 78
10.9. Clear Recording Directory ........................... 79
10.10.Clipping Light ................................. 79
10.11.Trigger ...................................... 79
11.Plugins 81
11.1. Games ...................................... 81
11.1.1. 2048 ................................... 81
11.1.2. Blackjack ................................ 82
11.1.3. BrickMania ............................... 82
11.1.4. Bubbles ................................. 83
11.1.5. Chessbox ................................ 84
11.1.6. Chopper ................................. 85
11.1.7. Dice ................................... 85
11.1.8. Doom .................................. 86
11.1.9. Flipit .................................. 88
11.1.10.Goban .................................. 88
11.1.11.Invadrox ................................. 92
11.1.12.Jackpot ................................. 93
11.1.13.Jewels .................................. 93
11.1.14.MazezaM ................................ 94
11.1.15.Minesweeper .............................. 95
11.1.16.Pegbox ................................. 95
11.1.17.Pong ................................... 96
11.1.18.Reversi ................................. 97
11.1.19.Robotfindskitten ............................ 97
11.1.20.Rockblox ................................ 98
11.1.21.Rockblox1d ............................... 98
11.1.22.Sliding Puzzle .............................. 99
The Rockbox manual (version rUnversioned directory-141216) Iaudio M3

Contents 7
11.1.23.Snake .................................. 99
11.1.24.Snake 2 .................................100
11.1.25.Sokoban .................................101
11.1.26.Solitaire .................................102
11.1.27.Spacerocks ...............................103
11.1.28.Star ...................................103
11.1.29.Sudoku .................................104
11.1.30.Wormlet .................................105
11.1.31.Xobox ..................................108
11.2. Demos ......................................108
11.2.1. Bounce .................................108
11.2.2. Credits .................................109
11.2.3. Cube ...................................109
11.2.4. Demystify ................................110
11.2.5. Fire ...................................111
11.2.6. Fractals .................................111
11.2.7. Logo ...................................112
11.2.8. Mosaique ................................112
11.2.9. Oscilloscope ...............................113
11.2.10.PictureFlow ...............................114
11.2.11.Plasma .................................115
11.2.12.Rocklife .................................116
11.2.13.Snow ...................................116
11.2.14.Starfield .................................117
11.2.15.VU meter ................................117
11.3. Viewers .....................................118
11.3.1. Shortcuts ................................118
11.3.2. Chip-8 Emulator ............................119
11.3.3. Frotz ...................................120
11.3.4. Image Viewer ..............................121
11.3.5. Lua scripting language .........................122
11.3.6. Midiplay .................................123
11.3.7. MPEG Player ..............................123
11.3.8. MP3 Encoder ..............................125
11.3.9. Search ..................................125
11.3.10.Shopper .................................126
11.3.11.Sort ...................................126
11.3.12.Text Viewer ...............................126
11.3.13.Theme Remove .............................129
11.3.14.VBRfix .................................130
11.3.15.ZXBox ..................................131
11.4. Applications ...................................133
11.4.1. Battery Benchmark ..........................133
11.4.2. Calculator ................................134
The Rockbox manual (version rUnversioned directory-141216) Iaudio M3

Contents 8
11.4.3. Chess Clock ...............................135
11.4.4. Disk Tidy ................................136
11.4.5. Keybox .................................137
11.4.6. Lamp ..................................137
11.4.7. Lrcplayer ................................137
11.4.8. md5sum .................................140
11.4.9. Metronome ...............................140
11.4.10.Periodic Table .............................141
11.4.11.Pitch Detector .............................141
11.4.12.Random Folder Advance Configuration ...............141
11.4.13.Resistor Calculator ...........................142
11.4.14.Stats ...................................143
11.4.15.Stopwatch ................................143
11.4.16.Text Editor ...............................144
12.Advanced Topics 145
12.1. Customising the User Interface ........................145
12.1.1. Customising The Main Menu .....................145
12.1.2. Getting Extras .............................145
12.1.3. Loading Fonts .............................145
12.1.4. Loading Languages ...........................146
12.1.5. Loading Backdrops ...........................146
12.1.6. UI Viewport ..............................146
12.2. Configuring the Theme .............................147
12.2.1. Themeing – General Info .......................147
12.2.2. Themes – Create Your Own ......................147
12.2.3. Info Viewport (SBS only) .......................150
12.2.4. Additional Fonts ............................150
12.3. Managing Rockbox Settings ..........................153
12.3.1. Introduction to .cfg Files .......................153
12.3.2. Specifications for .cfg Files ......................153
12.3.3. The Manage Settings menu ....................154
12.4. Firmware Loading ...............................155
12.4.1. Using ROLO (Rockbox Loader) ....................155
12.5. Optimising battery runtime ..........................155
12.5.1. Display backlight ............................155
12.5.2. Anti-Skip Buffer ............................155
12.5.3. Replaygain ...............................155
12.5.4. Peak Meter ...............................156
12.5.5. Audio format and bitrate .......................156
12.5.6. Sound settings .............................156
A. File formats 157
A.1. Supported file formats .............................158
The Rockbox manual (version rUnversioned directory-141216) Iaudio M3

Contents 9
B. Audio and metadata formats 159
B.1. Supported audio formats ............................159
B.1.1. Lossy Codecs ..............................159
B.1.2. Lossless Codecs .............................160
B.1.3. Other Codecs ..............................161
B.1.4. Codec featureset ............................162
B.2. Supported metadata tags ...........................163
B.2.1. Featureset for generic metadata tags .................163
B.2.2. Featureset for codec specific metadata ................164
B.2.3. Limitations of metadata handling ...................164
C. Album Art 165
C.1. Limitations ...................................165
C.2. Where to put album art ............................165
D. Theme Tags 167
D.1. Status Bar ....................................167
D.2. Hardware Capabilities .............................167
D.3. Information from the track tags ........................168
D.4. Viewports ....................................168
D.5. Additional Fonts ................................169
D.6. Misc Coloring Tags ...............................169
D.7. Power Related Information ..........................169
D.8. Information about the file ...........................170
D.9. Playlist/Song Info ...............................171
D.10.Playlist Viewer .................................171
D.11.Runtime Database ...............................172
D.12.Sound (DSP) settings .............................172
D.13.Hold .......................................172
D.14.Virtual LED ..................................173
D.15.Repeat Mode ..................................173
D.16.Playback Mode .................................173
D.17.Current Screen .................................173
D.18.List Title (.sbs only) .............................174
D.19.Changing Volume ................................175
D.20.Settings .....................................175
D.21.Images ......................................176
D.21.1.How to display the album art .....................177
D.22.FM Radio ....................................178
D.23.Alignment and language direction .......................179
D.24.Conditional Tags ................................179
D.25.Subline Tags ..................................180
D.26.Text Translation ................................180
The Rockbox manual (version rUnversioned directory-141216) Iaudio M3

Contents 10
D.27.Bar Tags .....................................180
D.27.1.Options .................................181
D.28.Other Tags ...................................182
E. Config file options 183
F. Menu Overview 188
G. User feedback 189
G.1. Bug reports ...................................189
G.1.1. Rules for submitting new bug reports ................189
G.2. Feature ideas ..................................189
G.2.1. Rules for submitting a new feature idea ...............189
G.2.2. Features we will not implement ....................190
H. Credits 191
I. Licenses 195
I.1. GNU Free Documentation License ......................195
I.2. The GNU General Public License .......................203
The Rockbox manual (version rUnversioned directory-141216) Iaudio M3