The Rockbox ManualforSansa Clip+rockbox.orgAugust 3, 20152Rockboxhttp://www.rockbox.org/Open Source Jukebox FirmwareRockbox and this manual is the collaborative eort of the Rockbox team andits contributors. See the appendix for a complete list of contributors.c2003-2013 The Rockbox Team and its contributors, c2004 Christi AliceScarborough, c 2003 Jos Maria Garcia-Valdecasas Bernal & Peter Schlenker.Version rUnversioned. Built using pdfLATEX.Permission is granted to copy, distribute and/or modify this document underthe terms of the GNU Free Documentation License, Version 1.2 or any laterversion published by the Free Software Foundation; with no Invariant Sec-tions, no Front-Cover Texts, and no Back-Cover Texts. A copy of the licenseis included in the section entitled GNU Free Documentation License.The Rockbox manual(version rUnversioned directory-150803) Sansa Clip+Contents 3Contents1. Introduction 111.1. Welcome . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111.2. Getting more help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111.3. Naming conventions and marks . . . . . . . . . . . . . . . . . . . . . . . . 122. Installation 132.1. Before Starting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132.2. Installing Rockbox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132.2.1. Automated Installation . . . . . . . . . . . . . . . . . . . . . . . . 142.2.2. Manual Installation . . . . . . . . . . . . . . . . . . . . . . . . . . 152.2.3. Bootloader installation from Windows . . . . . . . . . . . . . . . . 162.2.4. Bootloader installation from Mac OS X and Linux . . . . . . . . . 162.2.5. Finishing the install . . . . . . . . . . . . . . . . . . . . . . . . . . 172.2.6. Enabling Speech Support (optional) . . . . . . . . . . . . . . . . . 172.3. Running Rockbox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172.4. Updating Rockbox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172.5. Uninstalling Rockbox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172.5.1. Automatic Uninstallation . . . . . . . . . . . . . . . . . . . . . . . 182.5.2. Manual Uninstallation. . . . . . . . . . . . . . . . . . . . . . . . . 182.6. Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183. Quick Start 193.1. Basic Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193.1.1. The players controls. . . . . . . . . . . . . . . . . . . . . . . . . . 193.1.2. Turning the player on and o. . . . . . . . . . . . . . . . . . . . . 203.1.3. Starting the original rmware. . . . . . . . . . . . . . . . . . . . . 203.1.4. Putting music on your player . . . . . . . . . . . . . . . . . . . . . 203.1.5. The rst contact . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203.1.6. Basic controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213.1.7. Basic concepts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213.2. Customising Rockbox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213.3. USB Charging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224. Browsing and playing 234.1. File Browser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234.1.1. File Browser Controls . . . . . . . . . . . . . . . . . . . . . . . . . 244.1.2. Context Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24The Rockbox manual(version rUnversioned directory-150803) Sansa Clip+Contents 44.1.3. Virtual Keyboard . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264.2. Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264.2.1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264.2.2. Initializing the Database . . . . . . . . . . . . . . . . . . . . . . . . 274.2.3. The Database Menu . . . . . . . . . . . . . . . . . . . . . . . . . . 274.2.4. Using the Database . . . . . . . . . . . . . . . . . . . . . . . . . . 284.3. While Playing Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294.3.1. WPS Key Controls . . . . . . . . . . . . . . . . . . . . . . . . . . . 304.3.2. Peak Meter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314.3.3. The WPS Context Menu . . . . . . . . . . . . . . . . . . . . . . . 314.4. Working with Playlists. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 344.4.1. Playlist terminology . . . . . . . . . . . . . . . . . . . . . . . . . . 344.4.2. Creating playlists . . . . . . . . . . . . . . . . . . . . . . . . . . . . 344.4.3. Adding music to playlists . . . . . . . . . . . . . . . . . . . . . . . 354.4.4. Modifying playlists. . . . . . . . . . . . . . . . . . . . . . . . . . . 374.4.5. Saving playlists. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 374.4.6. Loading saved playlists . . . . . . . . . . . . . . . . . . . . . . . . 375. The Main Menu 385.1. Introducing the Main Menu . . . . . . . . . . . . . . . . . . . . . . . . . . 385.2. Navigating the Main Menu . . . . . . . . . . . . . . . . . . . . . . . . . . 385.3. Recent Bookmarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 395.4. Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 395.5. Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 395.6. Now Playing/Resume Playback. . . . . . . . . . . . . . . . . . . . . . . . 405.7. Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405.7.1. Sound Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405.7.2. Playback Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . 405.7.3. General Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405.7.4. Theme Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405.7.5. Recording Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . 405.7.6. Manage Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405.8. Recording . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 415.8.1. While Recording Screen . . . . . . . . . . . . . . . . . . . . . . . . 415.9. FM Radio. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 425.10. Playlists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 435.11. Plugins . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 435.12. System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 445.13. Quick Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 445.14. Shortcuts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 456. Sound Settings 476.1. Volume . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 476.2. Bass . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47The Rockbox manual(version rUnversioned directory-150803) Sansa Clip+Contents 56.3. Volume Limit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 476.4. Treble . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 486.5. Balance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 486.6. Channels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 486.7. Stereo Width . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 486.8. Crossfeed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 496.9. Equalizer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 506.10. Dithering . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 526.11. Timestretch. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 536.12. Haas Surround . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 536.13. Perceptual Bass Enhancement . . . . . . . . . . . . . . . . . . . . . . . . . 536.14. Auditory Fatigue Reduction. . . . . . . . . . . . . . . . . . . . . . . . . . 536.15. Compressor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 537. Playback Settings 557.1. Shue. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 557.2. Repeat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 557.3. Play Selected First . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 567.4. Fast-Forward/Rewind . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 567.5. Fade on Stop/Pause . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 567.6. Party Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 567.7. Crossfade . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 567.8. Replaygain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 577.9. Track Skip Beep . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 587.10. Auto-Change Directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . 587.11. Constrain Auto-Change . . . . . . . . . . . . . . . . . . . . . . . . . . . . 597.12. Last.fm Log. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 597.13. Cuesheet Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 597.14. Skip Length. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 597.15. Prevent Track Skipping . . . . . . . . . . . . . . . . . . . . . . . . . . . . 607.16. Rewind Before Resume . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 607.17. Rewind on Pause . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 607.18. Frequency. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 608. General Settings 618.1. Playlist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 618.2. File View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 618.3. Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 638.4. Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 638.5. System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 658.5.1. Disk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 658.5.2. Limits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 668.5.3. Use Shortcuts Menu Instead of Quick Screen . . . . . . . . . . . . 668.5.4. Car Adapter Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . 66The Rockbox manual(version rUnversioned directory-150803) Sansa Clip+Contents 68.5.5. Keyclick. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 678.5.6. USB Hide Internal Drive . . . . . . . . . . . . . . . . . . . . . . . . 678.6. Startup/Shutdown . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 678.6.1. Start Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 678.6.2. Idle Powero . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 688.6.3. Sleep Timer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 688.7. Bookmarking . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 688.8. Automatic resume . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 708.9. Language . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 718.10. Voice . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 719. Theme Settings 7410. Recording Settings 7610.1. Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7610.2. Encoder Settings (MP3 only) . . . . . . . . . . . . . . . . . . . . . . . . . 7610.3. Frequency. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7610.4. Source . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7610.5. Channels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7710.6. Mono Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7710.7. File Split Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7710.8. Prerecord Time. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7710.9. Clear Recording Directory. . . . . . . . . . . . . . . . . . . . . . . . . . . 7710.10.Clipping Light . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7810.11.Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7811. Time and Date 8012. Plugins 8112.1. Games. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8112.1.1. 2048 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8112.1.2. Blackjack . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8212.1.3. BrickMania . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8212.1.4. Bubbles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8312.1.5. Chessbox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8412.1.6. Chopper . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8512.1.7. Dice . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8512.1.8. Doom. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8512.1.9. Flipit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8712.1.10.Goban. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8812.1.11.Jackpot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9212.1.12.Jewels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9212.1.13.MazezaM. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9312.1.14.Minesweeper . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94The Rockbox manual(version rUnversioned directory-150803) Sansa Clip+Contents 712.1.15.Pegbox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9412.1.16.Pong . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9512.1.17.Reversi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9512.1.18.Robotndskitten . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9612.1.19.Rockblox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9612.1.20.Rockblox1d. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9712.1.21.Sliding Puzzle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9712.1.22.Snake . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9812.1.23.Snake 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9812.1.24.Sokoban. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9912.1.25.Solitaire. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10012.1.26.Spacerocks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10112.1.27.Star . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10212.1.28.Sudoku . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10212.1.29.Wormlet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10412.1.30.Xobox. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10612.1.31.XWorld . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10612.2. Demos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10712.2.1. Bounce . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10712.2.2. Credits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10812.2.3. Cube . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10812.2.4. Demystify. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10812.2.5. Fire . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10912.2.6. Fractals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10912.2.7. Logo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11012.2.8. Mosaique . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11012.2.9. Oscilloscope . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11112.2.10.PictureFlow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11112.2.11.Plasma . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11312.2.12.Rocklife . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11312.2.13.Snow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11412.2.14.Stareld. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11412.2.15.VU meter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11512.3. Viewers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11512.3.1. Shortcuts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11612.3.2. Chip-8 Emulator . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11712.3.3. Frotz . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11812.3.4. Image Viewer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11912.3.5. Lua scripting language . . . . . . . . . . . . . . . . . . . . . . . . . 12012.3.6. Midiplay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12012.3.7. MPEG Player . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12112.3.8. MP3 Encoder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12312.3.9. Rockboy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12312.3.10.Search. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124The Rockbox manual(version rUnversioned directory-150803) Sansa Clip+Contents 812.3.11.Shopper . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12412.3.12.Sort . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12412.3.13.Text Viewer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12512.3.14.Theme Remove. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12812.3.15.VBRx . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12912.3.16.ZXBox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12912.4. Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13112.4.1. Alarm Clock . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13112.4.2. Battery Benchmark . . . . . . . . . . . . . . . . . . . . . . . . . . 13212.4.3. Calculator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13312.4.4. Calendar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13412.4.5. Chess Clock . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13412.4.6. Clock . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13612.4.7. Disk Tidy. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13812.4.8. Keybox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13812.4.9. Lamp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13912.4.10.Lrcplayer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13912.4.11.md5sum. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14212.4.12.Metronome . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14212.4.13.Periodic Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14512.4.14.Pitch Detector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14512.4.15.Random Folder Advance Conguration . . . . . . . . . . . . . . . 14612.4.16.Resistor Calculator . . . . . . . . . . . . . . . . . . . . . . . . . . . 14712.4.17.Stats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14712.4.18.Stopwatch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14812.4.19.Text Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14813. Advanced Topics 15013.1. Customising the User Interface . . . . . . . . . . . . . . . . . . . . . . . . 15013.1.1. Customising The Main Menu . . . . . . . . . . . . . . . . . . . . . 15013.1.2. Getting Extras . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15013.1.3. Loading Fonts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15013.1.4. Loading Languages . . . . . . . . . . . . . . . . . . . . . . . . . . . 15113.1.5. UI Viewport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15113.2. Conguring the Theme . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15113.2.1. Themeing General Info . . . . . . . . . . . . . . . . . . . . . . . 15113.2.2. Themes Create Your Own . . . . . . . . . . . . . . . . . . . . . . 15213.2.3. Info Viewport (SBS only) . . . . . . . . . . . . . . . . . . . . . . . 15413.2.4. Additional Fonts . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15413.3. Managing Rockbox Settings . . . . . . . . . . . . . . . . . . . . . . . . . . 15713.3.1. Introduction to .cfg Files . . . . . . . . . . . . . . . . . . . . . . . 15713.3.2. Specications for .cfg Files . . . . . . . . . . . . . . . . . . . . . . 15713.3.3. The Manage Settings menu . . . . . . . . . . . . . . . . . . . . 158The Rockbox manual(version rUnversioned directory-150803) Sansa Clip+Contents 913.4. Firmware Loading . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15913.4.1. Using ROLO (Rockbox Loader) . . . . . . . . . . . . . . . . . . . . 15913.5. Optimising battery runtime . . . . . . . . . . . . . . . . . . . . . . . . . . 15913.5.1. Display backlight. . . . . . . . . . . . . . . . . . . . . . . . . . . . 15913.5.2. Replaygain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15913.5.3. Peak Meter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16013.5.4. Audio format and bitrate . . . . . . . . . . . . . . . . . . . . . . . 16013.5.5. Sound settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160A.File formats 161A.1. Supported le formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162B.Audio and metadata formats 163B.1. Supported audio formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163B.1.1. Lossy Codecs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163B.1.2. Lossless Codecs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164B.1.3. Other Codecs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165B.1.4. Codec featureset . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166B.2. Supported metadata tags . . . . . . . . . . . . . . . . . . . . . . . . . . . 167B.2.1. Featureset for generic metadata tags . . . . . . . . . . . . . . . . . 167B.2.2. Featureset for codec specic metadata . . . . . . . . . . . . . . . . 168B.2.3. Limitations of metadata handling . . . . . . . . . . . . . . . . . . . 168C. Album Art 169C.1. Limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169C.2. Where to put album art . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169D. Theme Tags 171D.1. Status Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171D.2. Hardware Capabilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171D.3. Information from the track tags . . . . . . . . . . . . . . . . . . . . . . . . 172D.4. Viewports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172D.5. Additional Fonts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172D.6. Misc Coloring Tags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173D.7. Power Related Information . . . . . . . . . . . . . . . . . . . . . . . . . . 173D.8. Information about the le . . . . . . . . . . . . . . . . . . . . . . . . . . . 174D.9. Playlist/Song Info . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175D.10.Playlist Viewer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175D.11.Runtime Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176D.12.Sound (DSP) settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176D.13.Hold. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176D.14.Virtual LED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177D.15.Repeat Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177D.16.Playback Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177The Rockbox manual(version rUnversioned directory-150803) Sansa Clip+Contents 10D.17.Current Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177D.18.List Title (.sbs only) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178D.19.Changing Volume . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179D.20.Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179D.21.Images . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180D.22.FM Radio. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181D.23.Alignment and language direction . . . . . . . . . . . . . . . . . . . . . . . 182D.24.Conditional Tags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182D.25.Subline Tags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183D.26.Time and Date . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183D.27.Text Translation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184D.28.Bar Tags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184D.28.1. Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184D.29.Other Tags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185E. Cong le options 187F. Menu Overview 192G.User feedback 193G.1. Bug reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193G.1.1. Rules for submitting new bug reports . . . . . . . . . . . . . . . . 193G.2. Feature ideas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193G.2.1. Rules for submitting a new feature idea . . . . . . . . . . . . . . . 193G.2.2. Features we will not implement. . . . . . . . . . . . . . . . . . . . 194H. Credits 195I. Licenses 199I.1. GNU Free Documentation License . . . . . . . . . . . . . . . . . . . . . . 199I.2. The GNU General Public License . . . . . . . . . . . . . . . . . . . . . . . 207The Rockbox manual(version rUnversioned directory-150803) Sansa Clip+Chapter 1. Introduction 111. Introduction1.1. WelcomeThisisthemanual forRockbox. Rockboxisanopensourcermwarereplacementfor a growing number of digital audio players. Rockbox aims to be considerably morefunctional and ecient than your devices stock rmware while remaining easy to useand customisable. Rockbox is written by users, for users. Not only is it free to use, itis also released under the GNU General Public License (GPL), which means that it willalways remain free both to use and to change.Rockbox has been in development since 2001, and receives new features, tweaks andxes each day to provide you with the best possible experience on your digital audioplayer. Amajorgoal of Rockboxistobesimpleandeasytouse, yetremainverycustomisable and congurable. We believe that you should never need to go through aseries of menus for an action you perform frequently. We also believe that you shouldbeabletocongurealmostanythingaboutRockboxyoucouldwant, pertainingtofunctionality. Another top priority of Rockbox is audio playback quality Rockbox,formostmodels, includesawiderrangeof soundsettingsthanthedevicesoriginalrmware. A lot of work has been put into making Rockbox sound the best it can, andimprovements are constantly being made. All models have access to a large numberof plugins, including many games, applications, and graphical demos. You can loaddierent congurations quickly for dierent purposes (e.g. a large font for in your car,dierent 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 andlenames spelled out or spoken.1.2. Getting more helpThis manual is intended to be a comprehensive introduction to the Rockbox rmware.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 Rockboxcommunity and this should be your rst port of call when looking for further help.If you cannot nd the information you are searching for on the Rockbox website thereare a number of support channels you should have a look at. You can try the Rockboxforums located at http://forums.rockbox.org/. The mailing lists are another option, andcan be found at http://www.rockbox.org/mail/. From that page you can subscribe tothe lists and browse the archives. To search the list archives simply use the search eldthat is located on the left side of the website. Furthermore, you can ask on IRC. TheThe Rockbox manual(version rUnversioned directory-150803) Sansa Clip+Chapter 1. Introduction 12main channel for Rockbox is #rockbox on irc://irc.freenode.net. Many helpful developersand users are usually around. Just join and ask your question (dont ask to ask!) ifsomeone knows the answer youll usually get an answer pretty quickly. More informationincluding IRC logs can be found at http://www.rockbox.org/irc/. We also have a webclient so that you can join the Rockbox IRC channel without needing to install additionalsoftware onto your computer.If you think you have found a bug please make sure it actually is a bug and is stillpresent in the most recent version of Rockbox. You should try to conrm that by usingthe above mentioned support channels rst. After that you can submit that issue to ourtracker. Refer to section G (page 193) for details on how to use the tracker.1.3. Naming conventions and marksWe have some conventions (especially for naming) that are intended to be consistentthroughout this manual.Manufacturer and product names are formatted in accordance with the standard rulesof English grammar, e.g. Sansa playback is currently unsupported. Manufacturer andmodel 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 younding 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. In order to

