Toshiba Gigabeat F User manual

The Rockbox Manual
for
Toshiba Gigabeat F and X Series
rockbox.org
April 30, 2017

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 3.14. 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 (version 3.14) Toshiba Gigabeat F and X Series

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) ................. 17
2.3. Running Rockbox ................................ 17
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 ................................. 18
3. Quick Start 19
3.1. Basic Overview ................................. 19
3.1.1. The player’s controls .......................... 19
3.1.2. Turning the player on and off ..................... 20
3.1.3. Putting music on your player ..................... 20
3.1.4. The first contact ............................ 21
3.1.5. Basic controls .............................. 21
3.1.6. Basic concepts ............................. 21
3.2. Customising Rockbox ............................. 22
3.3. USB Charging ................................. 22
4. Browsing and playing 23
4.1. File Browser ................................... 23
4.1.1. File Browser Controls ......................... 24
4.1.2. Context Menu ............................. 25
4.1.3. Virtual Keyboard ............................ 27
4.2. Database .................................... 28
4.2.1. Introduction .............................. 28
The Rockbox manual (version 3.14) Toshiba Gigabeat F and X Series

Contents 4
4.2.2. Initializing the Database ........................ 28
4.2.3. The Database Menu .......................... 29
4.2.4. Using the Database .......................... 30
4.3. While Playing Screen .............................. 31
4.3.1. WPS Key Controls ........................... 32
4.3.2. Peak Meter ............................... 33
4.3.3. The WPS Context Menu ....................... 33
4.4. Working with Playlists ............................. 36
4.4.1. Playlist terminology .......................... 36
4.4.2. Creating playlists ............................ 37
4.4.3. Adding music to playlists ....................... 38
4.4.4. Modifying playlists ........................... 39
4.4.5. Saving playlists ............................. 40
4.4.6. Loading saved playlists ........................ 40
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. Playlists ..................................... 44
5.9. Plugins ..................................... 45
5.10. System ...................................... 45
5.11. Quick Screen .................................. 45
5.12. Shortcuts .................................... 46
6. Sound Settings 48
6.1. Volume ..................................... 48
6.2. Bass ....................................... 49
6.3. Volume Limit .................................. 49
6.4. Treble ...................................... 49
6.5. Balance ..................................... 49
6.6. Channels .................................... 49
6.7. Stereo Width .................................. 50
6.8. Crossfeed .................................... 50
The Rockbox manual (version 3.14) Toshiba Gigabeat F and X Series

Contents 5
6.9. Equalizer .................................... 51
6.10. Dithering .................................... 54
6.11. Timestretch ................................... 54
6.12. Haas Surround ................................. 54
6.13. Perceptual Bass Enhancement ......................... 55
6.14. Auditory Fatigue Reduction .......................... 55
6.15. Compressor ................................... 55
7. Playback Settings 57
7.1. Shuffle ...................................... 57
7.2. Repeat ...................................... 57
7.3. Play Selected First ............................... 58
7.4. Fast-Forward/Rewind ............................. 58
7.5. Anti-Skip Buffer ................................ 58
7.6. Fade on Stop/Pause .............................. 58
7.7. Party Mode ................................... 58
7.8. Crossfade .................................... 58
7.9. Replaygain ................................... 60
7.10. Track Skip Beep ................................ 61
7.11. Auto-Change Directory ............................ 61
7.12. Constrain Auto-Change ............................ 61
7.13. Pause on Headphone Unplug ......................... 61
7.14. Last.fm Log ................................... 62
7.15. Cuesheet Support ................................ 62
7.16. Skip Length ................................... 62
7.17. Prevent Track Skipping ............................ 62
7.18. Rewind Before Resume ............................. 63
7.19. Rewind on Pause ................................ 63
8. General Settings 64
8.1. Playlist ..................................... 64
8.2. File View .................................... 64
8.3. Database .................................... 66
8.4. Display ..................................... 66
8.5. System ...................................... 69
8.5.1. Battery ................................. 69
8.5.2. Disk ................................... 69
8.5.3. Limits .................................. 70
8.5.4. Use Shortcuts Menu Instead of Quick Screen ............ 70
8.5.5. Car Adapter Mode ........................... 70
8.5.6. Button Light Timeout ......................... 71
8.5.7. Button Light Brightness ........................ 71
8.5.8. Keyclick ................................. 71
8.5.9. Touchpad ................................ 71
The Rockbox manual (version 3.14) Toshiba Gigabeat F and X Series

