Toshiba Gigabeat F Series User manual

The Rockbox Manual
for
Toshiba Gigabeat F and X Series
rockbox.org
October 30, 2010

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-2010 The Rockbox Team and its contributors, c 2004 Christi Alice
Scarborough, c 2003 José Maria Garcia-Valdecasas Bernal & Peter Schlenker.
Version 3.7. Built using pdfL
A
T
EX.
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 Toshiba Gigabeat F and X Series

Contents 3
Contents
1. Introduction 10
1.1. Welcome ..................................... 10
1.2. Getting more help ............................... 10
1.3. Naming conventions and marks ........................ 11
2. Installation 12
2.1. Before Starting ................................. 12
2.2. Installing Rockbox ............................... 12
2.2.1. Automated Installation ........................ 13
2.2.2. Manual Installation ........................... 14
2.2.3. Finishing the install .......................... 15
2.2.4. Enabling Speech Support (optional) ................. 16
2.3. Running Rockbox ................................ 16
2.4. Updating Rockbox ............................... 16
2.5. Uninstalling Rockbox .............................. 16
2.5.1. Automatic Uninstallation ....................... 16
2.5.2. Manual Uninstallation ......................... 16
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 ............................ 20
3.1.5. Basic controls .............................. 20
3.1.6. Basic concepts ............................. 20
3.2. Customising Rockbox ............................. 21
3.3. USB Charging .................................. 21
4. Browsing and playing 22
4.1. File Browser ................................... 22
4.1.1. File Browser Controls ......................... 23
4.1.2. Context Menu ............................. 24
4.1.3. Virtual Keyboard ............................ 26
4.2. Database .................................... 27
4.2.1. Introduction ............................... 27
The Rockbox manual Toshiba Gigabeat F and X Series

Contents 4
4.2.2. Initializing the Database ........................ 27
4.2.3. The Database Menu .......................... 28
4.2.4. Using the Database ........................... 29
4.3. While Playing Screen .............................. 30
4.3.1. WPS Key Controls ........................... 31
4.3.2. Peak Meter ............................... 32
4.3.3. The WPS Context Menu ........................ 32
4.4. Working with Playlists ............................. 35
4.4.1. Playlist terminology .......................... 35
4.4.2. Creating playlists ............................ 36
4.4.3. Adding music to playlists ....................... 37
4.4.4. Modifying playlists ........................... 39
4.4.5. Saving playlists ............................. 39
4.4.6. Loading saved playlists ......................... 39
4.4.7. Helpful Hints .............................. 39
4.5. Hotkeys ..................................... 40
5. The Main Menu 41
5.1. Introducing the Main Menu .......................... 41
5.2. Navigating the Main Menu .......................... 42
5.3. Recent Bookmarks ............................... 42
5.4. Files ....................................... 43
5.5. Database .................................... 43
5.6. Now Playing/Resume Playback ........................ 43
5.7. Settings ..................................... 43
5.7.1. Sound Settings ............................. 44
5.7.2. Playback Settings ............................ 44
5.7.3. General Settings ............................ 44
5.7.4. Theme Settings ............................. 44
5.7.5. Manage Settings ............................ 44
5.8. Playlist ..................................... 44
5.9. Plugins ..................................... 45
5.10. System ...................................... 45
5.11. Quick Screen .................................. 45
6. Sound Settings 47
6.1. Volume ..................................... 47
6.2. Bass ....................................... 48
6.3. Treble ...................................... 48
6.4. Balance ..................................... 48
6.5. Channels ..................................... 48
6.6. Stereo Width .................................. 48
6.7. Crossfeed .................................... 49
6.8. Equalizer .................................... 50
The Rockbox manual Toshiba Gigabeat F and X Series