make nding notes easier each one is accompanied by an icon in the margin as here.Notes are used to mark useful information that may help you to get the most out ofRockbox.Warning: This is a warning. In contrast to notes mentioned above, a warning should

be taken more seriously. Whereas ignoring notes will not cause any serious damage,ignoring warnings could cause serious damage to your player. You really should read thewarnings, especially if you are new to Rockbox.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 haveadded some additional descriptions. If you are not blind or visually impaired you canprobably completely skip these blocks. To make this easier, there is an icon shown inthe margin on the right.Links to the wiki are abbreviated by the name of the wiki page. Those names are stilllinked so you can simply follow them like any other link in this manual. If you want toaccess a wiki page manually go tohttp://www.rockbox.org/wiki/ and type the pagename in the Go box at the top of the page. Links to wiki pages are also indicated bythe symbolin front of the page name.The Rockbox manual(version rUnversioned directory-150803) Sansa Clip+Chapter 2. Installation 132. InstallationInstalling Rockbox is generally a quick and easy procedure. However before beginningthere are a few important things to know.2.1. Before StartingDRM capability. It is possible that installation of the bootloader may lead to you per-manently losing the ability to playback les with DRM.USB connection. To transfer Rockbox to your player you need to connect it to yourcomputer. Formanual installation/uninstallation, orshouldautodetectionfailduring automatic installation, you need to know where to access the player. OnWindows this means you need to know the drive letter associated with the player.On Linux you need to know the mount point of your player. On Mac OS X youneed to know the volume name of your player.Note: The following steps require you to change the setting in Settings Sys-