Contents 6
8.5.10. Advanced Key Lock .......................... 72
8.6. Startup/Shutdown ............................... 72
8.6.1. Start Screen ............................... 72
8.6.2. Idle Poweroff .............................. 73
8.6.3. Sleep Timer ............................... 73
8.7. Bookmarking .................................. 73
8.8. Automatic resume ............................... 75
8.9. Language .................................... 76
8.10. Voice ....................................... 76
8.11. Hotkey ...................................... 78
9. Theme Settings 79
10.Time and Date 81
11.Plugins 82
11.1. Games ...................................... 82
11.1.1. 2048 ................................... 83
11.1.2. Blackjack ................................ 84
11.1.3. Boomshine ............................... 85
11.1.4. BrickMania ............................... 85
11.1.5. Bubbles ................................. 86
11.1.6. Chessbox ................................ 87
11.1.7. Chopper ................................. 89
11.1.8. Clix ................................... 90
11.1.9. Codebuster ............................... 91
11.1.10.Dice ................................... 91
11.1.11.Doom .................................. 92
11.1.12.Flipit .................................. 94
11.1.13.Goban .................................. 95
11.1.14.Invadrox .................................100
11.1.15.Jackpot .................................101
11.1.16.Jewels ..................................102
11.1.17.Maze ...................................102
11.1.18.MazezaM ................................103
11.1.19.Minesweeper ..............................104
11.1.20.Pacbox .................................105
11.1.21.Pegbox .................................107
11.1.22.Pong ...................................108
11.1.23.Puzzles .................................109
11.1.24.Reversi .................................110
11.1.25.Robotfindskitten ............................110
11.1.26.Rockblox ................................111
11.1.27.Rockblox1d ...............................112
The Rockbox manual (version 3.14) Toshiba Gigabeat F and X Series

Contents 7
11.1.28.Sliding Puzzle ..............................113
11.1.29.Snake ..................................114
11.1.30.Snake 2 .................................115
11.1.31.Sokoban .................................116
11.1.32.Solitaire .................................118
11.1.33.Spacerocks ...............................119
11.1.34.Star ...................................120
11.1.35.Sudoku .................................121
11.1.36.Superdom ................................122
11.1.37.Wormlet .................................124
11.1.38.Xobox ..................................127
11.1.39.XWorld .................................127
11.2. Demos ......................................128
11.2.1. Bounce .................................128
11.2.2. Credits .................................129
11.2.3. Cube ...................................129
11.2.4. Demystify ................................130
11.2.5. FFT ...................................131
11.2.6. Fire ...................................131
11.2.7. Fractals .................................132
11.2.8. Logo ...................................133
11.2.9. Matrix ..................................133
11.2.10.Mosaique ................................134
11.2.11.Oscilloscope ...............................135
11.2.12.PictureFlow ...............................136
11.2.13.Plasma .................................138
11.2.14.Rocklife .................................138
11.2.15.Snow ...................................139
11.2.16.Starfield .................................140
11.2.17.VU meter ................................141
11.3. Viewers .....................................141
11.3.1. Shortcuts ................................142
11.3.2. Chip-8 Emulator ............................143
11.3.3. Frotz ...................................144
11.3.4. Image Viewer ..............................145
11.3.5. Lua scripting language .........................146
11.3.6. Midiplay .................................147
11.3.7. MPEG Player ..............................147
11.3.8. MP3 Encoder ..............................149
11.3.9. Rockboy .................................150
11.3.10.Search ..................................151
11.3.11.Shopper .................................151
11.3.12.Sort ...................................152
11.3.13.Speedread ................................153
The Rockbox manual (version 3.14) Toshiba Gigabeat F and X Series