Contents 5
6.9. Dithering .................................... 52
6.10. Timestretch ................................... 52
6.11. Compressor ................................... 53
7. Playback Settings 54
7.1. Shuffle ...................................... 54
7.2. Repeat ...................................... 54
7.3. Play Selected First ............................... 55
7.4. Fast-Forward/Rewind ............................. 55
7.5. Anti-Skip Buffer ................................ 55
7.6. Fade on Stop/Pause .............................. 55
7.7. Party Mode ................................... 55
7.8. Crossfade .................................... 55
7.9. Replaygain ................................... 57
7.10. Track Skip Beep ................................ 58
7.11. Auto-Change Directory ............................ 58
7.12. Pause on Headphone Unplug ......................... 58
7.13. Last.fm Log ................................... 59
7.14. Cuesheet Support ................................ 59
7.15. Skip Length ................................... 59
7.16. Prevent Track Skipping ............................ 59
7.17. Rewind Before Resume ............................. 59
8. General Settings 61
8.1. Playlist ..................................... 61
8.2. File View .................................... 61
8.3. Database .................................... 63
8.4. Display ..................................... 63
8.5. System ...................................... 66
8.5.1. Start Screen ............................... 66
8.5.2. Battery ................................. 66
8.5.3. Disk ................................... 66
8.5.4. Idle Poweroff .............................. 67
8.5.5. Limits .................................. 67
8.5.6. Car Adapter Mode ........................... 67
8.5.7. Button Light Timeout ......................... 68
8.5.8. Button Light Brightness ........................ 68
8.6. Bookmarking .................................. 68
8.7. Language .................................... 70
8.8. Voice ....................................... 70
8.9. Hotkey ...................................... 71
9. Theme Settings 72
The Rockbox manual Toshiba Gigabeat F and X Series

Contents 6
10.Plugins 74
10.1. Games ...................................... 74
10.1.1. Blackjack ................................ 75
10.1.2. BrickMania ............................... 76
10.1.3. Bubbles ................................. 77
10.1.4. Chessbox ................................ 78
10.1.5. Clix ................................... 79
10.1.6. Chopper ................................. 80
10.1.7. Codebuster ............................... 81
10.1.8. Dice ................................... 81
10.1.9. Doom .................................. 82
10.1.10.Flipit .................................. 84
10.1.11.Goban .................................. 85
10.1.12.Invadrox ................................. 90
10.1.13.Jackpot ................................. 91
10.1.14.Jewels .................................. 92
10.1.15.MazezaM ................................ 93
10.1.16.Minesweeper .............................. 94
10.1.17.Pacbox ................................. 95
10.1.18.Pegbox ................................. 96
10.1.19.Pong ................................... 97
10.1.20.Reversi ................................. 98
10.1.21.Robotfindskitten ............................ 98
10.1.22.Rockblox ................................ 99
10.1.23.Rockblox1d ...............................100
10.1.24.Rocklife .................................100
10.1.25.Sliding Puzzle ..............................101
10.1.26.Snake ..................................102
10.1.27.Snake 2 .................................103
10.1.28.Sokoban .................................104
10.1.29.Solitaire .................................106
10.1.30.Spacerocks ...............................107
10.1.31.Star ...................................108
10.1.32.Sudoku .................................109
10.1.33.Wormlet .................................111
10.1.34.Xobox ..................................114
10.2. Demos ......................................115
10.2.1. Bounce .................................115
10.2.2. Credits .................................116
10.2.3. Cube ...................................116
10.2.4. Demystify ................................117
10.2.5. Fire ...................................118
10.2.6. Fractals .................................119
10.2.7. Logo ...................................119
The Rockbox manual Toshiba Gigabeat F and X Series

Contents 7
10.2.8. Mosaique ................................120
10.2.9. Oscilloscope ...............................121
10.2.10.PictureFlow ...............................122
10.2.11.Plasma .................................124
10.2.12.Snow ...................................125
10.2.13.Starfield .................................126
10.2.14.VU meter ................................127
10.3. Viewers .....................................127
10.3.1. Shortcuts ................................128
10.3.2. BMP viewer ...............................129
10.3.3. Chip-8 Emulator ............................130
10.3.4. Frotz ...................................131
10.3.5. JPEG viewer ..............................132
10.3.6. Lua scripting language .........................132
10.3.7. Midiplay .................................133
10.3.8. MPEG Player ..............................133
10.3.9. PNG viewer ...............................135
10.3.10.PPM viewer ...............................136
10.3.11.Rockboy .................................136
10.3.12.Search ..................................137
10.3.13.Shopper .................................137
10.3.14.Sort ...................................138
10.3.15.Text Viewer ...............................138
10.3.16.Theme Remove .............................143
10.3.17.VBRfix .................................144
10.3.18.ZXBox ..................................145
10.4. Applications ...................................147
10.4.1. Alarm Clock ..............................147
10.4.2. Battery Benchmark ...........................147
10.4.3. Calculator ................................149
10.4.4. Calendar ................................150
10.4.5. Chess Clock ...............................151
10.4.6. Clock ..................................152
10.4.7. Disk Tidy ................................155
10.4.8. Keybox .................................155
10.4.9. Lamp ..................................156
10.4.10.Lrcplayer ................................156
10.4.11.md5sum .................................159
10.4.12.Metronome ...............................159
10.4.13.Random Folder Advance Configuration ................159
10.4.14.Resistor Calculator ...........................160
10.4.15.Rockpaint ................................161
10.4.16.Stats ...................................164
10.4.17.Stopwatch ................................165
The Rockbox manual Toshiba Gigabeat F and X Series