tem Settings USB Mode to MSC from within the original rmware. Furthernote that all original rmware settings will be lost immediately after patching thebootloader, so you may need to correct this setting again after installing rockbox.2.2. Installing RockboxThere are two ways to install Rockbox: automated and manual. The automated way isthe preferred method of installing Rockbox for the majority of people. Rockbox Utilityis a graphical application that does almost everything for you. However, should youencounter a problem, then the manual way is still available to you.There are two separate components which need to be installed in order to run Rockbox:The Rockbox bootloader. The bootloader is the program that tells your player howto load and start other components of Rockbox and for providing the dual bootfunction. This is the component of Rockbox that is installed to the ash memoryof your Sansa.The Rockbox rmware. Unlike the Sansa rmware, which runs entirely from ash mem-ory, mostoftheRockboxcodeiscontainedinabuildthatresidesonyourplayers drive. This makes it easy to update Rockbox. The build consists of aThe Rockbox manual(version rUnversioned directory-150803) Sansa Clip+Chapter 2. Installation 14directory called .rockbox which contains all of the Rockbox les, and is locatedin the root of your players drive.Apartfromtherequiredpartstherearesomeaddonsyoumightbeinterestedininstalling.Fonts. Rockbox can load custom fonts. The fonts are distributed as a separate packageand thus need to be installed separately. They are not required to run Rockboxitself but a lot of themes require the fonts package to be installed.Themes. The appearance of Rockbox can be customised by themes. Depending on yourtaste you might want to install additional themes to change the look of Rockbox.2.2.1. Automated InstallationTo automatically install Rockbox, download the ocial installer and housekeeping toolRockbox Utility. It allows you to:Automatically install all needed components for using Rockbox (Minimal Instal-lation).Automatically install all suggested components (Complete Installation).Selectively install optional components.Install additional fonts and themes.Install voice les and generate talk clips.Uninstall all components you installed using Rockbox Utility.Prebuilt binaries for Windows, Linux and Mac OS X are available at the RockboxUtilitywiki page.When rst starting Rockbox Utility run Autodetect, found in the congurationdialog (File Congure). Autodetection can detect most player types. If autodetectionfails or is unable to detect the mountpoint, make sure to enter the correct values. Themountpoint indicates the location of the player in your lesystem. On Windows, this isthe drive letter the player gets assigned, on other systems this is a path in the lesystem.Choosing a Rockbox versionThere are three dierent versions of Rockbox available from the Rockbox website: Re-lease version, current build and archived daily build. You need to decide which one youwant to install and get the appropriate version for your player. If you select either Min-imal Installation or Complete Installation from the Quick Start tab, then RockboxUtility will automatically install the release version of Rockbox. Using the Installationtab will allow you to select which version you wish to install.The Rockbox manual(version rUnversioned directory-150803) Sansa Clip+Chapter 2. Installation 15Release. Thereleaseversionisthelateststablerelease, freeof knowncritical bugs.For a manual install, the current stable release of Rockbox is available at http://www.rockbox.org/download/.Development Build. ThedevelopmentbuildisbuiltateachchangetotheRockboxsource code repository and represents the current state of Rockbox development.This means that the build could contain bugs but most of the time is safe to use.For a manual install, you can download the current build from http://build.rockbox.org/.Archived Build. In addition to the release version and the current build, there is alsoan archive of daily builds available for download. These are built once a day fromthe latest source code in the repository. For a manual install, you can downloadarchived builds from http://www.rockbox.org/daily.shtml.Note: Because current and archived builds are development versions that change fre-

quently, they may behave dierently than described in this manual, or they may in-troduce new (and potentially annoying) bugs. Unless you wish to try the latest andgreatest features at the price of possibly greater instability, or you wish to help withdevelopment, you should stick with the release.Please now go to section 2.2.5 (page 17) to complete the installation procedure.2.2.2. Manual InstallationThe manual installation method is still available to you, should you need or desire it byfollowing the instructions below. If you have used Rockbox Utility to install Rockbox,then you do not need to follow the next section and can skip straight to section 2.2.5(page 17)Installing the rmware1. Download your chosen version of Rockbox from the links in the previous section.2. Connect your player to the computer via USBin MSC mode as described in themanual that came with your player.3. Take the.zip le that you downloaded and use the Extract all command ofyour unzip program to extract the les onto your player.Note: The entire contents of the .zip le should be extracted directly to the root of

your players drive. Do not try to create a separate directory on your player for theRockbox les! The .zip le already contains the internal structure that Rockbox needs.The Rockbox manual(version rUnversioned directory-150803) Sansa Clip+Chapter 2. Installation 16If the contents of the .zip le are extracted correctly, you will have a directory called.rockbox, which contains all the les needed by Rockbox, in the main directory of yourplayers drive.Installing the bootloaderIn order to install the bootloader, you will need to download the following les:An original rmware (OF) from http://forums.sandisk.com/t5/Clip-Clip/Sansa-Clip-Firmware-Update-01-02-15/td-p/150227Thebootloader: http://download.rockbox.org/bootloader/sandisk-sansa/clipplus/bootloader-clipplus.sansaThe version of mkamsboot for your operating system from http://download.rockbox.org/bootloader/sandisk-sansa/mkamsboot/2.2.3. Bootloader installation from Windows1. Create a folder called rbinstall on your desktop, and then extract the OF, thebootloader and mkamsboot into it.2. Open a new command prompt, and navigate to the rbinstall folder.3. Run mkamsboot.exe, passing the name of the OF and bootloader les that youdownloaded, in addition to a name for the output le.Codemkamsboot.execlppa.binbootloader-clipplus.sansapatched.binIf mkamsboot.exe does not report success, then retry or abort.4. Copy the output le (patched.bin in the example given above) to the root ofthe device and rename it to the same name as the OF le you downloaded earlier(clppa.bin above).2.2.4. Bootloader installation from Mac OS X and Linux1. Create a folder called rbinstall in your home directory, and then extract the OF,the bootloader and mkamsboot into it.2. Open a new terminal, and navigate to the rbinstall folder.3. Run mkamsboot, passing the name of the OF and bootloader les that you down-loaded, in addition to a name for the output le.Code./mkamsbootclppa.binbootloader-clipplus.sansapatched.binThe Rockbox manual(version rUnversioned directory-150803) Sansa Clip+Chapter 2. Installation 17If mkamsboot does not report success, then retry or abort.4. Copy the output le (patched.bin in the example given above) to the root ofthe device and rename it to the same name as the OF le you downloaded earlier(clppa.bin above).2.2.5. Finishing the installSafely eject the device, unplug USB and wait for the rmware update to nish. Donttry to power o the device, it will shutdown by itself after a minute.2.2.6. Enabling Speech Support (optional)If you wish to use speech support you will also need a voice le. Voice les allow Rockboxto speak the user interface to you. Rockbox Utility can install an English voice le, oryou can download it from http://www.rockbox.org/daily.shtml and unzip it to the rootof yourplayer. RockboxUtilitycanalsoaidyouinthecreationof voiceleswithdierent voices or in other languages if you have a suitable speech engine installed onyour computer. Voice menus are enabled by default and will come into eect after areboot. See section 8.10 (page 71) for details on voice settings. Rockbox Utility can alsoaid in the production of talk les, which allow Rockbox to speak le and folder names.2.3. Running RockboxWhen you turn the unit on, Rockbox should load.2.4. Updating RockboxRockbox can be easily updated with Rockbox Utility. You can also update Rockboxmanually download a Rockbox build as detailed above, and unzip the build to the rootdirectory of your player as in the manual installation stage. If your unzip program asksyou whether to overwrite les, choose the Yes to all option. The new build will beinstalled over your current build.The bootloader only changes rarely, and should not normally need to be updated.Note:IfyouuseRockboxUtilitybeawarethatitcannotdetectmanuallyinstalled