Contents 8
11.3.14.Text Viewer ...............................154
11.3.15.Theme Remove .............................159
11.3.16.VBRfix .................................160
11.3.17.ZXBox ..................................161
11.4. Applications ...................................163
11.4.1. Alarm Clock ..............................163
11.4.2. Battery Benchmark ..........................163
11.4.3. Calculator ................................165
11.4.4. Calendar ................................166
11.4.5. Chess Clock ...............................167
11.4.6. Clock ..................................168
11.4.7. Dict ...................................171
11.4.8. Disk Tidy ................................171
11.4.9. Keybox .................................172
11.4.10.Lamp ..................................172
11.4.11.Lrcplayer ................................173
11.4.12.Main Menu Configuration .......................175
11.4.13.md5sum .................................176
11.4.14.Metronome ...............................176
11.4.15.One-Time Password Client ......................179
11.4.16.Advanced Settings ...........................180
11.4.17.Periodic Table .............................180
11.4.18.Random Folder Advance Configuration ...............181
11.4.19.Resistor Calculator ...........................181
11.4.20.Rockpaint ................................182
11.4.21.Stats ...................................185
11.4.22.Stopwatch ................................186
11.4.23.Text Editor ...............................186
12.Advanced Topics 188
12.1. Customising the User Interface ........................188
12.1.1. Customising The Main Menu .....................188
12.1.2. Getting Extras .............................188
12.1.3. Loading Fonts .............................188
12.1.4. Loading Languages ...........................189
12.1.5. Changing Filetype Colours ......................189
12.1.6. Loading Backdrops ...........................190
12.1.7. UI Viewport ..............................191
12.2. Configuring the Theme .............................191
12.2.1. Themeing – General Info .......................191
12.2.2. Themes – Create Your Own ......................192
12.2.3. Info Viewport (SBS only) .......................195
12.2.4. Additional Fonts ............................195
The Rockbox manual (version 3.14) Toshiba Gigabeat F and X Series

Contents 9
12.3. Managing Rockbox Settings ..........................198
12.3.1. Introduction to .cfg Files .......................198
12.3.2. Specifications for .cfg Files ......................198
12.3.3. The Manage Settings menu ....................199
12.4. Firmware Loading ...............................200
12.4.1. Using ROLO (Rockbox Loader) ....................200
12.5. Optimising battery runtime ..........................200
12.5.1. Display backlight ............................200
12.5.2. Display power-off ............................200
12.5.3. Anti-Skip Buffer ............................200
12.5.4. Replaygain ...............................201
12.5.5. Peak Meter ...............................201
12.5.6. Audio format and bitrate .......................201
12.5.7. Sound settings .............................201
A. File formats 202
A.1. Supported file formats .............................203
B. Audio and metadata formats 204
B.1. Supported audio formats ............................204
B.1.1. Lossy Codecs ..............................204
B.1.2. Lossless Codecs .............................205
B.1.3. Other Codecs ..............................206
B.1.4. Codec featureset ............................207
B.2. Supported metadata tags ...........................208
B.2.1. Featureset for generic metadata tags .................208
B.2.2. Featureset for codec specific metadata ................209
B.2.3. Limitations of metadata handling ...................209
C. Album Art 210
C.1. Limitations ...................................210
C.2. Where to put album art ............................210
D. Theme Tags 212
D.1. Status Bar ....................................212
D.2. Hardware Capabilities .............................212
D.3. Information from the track tags ........................213
D.4. Viewports ....................................213
D.5. Additional Fonts ................................214
D.6. Misc Coloring Tags ...............................214
D.7. Power Related Information ..........................214
D.8. Information about the file ...........................215
D.9. Playlist/Song Info ...............................216
D.10.Playlist Viewer .................................216
The Rockbox manual (version 3.14) Toshiba Gigabeat F and X Series

Contents 10
D.11.Runtime Database ...............................217
D.12.Sound (DSP) settings .............................217
D.13.Hold .......................................217
D.14.Virtual LED ..................................218
D.15.Repeat Mode ..................................218
D.16.Playback Mode .................................218
D.17.Current Screen .................................218
D.18.List Title (.sbs only) .............................219
D.19.Changing Volume ................................220
D.20.Settings .....................................220
D.21.Images ......................................221
D.21.1.How to display the album art .....................222
D.22.Alignment and language direction .......................223
D.23.Conditional Tags ................................224
D.24.Subline Tags ..................................224
D.25.Time and Date .................................225
D.26.Text Translation ................................225
D.27.Bar Tags .....................................225
D.27.1.Options .................................226
D.28.Other Tags ...................................227
E. Config file options 228
F. Menu Overview 233
G. User feedback 234
G.1. Bug reports ...................................234
G.1.1. Rules for submitting new bug reports ................234
G.2. Feature ideas ..................................234
G.2.1. Rules for submitting a new feature idea ...............234
G.2.2. Features we will not implement ....................235
H. Credits 236
I. Licenses 240
I.1. GNU Free Documentation License ......................240
I.2. The GNU General Public License .......................248
The Rockbox manual (version 3.14) Toshiba Gigabeat F and X Series