Contents 8
10.4.18.Text Editor ...............................165
11.Advanced Topics 167
11.1. Customising the User Interface ........................167
11.1.1. Getting Extras .............................167
11.1.2. Loading Fonts ..............................167
11.1.3. Loading Languages ...........................167
11.1.4. Changing Filetype Colours ......................167
11.1.5. Loading Backdrops ...........................169
11.1.6. UI Viewport ..............................169
11.2. Configuring the Theme .............................170
11.2.1. Themeing – General Info ........................170
11.2.2. Themes – Create Your Own ......................170
11.2.3. Info Viewport (SBS only) .......................172
11.2.4. Additional Fonts ............................173
11.3. Managing Rockbox Settings ..........................175
11.3.1. Introduction to .cfg Files .......................175
11.3.2. Specifications for .cfg Files ......................176
11.3.3. The Manage Settings menu ....................177
11.4. Firmware Loading ...............................177
11.4.1. Using ROLO (Rockbox Loader) ....................177
11.5. Optimising battery runtime ..........................177
11.5.1. Display backlight ............................178
11.5.2. Display power-off ............................178
11.5.3. Anti-Skip Buffer ............................178
11.5.4. Replaygain ...............................178
11.5.5. Audio format and bitrate .......................178
11.5.6. Sound settings .............................179
A. File formats 180
A.1. Supported file formats .............................181
A.2. Supported audio formats ............................182
A.2.1. Lossy Codecs ..............................182
A.2.2. Lossless Codecs .............................183
A.2.3. Other Codecs ..............................184
B. Theme Tags 185
B.1. Status Bar ....................................185
B.2. Information from the track tags ........................185
B.3. Viewports ....................................186
B.4. Additional Fonts ................................186
B.5. Power Related Information ..........................186
B.6. Information about the file ...........................187
B.7. Playlist/Song Info ...............................188
The Rockbox manual Toshiba Gigabeat F and X Series

Contents 9
B.8. Playlist Viewer .................................188
B.9. Runtime Database ...............................189
B.10.Sound (DSP) settings .............................189
B.11.Hold .......................................189
B.12.Virtual LED ...................................189
B.13.Repeat Mode ..................................190
B.14.Playback Mode .................................190
B.15.Current Screen .................................190
B.16.List Title (.sbs only) .............................190
B.17.Changing Volume ................................191
B.18.Settings .....................................191
B.19.Images ......................................192
B.20.Album Art ...................................193
B.20.1. Limitations ...............................193
B.20.2. Where to put album art ........................193
B.20.3. How to display the album art .....................194
B.21.Alignment and language direction .......................195
B.22.Conditional Tags ................................195
B.23.Subline Tags ..................................196
B.24.Time and Date .................................196
B.25.Text Translation ................................197
B.26.Bar Tags .....................................197
B.26.1. Options .................................197
B.27.Other Tags ...................................198
C. Config file options 199
D. Menu Overview 204
E. User feedback 205
E.1. Bug reports ...................................205
E.1.1. Rules for submitting new bug reports .................205
E.2. Feature ideas ..................................205
E.2.1. Rules for submitting a new feature idea ...............205
E.2.2. Features we will not implement ....................206
F. Credits 207
G. Licenses 211
G.1. GNU Free Documentation License ......................211
G.2. The GNU General Public License .......................219
The Rockbox manual Toshiba Gigabeat F and X Series

Chapter 1. Introduction 10
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 func-
tional 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/. The mailing lists are another option, and
can be found at http://www.rockbox.org/mail/. From that page you can subscribe to the
lists and browse the archives. To search the list archives simply use the search field that
is located on the left side of the website. Furthermore, you can ask on IRC. The main
The Rockbox manual Toshiba Gigabeat F and X Series