components.2.5. Uninstalling RockboxNote: The Rockbox bootloader allows you to choose between Rockbox and the original

rmware. (See section 3.1.3 (page 20) for more information.)The Rockbox manual(version rUnversioned directory-150803) Sansa Clip+Chapter 2. Installation 182.5.1. Automatic UninstallationYoucanuninstall RockboxautomaticallybyusingRockboxUtility. IfyouinstalledRockbox manually you can still use Rockbox Utility for uninstallation but will not beable to do this selectively.2.5.2. Manual UninstallationCopy an unmodied original rmware to your player, and then reboot into the Sandiskrmware. See section 3.1.3 (page 20) for more information.If you wish to clean up your disk, you may also wish to delete the .rockbox directoryand its contents. Turn the Sansa o. Turn the player back on and the original Sansasoftware will load.2.6. TroubleshootingFile Not FoundIfyoureceiveaFileNotFound fromthebootloader, thenthebootloadercannotndtheRockboxrmware. Thisisusuallyaresultof notextractingthecontentsofthe.zipletotheproperlocation, andshouldnothappen when Rockbox has been installed with Rockbox Utility.To x this, either install Rockbox with the Rockbox Utility which will take careof this for you, or recheck the Manual Install section to see where the les need tobe located.The Rockbox manual(version rUnversioned directory-150803) Sansa Clip+Chapter 3. Quick Start 193. Quick Start3.1. Basic Overview3.1.1. The players controlsThroughoutthismanual, thebuttonsontheplayerarelabelledaccordingtothepicture above. Whenever a button name is prexed by Long, a long press of approx-imately one second should be performed on that button. The buttons are described indetail in the following paragraph. Additional information for blind users is available on

the Rockbox website at BlindFAQ.Hold the player with the controls on the bottom and the screen on the top. The maincontrolsareafour-waypadwithabuttoninthecentre; pressingthiscentrebuttonfunctions as Select. Going clockwise from the top, the four-way pad contains the Play,Right, Submenu, and Left buttons. Immediately above and to the right of the four-way pad is the Home button. The Power button is on the top of the player, towardsthe right side.At the bottom of the right side of the player is a slot for microSD cards. Above thisslot on the right side is the headphone socket.On the left hand panel is a two-way button that acts as Volume Down when pressedonthebottom, andVolumeUpwhenpressedonthetop. Immediatelyabovetheswitch is a mini-USB port to connect the player to a computer.The Rockbox manual(version rUnversioned directory-150803) Sansa Clip+Chapter 3. Quick Start 203.1.2. Turning the player on and oTo turn on and o your Rockbox enabled player use the following keys:Key ActionPower Start RockboxLong Power Shutdown RockboxOn shutdown, Rockbox automatically saves its settings.3.1.3. Starting the original rmwareRockbox has a dual-boot feature. To boot into the original rmware, press and hold theLeft button while turning on the player.Note: Rockbox does not boot into the original rmware when powered by a USB con-

nection. Older versions of Rockbox do not provide USB support. If you have such aversion installed you need to manually boot into the original rmware for data transfervia USB.3.1.4. Putting music on your playerWith the player connected to the computer as an MSC/UMS device (like a USB Drive),music les can be put on the player via any standard le transfer method that you woulduse to copy les between drives (e.g. Drag-and-Drop). Files may be placed whereveryou like on the player, but it is strongly suggested NOTto put them in the /.rockboxfolder and instead put them in any other folder, e.g. /, /music or /audio. The defaultdirectory structure that is assumed by some parts of Rockbox (missing-tag fallback insome WPSes) uses the parent directory of a song as the Album name, and the parentdirectory of that folder as the Artist name. WPSes may display information incorrectly ifyour les are not properly tagged, and you have your music organized in a way dierentthan they assume when attempting to guess the Artist and Album names from yourletree. See section B.1 (page 163) for a list of supported audio formats.3.1.5. The rst contactAfter you have rst started the player, youll be presented by the Main Menu. Fromthis menu you can reach every function of Rockbox, for more information (see section 5.1(page 38)). To browse the les on your player, select Files (see section 4.1 (page 23)),andtobrowseinaviewthatisbasedonthemeta-data1of youraudioles, selectDatabase (see section 4.2 (page 26)).1ID3 Tags, Vorbis comments, etc.The Rockbox manual(version rUnversioned directory-150803) Sansa Clip+Chapter 3. Quick Start 213.1.6. Basic controlsWhen browsing les and moving through menus you usually get a list view presented.The navigation in these lists are usually the same and should be pretty intuitive. In thetree view use Submenu and Play to move around the selection. Use Select or Right toselect an item. When browsing the le system selecting an audio le plays it. The viewswitches to the While playing screen, usually abbreviated as WPS (see section 4.3(page 29). The dynamic playlist gets replaced with the contents of the current directory.This way you can easily treat directories as playlists. The created dynamic playlist canbe extended or modied while playing. This is also known as on-the-y playlist. Togo back to the File Browser stop the playback with the Power button or return tothe le browser while keeping playback running using Select. In list views you can goback one step with Left.3.1.7. Basic conceptsPlaylistsRockbox is playlist oriented. This means that every time you play an audio le, a so-called dynamic playlist is generated, unless you play a saved playlist. You can modifythe dynamic playlist while playing and also save it to a le. If you do not want to useplaylists you can simply play your les directory based. Playlists are covered in detailin section 4.4 (page 34).MenuFrom the menu you can customise Rockbox. Rockbox itself is very customisable. Alsothere are some special menus for quick access to frequently used functions.Context MenuSome views, especially the le browser and the WPS have a context menu. From the lebrowser this can be accessed with Long Select. The contents of the context menu vary,depending on the situation it gets called. The context menu itself presents you withsome operations you can perform with the currently highlighted le. In the le browserthis is the le (or directory) that is highlighted by the cursor. From the WPS this isthe currently playing le. Also there are some actions that do not apply to the currentle but refer to the screen from which the context menu gets called. One example is theplayback menu, which can be called using the context menu from within the WPS.3.2. Customising RockboxRockbox User Interface can be customised using Themes. Themes usually only aectthe visual appearance, but an advanced user can create a theme that also changes variousother settings like le view, LCD settings and all other settings that can be modiedThe Rockbox manual(version rUnversioned directory-150803) Sansa Clip+Chapter 3. Quick Start 22using .cfg les. This topic is discussed in more detail in section 13.3 (page 157). TheRockbox distribution comes with some themes that should look nice on your player.Note: Some of the themes shipped with Rockbox need additional fonts from the fonts

package, so make sure you installed them. Also, if you downloaded additional themesfrom the Internet make sure you have the needed fonts installed as otherwise the thememay not display properly.3.3. USB ChargingTo charge your player over USB, hold any button while plugging it in. This will preventit from connecting to your computer and let you continue to use it normally. Your playermust already be in Rockbox for this to function.Note: Be aware that this button may still perform its normal function, so it is recom-

mended to use a button without harmful side eects, such as Select.The Rockbox manual(version rUnversioned directory-150803) Sansa Clip+Chapter 4. Browsing and playing 234. Browsing and playing4.1. File BrowserFigure 4.1.: The le browserRockbox lets you browse your music in either of two ways. The FileBrowser letsyou navigate through the les and directories on your player, entering directories andexecuting the default action on each le. To help dierentiate les, each le format isdisplayed with an icon.TheDatabaseBrowser, on the other hand, allows you to navigate through themusic on your player using categories like album, artist, genre, etc.You can select whether to browse using the File Browser or the Database Browserby selecting eitherFiles orDatabase in theMainMenu. If you choose theFileBrowser, the Show Files setting lets you select what types of les you wish to view.See section 8.2 (page 62) for more information on the Show Files setting.Note: The FileBrowserallows you to manipulate your les in ways that are not

available within the Database Browser. Read more about Database in section 4.2(page 26). The remainder of this section deals with the File Browser.The Rockbox manual(version rUnversioned directory-150803) Sansa Clip+Chapter 4. Browsing and playing 244.1.1. File Browser ControlsKey ActionPlay/Submenu Go to previous/next item in list. If youare on the rst/last entry, the cursor willwrap to the last/rst entry.Left Go to the parent directory.Select or Right Execute the default action on the selectedle or enter a directory.Home + Select If thereisanaudioleplaying, returnto the WhilePlayingScreen (WPS)without stopping playback.Power Stop audio playback.Long Select Enter the Context Menu.Home Enter the Main Menu.Long Home SwitchtotheQuickScreen(seesec-tion 5.13 (page 44)).4.1.2. Context MenuFigure 4.2.: The Context MenuThe ContextMenu allows you to perform certain operations on les or directories.To access the Context Menu, position the selector over a le or directory and accessthe context menu with Long Select.Note: The ContextMenu is a context sensitive menu. If the ContextMenu is

invoked on a le, it will display options available for les. If the ContextMenu isinvoked on a directory, it will display options for directories.TheContextMenucontainsthefollowingoptions(unlessotherwisenoted, eachoption pertains both to les and directories):Playlist. Enters the Playlist Submenu (see section 4.4.3 (page 35)).Playlist Catalogue. Enters the Playlist Catalogue Submenu (see section 4.4.2 (page 35)).The Rockbox manual(version rUnversioned directory-150803) Sansa Clip+Chapter 4. Browsing and playing 25Rename. This function lets the user modify the name of a le or directory.Cut. Copies the name of the currently selected le or directory to the clipboard andmarks it to be cut.Copy. Copies the name of the currently selected le or directory to the clipboard andmarks it to be copied.Paste. Only visible if a le or directory name is on the clipboard. When selected it willmove or copy the clipboard to the current directory.Delete. Deletes the currently selected le. This option applies only to les, and not todirectories. Rockbox will ask for conrmation before deleting a le. Press Selectto conrm deletion or any other key to cancel.Delete Directory. Deletes the currently selected directory and all of the les and subdi-rectories it may contain. Deleted directories cannot be recovered. Use this featurewith caution!Open with. Runs a viewer plugin on the le. Normally, when a le is selected in Rock-box, Rockbox automatically detects the le type and runs the appropriate plugin.The Open With function can be used to override the default action and select aviewer by hand. For example, this function can be used to view a text le even ifthe le has a non-standard extension (i.e., the le has an extension of somethingother than .txt). See section 12.3 (page 115) for more details on viewers.Create Directory. Create a new directory in the current directory on the disk.Properties. Shows properties such as size and the time and date of the last modicationfor the selected le. If used on a directory, the number of les and subdirectorieswill be shown, as well as the total size.Set As Recording Directory. Save recordings in the selected directory.Start File Browser Here. This option allows users to set the currently selected directoryas the default start directory for the le browser. This option is not available forles.Note: If you have Auto-Change Directory and Constrain Auto-Change

enabled, thedirectoriesreturnedwill beconstrainedtothedirectoryyouhavechosen here and those below it. See section 7.11 (page 59)Add to Shortcuts. Adds a link to the selected item in the shortcuts.link le. If thele does not already exist it will be created in the root directory. Note that if youcreate a shortcut to a le, Rockbox will not open it upon selecting, but simplybring you to its location in the File Browser.The Rockbox manual(version rUnversioned directory-150803) Sansa Clip+Chapter 4. Browsing and playing 264.1.3. Virtual KeyboardFigure 4.3.: The virtual keyboardThis is the virtual keyboard that is used when entering text in Rockbox, for examplewhen renaming a le or creating a new directory. The virtual keyboard can be easilychanged by making a text le with the required layout. More information on how toachieve this can be found on the Rockbox website at LoadableKeyboardLayouts.Note: When the cursor is on the input line, Select deletes the preceding character

Key ActionLeft / Right Move the cursor on the virtual keyboard.Ifyoumoveoutofthepickerarea, youget the previous/next page of characters(if there is more than one).Play / Submenu Move the cursor on the virtual keyboard.If you move out of the picker area you getto the line edit mode.Fliptothe next page of characters (ifthere is more than one).Select Insert the selected keyboard letter at thecurrent line cursor position.Long Select Exitthevirtual keyboardandsaveanychanges.Power Exit the virtual keyboard without savingany changes.4.2. Database4.2.1. IntroductionThischapterdescribestheRockboxmusicdatabasesystem. Usingtheinformationcontainedinthetags(ID3v1, ID3v2, VorbisComments, Apev2, etc.) inyouraudioles, Rockbox builds and maintains a database of the music les on your player andallows you to browse them by Artist, Album, Genre, Song Name, etc. The criteria theThe Rockbox manual(version rUnversioned directory-150803) Sansa Clip+Chapter 4. Browsing and playing 27database uses to sort the songs can be completely customised. More information on howto achieve this can be found on the Rockbox website at DataBase.4.2.2. Initializing the DatabaseThe rst time you use the database, Rockbox will scan your disk for audio les. This cantake quite a while depending on the number of les on your player. This scan happensin the background, so you can choose to return to the Main Menu and continue to listento music. If you shut down your player, the scan will continue next time you turn it on.After the scan is nished you may be prompted to restart your player before you canuse the database.Ignoring Directories During Database InitializationYou may have directories on your player whose contents should not be added to thedatabase. Placing a le named database.ignore in a directory will exclude the les inthat directory and all its subdirectories from scanning their tags and adding them to thedatabase. This will speed up the database initialization.If a subdirectory of an ignored directory should still be scanned, place a le nameddatabase.unignoreinit. Thelesinthatdirectoryanditssubdirectorieswill bescanned and added to the database.4.2.3. The Database MenuAuto UpdateIfAuto update is set to on, each time the player boots, the databasewill automatically be updated.Initialize NowYou can force Rockbox to rescan your disk for tagged les by using theInitialize Now function in the Database Menu.Warning: Initialize Now removes all database les (removing runtimedb data

also) and rebuilds the database from scratch.Update NowUpdate now causes the database to detect new and deleted lesNote: Unlike the Auto Update function, Update Now will update the database

regardless of whether the Directory Cache is enabled. Thus, an update usingUpdate now may take a long time.UnlikeInitializeNow, theUpdateNowfunctiondoesnotremoveruntimedatabase information.Gather Runtime DataWhen enabled, rockbox will record how often and how long atrack is being played, when it was last played and its rating. This information canbe displayed in the WPS and is used in the database browser to, for example, showthe most played, unplayed and most recently played tracks.The Rockbox manual(version rUnversioned directory-150803) Sansa Clip+Chapter 4. Browsing and playing 28Export ModicationsThis allows for the runtime data to be exported to the le/.rockbox/database_changelog.txt, which backs up the runtime data in ASCIIformat. This is needed when database structures change, because new code cannotread old database code. But, all modications exported to ASCII format shouldbe readable by all database versions.Import Modications. Allows the /.rockbox/database_changelog.txt backup to beconveniently loaded into the database. If AutoUpdate is enabled this is per-formed automatically when the database is initialized.4.2.4. Using the DatabaseOncethedatabasehas beeninitialized, youcanbrowseyour musicbyArtist, Al-bum, Genre, Song Name, etc. To use the database, go to the Main Menu and selectDatabase.Note: You may need to increase the value of the MaxEntriesinFileBrowser

setting (Settings General Settings System Limits) in order to view longlists of tracks in the ID3 database browser.There is no option to turn o database completely. If you do not want to use it justdo not do the initial build of the database and do not load it to RAM.The Rockbox manual(version rUnversioned directory-150803) Sansa Clip+Chapter 4. Browsing and playing 29Tag Type Originlename string systemalbum string id tagalbumartist string id tagartist string id tagcomment string id tagcomposer string id taggenre string id taggrouping string id tagtitle string id tagbitrate numeric id tagdiscnum numeric id tagyear numeric id tagtracknum numeric id tag/lenameautoscore numeric runtime dblastplayed numeric runtime dbplaycount numeric runtime dbPm (play time -min)numeric runtime dbPs (play time - sec) numeric runtime dbrating numeric runtime dbcommitid numeric systementryage numeric systemlength numeric systemLm (track len -min)numeric systemLs (track len - sec) numeric system4.3. While Playing ScreenThe While Playing Screen (WPS) displays various pieces of information about the cur-rently playing audio le. The appearance of the WPS can be congured using WPSconguration les. The items shown depend on your conguration all items can beturned on or o independently. Refer to section D (page 171) for details on how tochange the display of the WPS.Status bar: The Status bar shows Battery level, charger status, volume, play mode,repeat mode, shue mode and clock. In contrast to all other items, the status baris always at the top of the screen.(Scrolling) path and lename of the current song.The ID3 track name.The Rockbox manual(version rUnversioned directory-150803) Sansa Clip+Chapter 4. Browsing and playing 30The ID3 album name.The ID3 artist name.Bit rate. VBR les display average bitrate and (avg)Elapsed and total time.A slidebar progress meter representing where in the song you are.Peak meter.Seesection13.2(page151) for details of customisingyour WPS(WhilePlayingScreen).4.3.1. WPS Key ControlsKey ActionVolume Up /Volume DownVolume up/down.Left Gotobeginningof track, or if pressedwhileintherstsecondsof atrack, goto the previous track.Long Left Rewind in track.Right Go to the next track.Long Right Fast forward in track.Play Toggle play/pause.Power Stop playback.Select Return to the File Browser /Database.Long Select Enter WPS Context Menu.Home Enter Main Menu.Long Home SwitchtotheQuickScreen(seesec-tion 5.13 (page 44)).Home+Select Key lock (software hold switch) on/o.Long Submenu Show current Playlist.Power + Rightor Short Right +Long RightSkip to the next directory.Power + Left orShort Left + LongLeftSkip to the previous directory.The Rockbox manual(version rUnversioned directory-150803) Sansa Clip+Chapter 4. Browsing and playing 314.3.2. Peak MeterThe peak meter can be displayed on the While Playing Screen and consists of severalindicators. For a picture of the peak meter, please see the While Recording Screen insection 5.8.1 (page 41).The bar: This is the wide horizontal bar. It represents the current volume value.The peak indicator: This is a little vertical line at the right end of the bar. It indicatesthe peak volume value that occurred recently.The clip indicator: This is a little black block that is displayed at the very right of thescale when an overow occurs. It usually does not show up during normal playbackunless you play an audio le that is distorted heavily. If you encounter clippingwhile recording, your recording will sound distorted. You should lower the gain.Note: Notethattheclipdetectionisnotveryprecise. Clippingmightoccur

without being indicated.The scale: Betweentheindicatorsoftherightandleftchannel therearelittledots.These dots represent important volume values. In linear mode each dot is a 10%mark. In dBFS mode the dots represent the following values (from right to left):0 dB, -3 dB, -6 dB, -9 dB, -12 dB, -18 dB, -24 dB, -30 dB, -40 dB, -50 dB, -60 dB.4.3.3. The WPS Context MenuLike the context menu for the File Browser, the WPS Context Menu allows youquick access to some often used functions.PlaylistThe Playlist submenu allows you to view, save, search and reshue the current playlist.These and other operations are detailed in section 4.4 (page 34). To change settings forthe PlaylistViewer press Long Select while viewing the current playlist to bringup the PlaylistViewerMenu. In this menu, you can nd the PlaylistViewerSettings.Playlist Viewer SettingsShow Icons. This toggles display of the icon for the currently selected playlist entry andthe icon for moving a playlist entryShow Indices. This toggles display of the line numbering for the playlistTrack Display. This toggles between lename only and full path for playlist entriesThe Rockbox manual(version rUnversioned directory-150803) Sansa Clip+Chapter 4. Browsing and playing 32Playlist catalogueView catalogue. This lists all playlists that are part of the Playlist catalogue. You canload a new playlist directly from this list.Add to playlist. Addsthecurrentlyplayingletoaplaylist. Selecttheplaylistyouwant the le to be added to and it will get appended to that playlist.Add to new playlist. Similar to the previous entry this will add the currently playingtrack to a playlist. You need to enter a name for the new playlist rst.Sound SettingsThis is a shortcut to the Sound Settings Menu, where you can congure volume, bass,treble, and other settings aecting the sound of your music. See section 6 (page 47) formore information.Playback SettingsThis is a shortcut to the Playback Settings Menu, where you can congure shue,repeat, party mode, skip length and other settings aecting the playback of your music.RatingThe menu entry is only shown if Gather Runtime Information is enabled. It allowsthe assignment of a personal rating value (0 10) to a track which can be displayed inthe WPS and used in the Database browser. The value wraps at 10.BookmarksThis allows you to create a bookmark in the currently-playing track.Show Track InfoFigure 4.4.: The track info viewerThis screen is accessible from the WPS screen, and provides a detailed view of all theidentityinformationaboutthecurrenttrack. Thisinfoisknownasmetadataandis stored in audio le formats to keep information on artist, album etc. To access thisscreen, press Long Select to access the WPS Context Menu and select Show TrackInfo.The Rockbox manual(version rUnversioned directory-150803) Sansa Clip+Chapter 4. Browsing and playing 33Open With...This Open With function is the same as the Open With function in the le browsersContext Menu.DeleteDelete the currently playing le. The le will be deleted but the playback of the le willnot stop immediately. Instead, the part of the le that has already been buered (i.e.read into the players memory) will be played. This may even be the whole track.PitchThe Pitch Screen allows you to change the rate of playback (i.e. the playback speedand at the same time the pitch) of your player. The rate value can be adjusted between50% and 200%. 50% means half the normal playback speed and a pitch that is an octavelower than the normal pitch. 200% means double playback speed and a pitch that is anoctave higher than the normal pitch.The rate can be changed in two modes: procentual and semitone. Initially, procentualmode is active.If youve enabled the Timestretch option in SoundSettings and have since re-booted, you can also use timestretch mode. This allows you to change the playbackspeed without aecting the pitch, and vice versa.In timestretch mode there are separate displays for pitch and speed, and each can bealtered independently. Due to the limitations of the algorithm, speed is limited to bebetween 35% and 250% of the current pitch value. Pitch must maintain the same ratioas well as remain between 50% and 200%.The value of the rate, pitch and speed is not persistent, i.e. after the player is turnedon it will always be set to 100%. However, the rate, pitch and speed information will bestored in any bookmarks you may create (see section 8.7 (page 68)) and will be restoredupon playing back those bookmarks.The Rockbox manual(version rUnversioned directory-150803) Sansa Clip+Chapter 4. Browsing and playing 34Key ActionHome Toggle pitch changing mode (cyclethrough all available modes).Play / Submenu Increase / Decrease pitch by 0.1% (in pro-centual mode) or 0.1 semitone (in semi-tone mode).Long Play / LongSubmenuIncrease / Decrease pitch by 1% (in pro-centual mode) or a semitone (in semitonemode).Left / Right Temporarilychangepitchby2%(beat-match), or modify speed (in timestretchmode).Select Reset pitch and speed to 100%.Power Leave the Pitch Screen.4.4. Working with Playlists4.4.1. Playlist terminologySome common terms that are used in Rockbox when referring to playlists:Directory. A playlist! One of the keys to getting the most out of Rockbox is under-standing that Rockbox always considers the song that it is playing to be part of aplaylist, and in some situations, Rockbox will create a playlist automatically. Forexample, if you are playing the contents of a directory, Rockbox will automaticallycreate a playlist containing all songs in it. This means that just about anythingthat is described in this chapter with respect to playlists also applies to directories.Dynamic playlist. A dynamicplaylist isa playlistthat iscreated On the y. Anytime you insert or queue tracks using the Playlistsubmenu (see section 4.4.3(page 35)), you are creating (or adding to) a dynamic playlist.Insert. InRockbox, toInsertanitemintoaplaylistmeansputtinganitemintoaplaylist and leaving it there, even after it is played. As you will see later in thischapter, Rockbox can Insert into a playlist in several places.Queue. In Rockbox, to Queue a song means to put the song into a playlist and thento remove the song from the playlist once it has been played. The only dierencebetween Insert and Queue is that the Queue option removes the song from theplaylist once it has been played, and the Insert option does not.4.4.2. Creating playlistsRockbox can create playlists in four dierent ways.The Rockbox manual(version rUnversioned directory-150803) Sansa Clip+Chapter 4. Browsing and playing 35By selecting (playing) a song from the File BrowserWhenever a song is selected from the File Browser with Select or Right, Rockboxwill automatically create a playlist containing all of the songs in that directory and startplayback with the selected song.Note: If you already have created a dynamic playlist, playing a new song will erase the

current dynamic playlist and create a new one. If you want to add a song to the currentplaylist rather than erasing the current playlist, see the section below on how to addmusic to a playlist.By using Insert and Queue functionsIf playback is stopped, the Insert and Queue functions can be used as described in4.4.3 to create a new playlist instead of adding to an existing one. This will erase anydynamic playlist.By using the Playlist catalogueThePlaylistcatalogue makes it possible to modify and create playlists that arenot currently playing. To do this select Playlist catalogue in the Context Menu.There you will have two choices, Add to playlist adds the selected track or directoryto an existing playlist and Add to a new playlist creates a new playlist containingthe selected track or directory.Note: All playlists in the Playlist catalogue are stored by default in the /Playlists

directory in the root of your players disk and playlists stored in other locations are notincluded in the catalogue. It is however possible to move existing playlists there (seesection 4.1.2 (page 24)).By using the Main MenuTocreateaplaylist containingall musiconyour player, youcanusetheCreatePlaylist command in the Playlists menu found in the MainMenu. The createdplaylist will be named root.m3u8 and saved in the root of your players disk.4.4.3. Adding music to playlistsAdding music to a dynamic playlistFigure 4.5.: The Playlist SubmenuThe Rockbox manual(version rUnversioned directory-150803) Sansa Clip+Chapter 4. Browsing and playing 36The Playlist Submenu is a submenu in the Context Menu (see section 4.1.2 (page 24)),it allows you to put tracks into a dynamic playlist. If there is no music currently play-ing, Rockbox will create a new dynamic playlist and put the selected track(s) into it.If there is music currently playing, Rockbox will put the selected track(s) into the cur-rent playlist. The place in which the newly selected tracks are added to the playlist isdetermined by the following options:Insert. Add track(s) immediately after any tracks added via the most recent Insertoperation. If no tracks have yet been added via an Insert, new tracks will beadded immediately after the current playing track. If playback is stopped a newdynamic playlist will get created with the selected tracks.Insert Next. Add track(s) immediately after current playing track, no matter what elsehas been inserted.Insert Last. Add track(s) to end of playlist.Insert Shued. Add track(s) to the playlist in a random order.Insert Last Shued. Add tracks in a random order to the end of the playlist.Queue. Queue is the same as Insert except queued tracks are deleted immediately fromthe playlist after they have been played. Also, queued tracks are not saved to theplaylist le (see section 5.10 (page 43)).Queue Next. Queue track(s) immediately after current playing track.Queue Last. Queue track(s) at end of playlist.Queue Shued. Queue track(s) in a random order.Queue Last Shued. Queue tracks in a random order at the end of the playlist.Play Next. Replaces all but the current playing track with track(s). Current playingtrack is queued.The Playlist Submenu can be used to add either single tracks or entire directoriesto a playlist. If the PlaylistSubmenu is invoked on a single track, it will put onlythat track into the playlist. On the other hand, if the Playlist Submenu is invokedon a directory, Rockbox adds all of the tracks in that directory to the playlist.Note: You can control whether or not Rockbox includes the contents of subdirectories

when adding an entire directory to a playlist. Set the Settings General Settings Playlist Recursively Insert Directories setting to Yes if you would likeRockbox to include tracks in subdirectories as well as tracks in the currently-selecteddirectory.Dynamic playlists are saved so resume will restore them exactly as they were beforeshutdown.The Rockbox manual(version rUnversioned directory-150803) Sansa Clip+Chapter 4. Browsing and playing 37Note: To view, save or reshue the current dynamicplaylist use thePlaylist sub

menu in the WPS context menu or in the Main Menu.4.4.4. Modifying playlistsReshuingReshuing the current playlist is easily done from the Playlist sub menu in the WPS,just select Reshuffle.Moving and removing tracksTo move or remove a track from the current playlist enter the PlaylistViewer byselectingViewCurrentPlaylistinthePlaylistsubmenuintheWPScontextmenu or the Main Menu. Once in the Playlist Viewer open the context menu onthe track you want to move or remove. If you want to move the track, select Move inthe context menu and then move the blinking cursor to the place where you want thetrack to be moved and conrm with Select or Right. To remove a track, simply selectRemove in the context menu.4.4.5. Saving playlistsTo save the current playlist either enter the Playlist submenu in the WPS ContextMenu (see section 4.3.3 (page 31)) and select Save Current Playlist or enter thePlaylistOptions menu in the MainMenu and select SaveCurrentPlaylist.Either method will bring you to the Virtual Keyboard (see section 4.1.3 (page 26)),enter a lename for your playlist and accept it and you are done.4.4.6. Loading saved playlistsThrough the File BrowserPlaylistles, likeregularmusictracks, canbeselectedthroughtheFileBrowser.When loading a playlist from disk it will replace the current dynamic playlist.Through the Playlist catalogueThe Playlistcatalogue oers a shortcut to all playlists in your players speciedplaylist directory. It can be used like the File Browser.The Rockbox manual(version rUnversioned directory-150803) Sansa Clip+Chapter 5. The Main Menu 385. The Main Menu5.1. Introducing the Main MenuFigure 5.1.: The main menuThe Main Menu is the screen from which all of the Rockbox functions can be accessed.Thisistherstscreen youwill seewhen startingRockbox. ToreturntotheMainMenu, press the Home button.All settings are stored on the unit. However, Rockbox does not access the ash storagesolely for the purpose of saving settings. Instead, Rockbox will save settings when itaccesses the ash storage the next time, for example when relling the music buer ornavigating through the File Browser. Changes to settings may therefore not be savedunless the player is shut down safely (see section 3.1.2 (page 20)).5.2. Navigating the Main MenuKey ActionSubmenu Select the next option in the menu.Inside a setting, increase the value orchoose next option.Play Select the previous option in the menu.Inside a setting,decrease the value orchoose previous option.Select or Right Select option.Left Exit menu or setting, or move to parentmenu.The Rockbox manual(version rUnversioned directory-150803) Sansa Clip+Chapter 5. The Main Menu 395.3. Recent BookmarksFigure 5.2.: The list bookmarks screenIf the Save a list of recently created bookmarks option is enabled then you canview a list of several recent bookmarks here and select one to jump straight to that track.Note: Bookmarking only works when tracks are launched from the le browser, and

does not currently work for tracks launched via the database. In addition, they do notcurrently work with dynamic playlists.Key ActionSubmenu Select the next bookmark.Play Select the previous bookmark.Select or Right Resume from the selected bookmark.Left Exit Recent Bookmark menu.Home Delete the currently selected bookmark.Long Select Enterthecontextmenufortheselectedbookmark.There are two options in the context menu:Resume will commence playback of the currently selected bookmark entry.Delete will remove the currently selected bookmark entry from the list.This entry is not shown in the Main Menu when the option is o (the default setting).See section 8.7 (page 68) for more details on conguring bookmarking in Rockbox.5.4. FilesBrowse the les on your player (see section 4.1 (page 23)).5.5. DatabaseBrowse by the meta-data in your audio les (see section 4.2 (page 26)).The Rockbox manual(version rUnversioned directory-150803) Sansa Clip+Chapter 5. The Main Menu 405.6. Now Playing/Resume PlaybackGo to the While Playing Screen and resume if music playback is stopped or pausedand there is something to resume (see section 4.3 (page 29)).5.7. SettingsThe Settings menu allows you to set or adjust many parameters that aect the wayyour player works. There are many submenus for dierent parameter areas. Every timeyou are setting a value of a parameter, and that value is selected from a list of somepredened available values, you can press LongSelect, and the selection cursor willjump to the default value for the parameter. You can then conrm or cancel the value.This is useful if you have changed the value of the parameter from the default to someother value and would like to restore the default value.5.7.1. Sound SettingsThe SoundSettings menu oers a selection of sound properties you may change tocustomise your listening experience. The details of this menu are covered in section 6(page 47).5.7.2. Playback SettingsThe Playback Settings menu allows you to congure settings related to audio play-back. The details of this menu are covered in section 7 (page 55).5.7.3. General SettingsThe General Settings menu allows you to customise the way Rockbox looks and theway it plays music. The details of this menu are covered in section 8 (page 61).5.7.4. Theme SettingsTheThemeSettingsmenucontainsoptionsthatcontrol thevisual appearanceofRockbox. The details of this menu are covered in section 9 (page 74).5.7.5. Recording SettingsThe Recording Settings menu allows you to congure settings related to recording.The details of this menu are covered in detail in section 10 (page 76).5.7.6. Manage SettingsThe Manage Settings option allows the saving and re-loading of user congurationsettings, browsingtheharddriveforalternatermwares, andnallyresettingyourThe Rockbox manual(version rUnversioned directory-150803) Sansa Clip+Chapter 5. The Main Menu 41player back to initial conguration. The details of this menu are covered in section 13.3(page 157).5.8. Recording5.8.1. While Recording ScreenFigure 5.3.: The while recording screenSelecting the Recording option in the Main Menu enters the Recording Screen,whilst pressing Long Select enters the Recording Settings (see section 10 (page 76)).The Recording Screen shows the time elapsed and the size of the le being recorded.A peak meter is present to allow you set gain correctly. There is also a volume setting,this will only aect the output level of the player and does not aect the recorded sound.If enabled in the peak meter settings, a counter in front of the peak meters shows thenumber of times the clip indicator was activated during recording. The counter is resetto zero when starting a new recording.The frequency and channels settings are shown in the status bar.The controls for this screen are:Key ActionSubmenu / Play Select setting.Left / Right Adjust selected setting.Select Start recording.Whilerecording: pauserecording(pressagain to continue).Power Exit Recording Screen.While recording: Stop recording.Long Submenu Open Recording Settings (see sec-tion 10 (page 76)).The Rockbox manual(version rUnversioned directory-150803) Sansa Clip+Chapter 5. The Main Menu 425.9. FM RadioFigure 5.4.: The FM radio screenThis menu option switches to the radio screen. The FM radio has the ability to rememberstation frequency settings (presets). Since stations and their frequencies vary dependingon location, it is possible to load these settings from a le. Such les should have thelename extension .fmr and reside in the directory /.rockbox/fmpresets (note thatthis directory does not exist after the initial Rockbox installation; you should create itmanually). To load the settings, i.e. a set of FM stations, from a preset le, just playit from the le browser. Rockbox will remember and use it in PRESET mode untilanother le has been selected. Some preset les are available here: FmPresets.It is also possible to record the FM radio while listening. To start recording, enter theFM radio settings menu with Long Select and then select Recording. At this point,you will be switched to the Recording Screen. Further information on Recordingcan be found in section 5.8 (page 41).Key ActionLeft, Right Change frequency in SCANmode orjumptonext/previousstationinPRE-SET mode.Long Left, LongRightSeek to next station in SCAN mode.Volume Up,Volume DownChange volume.Home Leave the radio screen with the radioplaying.Power Stop the radio and return to Main Menu.Play Mute radio playback.Submenu Switch between SCANand PRESETmode.Select Open a list of radio presets. You can viewall the presets that you have, and switchto the station.Long Select Display the FM radio settings menu.Home+Select Key lock (software hold switch) on/o.The Rockbox manual(version rUnversioned directory-150803) Sansa Clip+Chapter 5. The Main Menu 43Saving a preset: Upto64of yourfavouritestationscanbesavedaspresets. LongSelect to go to the menu, then select Add preset. Enter the name (maximumnumber of characters is 32). Press Long Select to save.Selecting a preset: Select to go to the presets list. Use VolumeUp and VolumeDown to move the cursor and then press Select or Right to select. Use Left toleave the preset list without selecting anything.Removing a preset: Select to go to the presets list. Use VolumeUp and VolumeDown to move the cursor and then press Long Select on the preset that you wishto remove, then select Remove Preset.Note: The radio will turn o when starting playback of an audio le.

5.10. PlaylistsThis menu allows you to work with playlists. Playlists can be created in three ways.Playing a le in a directory causes all the les in it to be placed in a playlist. Playlists canbe created manually by either using the Context Menu (see section 4.1.2 (page 24))or using the Playlist menu. Both automatically and manually created playlists can beedited using this menu.Create Playlist: Rockbox will create a playlist with all tracks in the current directoryand all sub-directories. The playlist will be created one directory level up fromwhere you currently are.View Current Playlist: Displays the contents of the playlist currently stored in memory.Save Current Playlist: Saves the current dynamic playlist, excluding queued tracks, tothespeciedle. If nopathisprovidedthenplaylistissavedtothecurrentdirectory.View Catalogue: Provides asimpleinterfacetomaintainseveral playlists (seesec-tion 4.4 (page 34)).5.11. PluginsWith this option you can load and run various plugins that have been written for Rock-box. There are a wide variety of these supplied with Rockbox, including several games,some impressive demos and a number of utilities. A detailed description of the dierentplugins is to be found in section 12 (page 81).The Rockbox manual(version rUnversioned directory-150803) Sansa Clip+Chapter 5. The Main Menu 445.12. SystemRockbox Info: Displays some basic system information. This is, from top to bottom,the amount of memory Rockbox has available for storing music (the buer). Thebattery status. Memory size and amount of free space on the two data volumes,this info is given separately for internal memory (Int) and for a plugged in memorycard (MSD).Credits: Display the list of contributors.Running Time: Shows the runtime of your player in hours, minutes and seconds.Running Time: Thisitemshowsthecumulativeoverall runtimeof yourplayersince you either disconnected it from charging (in Rockbox) or manually resetthis item. A manual reset is done through pressing any button, followed bypressing Select or Right.Top Time: This item shows the cumulative overall runtime of your player sinceyou last manually reset this item. A manual reset is done through pressingany button, followed by pressing Select or Right.Debug (Keep Out!): This sub menu is intended to be used only by Rockbox developers.It shows hardware, disk, battery status and other technical information.Warning: It is not recommended that users access this menu unless instructed

to do so in the course of xing a problem with Rockbox. If you think you havemessed up your settings by use of this menu please try to reset all settings beforeasking for help.5.13. Quick ScreenAlthough the Quick Screen is accessible from nearly everywhere, not just the MainMenu, it is worth mentioning here. It allows rapid access to your four favourite settings.The default settings are Shuffle (section 7 (page 55)), Repeat (section 7 (page 55))and the Show Files (section 8.2 (page 62)) options, but almost all congurable optionsin Rockbox can be placed on this screen. To change the options, navigate through themenus to the setting you want to add and press Long Select. In the menu which appearsyou will be given options to place the setting on the Quick Screen.Press Long Home to access it and Select or Home to exit. The direction buttonswill modify the individual setting values as indicated by the arrow icons. Please notethat the settings at opposite sides of the screen cycle through the available options inopposite directions. Therefore if you select the same setting at e.g. the top and bottomof the quickscreen, then pressing up and down will cycle through this setting in oppositedirections.The Rockbox manual(version rUnversioned directory-150803) Sansa Clip+Chapter 5. The Main Menu 455.14. ShortcutsThis menu item is a container for user dened shortcuts to les, folders or settings. Witha shortcut,A le can be run (i.e. a music le played, plugin started or a .cfg loaded)The le browser can be opened with the cursor positioned at a specied le orfolderA les or folders Current Playlist context menu item can be displayedA setting can be congured (any which can be added to the Quick Screen)A debug menu item can be displayed (useful for developers mostly)The current time can be spokenThe sleep timer can be conguredThe player can be turned oNote: Shortcuts into the database are not possible

Shortcuts are loaded from the le /.rockbox/shortcuts.txt which lists each itemto be displayed. Each shortcut looks like the following:Example[shortcut]type:data:name:icon:talkclip:Only type and data are required (except if type is separator in which case datais also not required).Available types are:ledata is the name of the le to runbrowsedata is the le or the folder to open the le browser atplaylist menudata is the le or the folder to open the Current Playlist context menuitem onsettingdatais thecongnameof thesettingyouwant tochange(seesectionE(page 187) for the list of the possible settings)debugdata is the name of the debug menu item to displayThe Rockbox manual(version rUnversioned directory-150803) Sansa Clip+Chapter 5. The Main Menu 46separator data is ignored; name can be used to display text, or left blank to make thelist more accessible with visual gapstimedataneedstobeeithertalktotalkthetime, orsleepXwhereXisthenumber of minutes to run the sleep timer for (0 to disable). name is required forthis shortcut type.shutdowndata is ignored; name can be used to display textIf the name/icon items are not specied, a sensible default will be used.Note: For the browse type, if you want the le browser to start inside a folder, make

sure the data has the trailing slash (i.e /Music/ instead of /Music). Without the trailingslash, it will cause the le broser to open with /Music selected instead.The le shortcuts.txt can be edited with any text editor. Most items can also beadded to it through their context menu item Add to shortcuts. A reboot is needed formanual changes to shortcuts.txt to be applied.Shortcutscanbemanuallyremovedbyselectingtheoneyouwishtoremoveandpressing Long Select.The Rockbox manual(version rUnversioned directory-150803) Sansa Clip+Chapter 6. Sound Settings 476. Sound SettingsFigure 6.1.: The sound settings screenThe sound settings menu oers a selection of sound settings you may change to customiseyour listening experience.6.1. VolumeThis setting adjusts the volume of your music. Like most professional audio gear andmanyconsumer audio