SanDisk Sansa Clip v2 Manual

SanDisk Sansa Clip v2 Manual

Rockbox firmware manual
Table of Contents

Advertisement

Quick Links

The Rockbox Manual
for
Sansa Clip v2
rockbox.org
April 30, 2017

Advertisement

Table of Contents
loading

Summary of Contents for SanDisk Sansa Clip v2

  • Page 1 The Rockbox Manual Sansa Clip v2 rockbox.org April 30, 2017...
  • Page 2 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 Sansa Clip v2 (version 3.14)
  • Page 3: Table Of Contents

    4.1.2. Context Menu ......24 The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 4: Contents

    ........47 The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 5: Contents

    8.5.4. Car Adapter Mode ......67 The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 6: Contents

    ........91 The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 7 12.3.2. Chip-8 Emulator ......120 The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 8: Contents

    13.1.3. Loading Fonts ......156 The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 9: Contents

    ....... . 178 The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 10: Contents

    ..... . 205 I.2. The GNU General Public License ..... . . 213 The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 11: Introduction

    To search the list archives simply use the search field that is located on the left side of the website. Furthermore, you can ask on IRC. The The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 12: Naming Conventions And Marks

    “Go” box at the top of the page. Links to wiki pages are also indicated by the symbol in front of the page name. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 13: Installation

    2.1. Before Starting Supported hardware versions. The Clip v2 is available in multiple versions, and you need to make sure which you have by checking the Sandisk firmware version number under Settings Info. The v1 firmware is named 01.xx.xx, while the v2 firmware begins with 02.
  • Page 14: Automated Installation

    The mountpoint indicates the location of the player in your filesystem. On Windows, this is the drive letter the player gets assigned, on other systems this is a path in the filesystem. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 15: Manual Installation

    1. Download your chosen version of Rockbox from the links in the previous section. 2. Connect your player to the computer via USB in MSC mode as described in the manual that came with your player. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 16: Bootloader Installation From Windows

    4. Copy the output file (“patched.bin” in the example given above) to the root of the device and rename it to the same name as the OF file you downloaded earlier (“m30pa.bin” above). The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 17: Bootloader Installation From Mac Os X And Linux

    – download a Rockbox build as detailed above, and unzip the build to the root directory of your player as in the manual installation stage. If your unzip program asks you whether to overwrite files, choose the “Yes to all” option. The new build will be The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 18: Uninstalling Rockbox

    Rockbox manually you can still use Rockbox Utility for uninstallation but will not be able to do this selectively. 2.5.2. Manual Uninstallation Copy an unmodified original firmware to your player, and then reboot into the Sandisk firmware. See section 3.1.3 (page 20) for more information.
  • Page 19: Quick Start

    On the right hand panel is a two-way button that acts as Volume Down when pressed on the bottom, and Volume Up when pressed on the top. Immediately above this button is the headphone socket. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 20: Turning The Player On And Off

    (page 38)). To browse the files on your player, select Files (see section (page 23)), and to browse in a view that is based on the meta-data of your audio files, select ID3 Tags, Vorbis comments, etc. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 21: Basic Controls

    file. Also there are some actions that do not apply to the current file but refer to the screen from which the context menu gets called. One example is the playback menu, which can be called using the context menu from within the WPS. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 22: Customising Rockbox

    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 effects, such as Select. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 23: Browsing And Playing

    Note: The File Browser allows you to manipulate your files in ways that are not available within the Database Browser. Read more about Database in section (page 26). The remainder of this section deals with the File Browser. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 24: File Browser Controls

    The Context Menu contains the following options (unless otherwise noted, each option pertains both to files 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 Sansa Clip v2 (version 3.14)
  • Page 25 file does not already exist it will be created in the root directory. Note that if you create a shortcut to a file, Rockbox will not open it upon selecting, but simply bring you to its location in the File Browser. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 26: Virtual Keyboard

    (ID3v1, ID3v2, Vorbis Comments, Apev2, etc.) in your audio files, Rockbox builds and maintains a database of the music files on your player and allows you to browse them by Artist, Album, Genre, Song Name, etc. The criteria the The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 27: Initializing The Database

    Directory Cache is enabled. Thus, an update using Update now may take a long time. Unlike Initialize Now, the Update Now function does not remove runtime database information. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 28: Using The Database

    There is no option to turn off database completely. If you do not want to use it just do not do the initial build of the database and do not load it to RAM. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 29: While Playing Screen

    In contrast to all other items, the status bar is always at the top of the screen. (Scrolling) path and filename of the current song. The ID3 track name. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 30: Wps Key Controls

    Long Submenu Show current Playlist. Power + Right Skip to the next directory. or Short Right + Long Right Power + Left or Skip to the previous directory. Short Left + Long Left The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 31: Peak Meter

    Show Indices. This toggles display of the line numbering for the playlist Track Display. This toggles between filename only and full path for playlist entries The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 32 This info is known as meta data and is stored in audio file formats to keep information on artist, album etc. To access this screen, press Long Select to access the WPS Context Menu and select Show Track Info. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 33 100%. However, the rate, pitch and speed information will be stored in any bookmarks you may create (see section (page 71)) and will be restored upon playing back those bookmarks. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 34: Working With Playlists

    Insert and Queue is that the Queue option removes the song from the playlist once it has been played, and the Insert option does not. 4.4.2. Creating playlists Rockbox can create playlists in four different ways. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 35: Adding Music To Playlists

    Playlist command in the Playlists menu found in the Main Menu. The created playlist will be named root.m3u8 and saved in the root of your player’s disk. 4.4.3. Adding music to playlists Adding music to a dynamic playlist Figure 4.5.: The Playlist Submenu The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 36 Recursively Insert Directories setting to Yes if you would like Playlist Rockbox to include tracks in subdirectories as well as tracks in the currently-selected directory. Dynamic playlists are saved so resume will restore them exactly as they were before shutdown. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 37: Modifying Playlists

    When loading a playlist from disk it will replace the current dynamic playlist. Through the Playlist catalogue The Playlist catalogue offers a shortcut to all playlists in your player’s specified playlist directory. It can be used like the File Browser. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 38: The Main Menu

    Play Select the previous option in the menu. Inside a setting,decrease the value or choose previous option. Select or Right Select option. Left Exit menu or setting, or move to parent menu. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 39: Recent Bookmarks

    (page 71) for more details on configuring bookmarking in Rockbox. 5.4. Files Browse the files on your player (see section (page 23)). 5.5. Database Browse by the meta-data in your audio files (see section (page 26)). The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 40: Now Playing/Resume Playback

    The details of this menu are covered in detail in section (page 78). 5.7.6. Manage Settings The Manage Settings option allows the saving and re-loading of user configuration settings, browsing the hard drive for alternate firmwares, and finally resetting your The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 41: Recording

    Adjust selected setting. Select Start recording. While recording: pause recording (press again to continue). Power Exit Recording Screen. While recording: Stop recording. Long Submenu Open Recording Settings (see sec- tion (page 78)). The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 42: Fm Radio

    Switch between SCAN and PRESET mode. Select Open a list of radio presets. You can view all the presets that you have, and switch to the station. Long Select Display the FM radio settings menu. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 43: Playlists

    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 different plugins is to be found in section (page 83). The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 44: System

    5.14. Shortcuts This menu item is a container for user defined shortcuts to files, folders or settings. With a shortcut, The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 45 The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 46 “Add to shortcuts”. A reboot is needed for manual changes to shortcuts.txt to be applied. Shortcuts can be manually removed by selecting the one you wish to remove and pressing Long Select. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 47: Sound Settings

    To set a volume limit, select a volume from the list and the maximum volume will be limited to the selected value all over the system. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 48: Treble

    0%. Values above 100% will progressively remove components in one channel that is also present in the other. This has the effect of widening the stereo field. A value of 100% will leave the stereo field unaltered. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 49: Crossfeed

    fine-tuned to provide a virtual speaker placement suited to ones preference. Beware that the crossfeed function is capable of making the audio distort if you choose settings which result in a too high output level. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 50: Equalizer

    Rockbox’s parametric EQ is composed of up to ten different bands: Band 0: Low shelf filter. The low shelf filter boosts or lowers all frequencies below a The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 51 Moves to the previous EQ band. Submenu Moves to the next EQ band. Select Toggles the cursor among the three pa- rameters (gain, centre frequency, Q) for the selected EQ band Power Exits the graphic EQ screen. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 52: Dithering

    It is worth noting that the effects of dithering and noise shaping are very subtle, and not easily noticable. Rockbox uses highpass triangular distribution noise as the dithering noise source, and a third order noise shaper. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 53: Timestretch

    This allows listening to the quiet sections of dynamic material in noisy environments while preventing sudden loud sections from being overbearing. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 54 “pumping.” Instead, the gain is allowed to return to normal at the chosen rate. Release Time is the time for the gain to recover by 10 dB. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 55: Playback Settings

    To set the Start Point (A) press Power + Left. Setting the End Point (B) is done accordingly using Power + Right. To reset the markers press Power + Play. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 56: Play Selected First

    Manual Track Skip then crossfade will be active either when shuffle is set to Yes or the track is manually skipped. If set to Always, tracks will always crossfade into one another. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 57: Replaygain

    7.8. Replaygain This allows you to control the replaygain function. The purpose of replaygain is to adjust the volume of the music played so that all songs (or albums, depending on your The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 58: Track Skip Beep

    Random feature requires you to first generate a folder list via the Random Folder Advance Configuration plugin (see section 12.4.19 (page 152)). Note: You must have the Repeat option set to No for Auto-Change Directory to function properly. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 59: Constrain Auto-Change

    The Skip to Outro option changes the behaviour so that the buttons skip to just before the end of the track, so that the last few seconds are played before the next track. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 60: Prevent Track Skipping

    Hermite polynomial resampler. Note: For best quality and battery life, select the sampling rate used by your audio. This is typically 44.1kHz. Note: Opus files are always 48kHz. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 61: General Settings

    Sort Files. This option controls how Rockbox sorts files. All of the options for Sort Directories are available in this option. In addition, there is a By type option which sorts files alphabetically by their type (such as .mp3) then alphabetically within each type. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 62 Follow Playlist. This option determines what directory the File Browser displays first. If Follow Playlist is set to Yes, when you enter the File Browser from the WPS, you will find yourself in the same directory as the currently playing file. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 63: Database

    When disabled the first keypress will also perform its appropriate action. Selective Backlight This option allows some selected actions in While Playing Screen and FM screen to not turn on the backlight in order to save power. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 64 Long Right/Left. Setting this option to Yes will keep the list entries at their fixed positions and allow them to be scrolled out of view, whereas No will only scroll those entries which surpass the right margin. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 65 (dB) setting are -40 dB for minimum and 0 dB for maximum. Recommended values for Linear display are 0 and 100%. Note that -40 dB is approxi- mately 1% in linear value, but if you change the minimum setting in linear The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 66: System

    Glyphs To Cache. This sets the default memory allocation size for fonts in unique glyphs. This should be set to the number of unique language glyphs and punctu- ation marks that are frequently displayed. The default is 250. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 67: Use Shortcuts Menu Instead Of Quick Screen

    Keyclick repeats. This setting turns keyclick repeats On and Off. If set to On, the keyclicks will be repeated when you hold down a button. If set to Off, you will hear only one click. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 68: Advanced Key Lock

    There are different modes which provide different functionality. Switching modes back and forth is done by pressing the Power and Long Power keys, respectively. The following modes are available: The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 69 Browser. This mode lets you control a web browser (e.g. Firefox). It uses the player’s keys to navigate through the web page and different tabs, navigate through history, and to control zoom. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 70: Startup/Shutdown

    Recording. Start the player in the recording screen (recording does not start automati- cally). FM Radio. Go to the radio screen and start playing. Recent Bookmarks. Show the list of recent bookmarks as described in section (page 71). Bookmarking needs to be enabled. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 71: Idle Poweroff

    Note: Bookmarking only works when tracks are launched from the file browser, and does not work for tracks launched via the database. In addition, they do not work with dynamic playlists. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 72 Unique Only Add each new bookmark to the list of recently used bookmarks, but only keep one bookmark from the current directory or playlist; any previous entries are removed. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 73: Automatic Resume

    Automatic resume. This option enables or disables automatic resume globally. When Rockbox detects that the database (which is needed for this feature) has not been initialized yet, it asks whether it should be initialized right away. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 74: Language

    They are then announced as “Directory 1”, “Directory 2” etc. Off. No attempt will be made to speak directory names. You can use pre-generated .talk clips to have directory names spoken properly, but you must enable this explicitly (see below). The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 75 Announce Battery Level. When this option is enabled the battery level is announced when it falls under 50%, 30% and 15%. VoiceHowto for more details on configuring speech support in Rockbox. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 76: Theme Settings

    Volume Display. Controls whether the volume is displayed as a graphic or a nu- meric value on the Status Bar. If you select a numeric display, volume is displayed in decibels. See section (page 47) for more on the volume set- ting. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 77 Line Selector Type. This option allows you to select which type of line selector to use. Pointer. A small arrow to the left of the menu text. Bar (inverse). A bar with inverted foreground and background colour. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 78: Recording Settings

    Note: The 11.025 kHz setting is not available when using MPEG Layer 3 format. 10.4. Source Choose the source of the recording. The options are: Microphone and FM Radio. For more information on recording from the radio see section (page 42). The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 79: Channels

    10.9. Clear Recording Directory Resets the location where the recorded files are saved to the root of your player’s drive. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 80: Clipping Light

    With this setting you have to start the recording manually and the trigger only stops the recording according to the stop condition. The setting -inf sets the trigger to the absolute minimum. This setting only makes sense when you The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 81 By specifying a short presplit gap you still can split the recording into separate tracks whenever the trigger start condition is met. More information can be found at VolumeTriggeredRecording. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 82: Time And Date

    Alarm Wake Up Screen: This option controls what the player does when it is woken up by the alarm. Time Format: Choose 12 or 24 hour clock. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 83: Plugins

    Note: On players with a small screen tiles with a value greater than 1000 are shortened to “1k”, “2k” and so forth (k is the abbreviation of kilo, which – in computer talk – means a multiple of 1024). The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 84: Blackjack

    This is a game coded in Lua that’s a clone of http://www.yvoschaap.com/chainrxn/. It is a rather basic game, but probably a good way to show off some of Lua’s features in Rockbox. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 85: Brickmania

    Immediately fires another ball. Flip Flip left / right movement. Action Left / Right Volume Down / Moves the paddle Volume Up Select / Play Release the ball / Fire Power Open menu / Quit The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 86: Bubbles

    After that, you can scroll back and forth through the moves of the game. If the menu is invoked while in the viewer, the user is allowed to select a new match from the same file or quit the game. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 87: Chopper

    Dice is a simple dice rolling simulator. Select number and type of dice to roll in a menu and start by choosing “Roll Dice”. The result is shown as individual numbers as well as the total of the rolled dice. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 88: Doom

    It has the following entries: Game. Select which (official) wad to launch Addon. Select which unofficial addon wad to launch (From /.rockbox/doom/addons directory) Demos. Select which demo file to play on game start The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 89 Screen Size. Shrink or Enlarge the displayed portion of the game Gamma. Change the brightness (Gamma) of the game Sound Volume. Change the sound, music and system volume Note: In game music is not currently supported The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 90: Flipit

    The aim is to end up with a screen containing tokens of only one colour. Action Play / Submenu Move the cursor / Left / Right Home Flip Home+Left Shuffle Home+Right Solve Home+Select Solve step by step Power Quit the game The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 91: Goban

    file first then your changes will be lost permanently. The /sgf/gbn_def.sgf file is also the file loaded if another is not selected. The information panel which displays the current move number may also contain these markers: The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 92 Options. Open the Options Menu. Context Menu. Open the Context Menu which allows you to set play modes and other tools. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 93 Note: variations which don’t start with a move are not visible in this way. Disable Idle Poweroff? Enable this if you do not want the player to turn off after a certain period of inactivity (depends on your global Rockbox settings). The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 94 To remove a label, click on it until it cycles through the allowed letters and disappears. Add/Edit Comment. Add or edit a comment at the current node. Done. Go back to the previous screen. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 95: Jackpot

    In puzzle mode the aim of the game is to connect the puzzles, by skillfully swapping pairs of jewels. Action Left/Right/ Move the cursor around the jewels Play/Submenu Select Select a jewel Power Menu The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 96: Maze

    You start the game with three lives. Luckily, there are checkpoints at levels four and eight. Action Play, Submenu, Move Character Left, Right Power Menu 12.1.16. Minesweeper Figure 12.13.: Minesweeper plugin The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 97: Pegbox

    Play, Submenu, to move around Left, Right Select to choose peg Home to restart level Volume Up to go up a level Volume Down to go down a level Power to quit The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 98: Pong

    Figure 12.16.: “Cube” from Puzzles WARNING! Image not found Figure 12.17.: “Map” from Puzzles “Puzzles” is a port of Simon Tatham’s Portable Puzzle Collection. For documenta- tion on the games included, please visit (http://www.chiark.greenend.org.uk/~sgtatham/ puzzles/). The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 99: Reversi

    For every ten lines completed, the game level increases, making the blocks fall faster. If the pile of blocks reaches the ceiling, the game is over. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 100: Rockblox1D

    Includes one picture puzzle. You can also use the sliding puzzle plugin as a viewer for supported image types, to turn your own pictures into a puzzle. Key controls: The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 101: Snake

    Action Play / Submenu Move snake / Left / Right Select Toggle Play/Pause Go to the plugin’s menu 12.1.26. Snake 2 Figure 12.22.: Snake 2 – The Snake Strikes Back The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 102: Sokoban

    Sokoban may be used as a viewer for viewing saved solutions and playing external level sets with the .sok extension. Level sets should be in the standard Sokoban text format or RLE (Run Length Encoded). For more information about the level format, http://sokobano.de/wiki/index.php?title=Level_format The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 103: Solitaire

    Microsoft’s inclusion of the the game in every version of Windows. Though popular, the odds of winning are rather low, perhaps one in thirty hands. For the full set of rules to the game, and other interesting information visit http: //www.solitairecentral.com/rules/Klondike.html The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 104: Spacerocks

    Once in a while, a UFO will appear – shoot this for extra points. Action Select Shoot Play Thrust Left/ Right Turn left/right Submenu Teleport Home Pause game Power Quit The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 105: Star

    Figure 12.27.: Sudoku Sudoku in Rockbox can act as both a plugin and a viewer. When starting Sudoku from the Browse Plugins menu, a random game will be generated automatically, and an The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 106 Long Power Quit Some places where can you can find .ss files: Simple Sudoku (Advanced Puzzle Packs 1 and 2 located near the bottom of that page): http://www.angusj.com/sudoku/ Kjell’s Sudoku generator/solver: http://kjell.haxx.se/sudoku/ The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 107: Wormlet

    And it doesn’t help anyway: the other worm isn’t hurt by the bite. It will go on creeping happily and eat all the food you left on the table. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 108 Wormed: The worm tried to eat another worm or even itself. That’s why it is dead now. Making traps for other players with a worm is a good way to get them out of the game. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 109: Xobox

    In this cinematic, award winning platform game by Éric Chahi, you must evade capture and do your best to escape an alien planet. After an experiment goes awry the hero must team up with an unlikely ally, when they both become fugitives on another world. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 110: Demos

    Moves to next/previous option Right / Left Increases/decreases option value Select Toggles Scroll mode Power or Long Exits bounce demo Power Available options are: Xdist/Ydist. The distance to X axis and Y axis respectively The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 111: Credits

    Submenu Cycle draw mode Right / Left Select axis to adjust Volume Down / Change speed/angle (speed can not be Volume Up changed while paused) Power Quit 12.2.4. Demystify Figure 12.32.: Demystify The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 112: Fft

    Fire is a demo displaying a fire effect. Action Play / Submenu Increase / decrease number of flames Left Toggle flame type Right Toggle moving flames Power Quit 12.2.7. Fractals Figure 12.34.: Fractals: Mandelbrot set The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 113: Logo

    Increase / decrease speed on the y-axis Power or Long Quit Power 12.2.9. Matrix This plugin is a visual demo resembling the scrolling code from “The Matrix” (https: //en.wikipedia.org/wiki/The_Matrix). 12.2.10. Mosaique Figure 12.35.: Mosaique The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 114: Oscilloscope

    Toggle whether to scroll or not Long Select Toggle drawing orientation Play Pause the demo Volume Up / Increase / decrease volume Volume Down Right / Left Increase / decrease speed Power Exit demo The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 115: Pictureflow

    Enter menu Power Exit PictureFlow Main Menu Go to WPS. Leave PictureFlow and enter the while playing screen. Playback Control. Control music playback from within the plugin. Settings. Enter the settings menu. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 116: Plasma

    12.2.13. Plasma Figure 12.38.: Plasma Plasma is a demo displaying a 80’s style retro plasma effect. Action Play / Submenu Increase / decrease Frequency Power / Long Exit Power The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 117: Rocklife

    This demo replicates snow falling on your screen. If you love winter, you will love this demo. Or maybe not. Press Power or Long Power to quit. 12.2.16. Starfield Figure 12.40.: Starfield Starfield simulation (like the classic screensaver). The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 118: Vu Meter

    “playing” the associated file. Viewers are stored in the /.rockbox/rocks/viewers/ directory. Note: Some viewer plugins can only be used by selecting the Open With... option from the Context Menu (see section 4.1.2 (page 24)). The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 119: Shortcuts

    file or do with it whatever you want. The file will not be “played” automatically. If the .link file contains only one entry no list will be shown, you will directly jump to that location. The file shortcuts.link in the root directory is an exception. After The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 120: Chip-8 Emulator

    (that way, several Chip8 keys can be pressed using only one Rockbox key). For example, a file containing the single line: Code 0122458469ABCDEF would correspond to the following non-default mappings: 2, 6 8, 7 4, 8 The default keymappings are: Chip8 Off The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 121: Frotz

    A Beginner’s Guide to Playing Interactive Fiction: http://www.microheaven.com/ IFGuide/ Action Play Display keyboard to enter text Select Press enter Power Open Frotz menu (not available at MORE prompts) Long Power Quit The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 122: Image Viewer

    Note: Progressive scan and other unusual JPEG files are not supported, and will result in various “unsupported xx” messages. Processing could also fail if the image is too big to decode which will be explained by a respective message. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 123: Lua Scripting Language

    .mid or .midi extension in the file browser to start playback. Action Volume Up/ Volume up/ Volume down Volume Down Right/ Left Skip 3 seconds forward/ backward Play Pause/Resume playback Power Stop playback and quit The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 124: Mpeg Player

    Quit mpegplayer Exit the plugin. Main Menu Settings Open Settings submenu – see below. Resume playback Return to playback screen. Quit mpegplayer Exit the plugin. Settings Menu Display Options Open Display Options submenu – see below. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 125 Dithering (default: force off) Use the Dithering setting or force audio dithering off. See this page in the Rockbox wiki for information on how to encode your videos to the supported format. PluginMpegplayer The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 126: Mp3 Encoder

    Rockboy is a Nintendo Game Boy and Game Boy Color emulator for Rockbox based on the gnuboy emulator. To start a game, open a ROM file saved as .gb or .gbc in the file browser. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 127: Search

    40 characters) and save the file as <name>.shopper. If you want to separate the items you can do so by creating categories, which are prepended with ‘#’. To open a .shopper file just “play” it from the file browser. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 128: Sort

    This plugin takes a file and sorts it in ascending alphabetical order. Case is ignored. This is useful for ordering playlists generated by the Create Playlist menu option (see section 5.10 (page 43)). The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 129: Text Viewer

    (Latin 1). ISO-8859-7 (Greek), ISO-8859-8 (Hebrew), CP1251 (Cyrillic), ISO-8859-11 (Thai), CP1256 (Arabic), ISO-8859-9 (Turkish), ISO-8859- 2 (Latin Extended), CP1250 (Central European), SJIS (Japanese), GB- 2312 (Simple Chinese), KSX-1001 (Korean), BIG5 (Traditional Chinese), The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 130 Horizontal Submenu for horizontal scrolling settings. Scrollbar Toggle the horizontal scrollbar for the current mode. If the file fits on one screen, there is no scrollbar and this setting has no effect. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 131 Show Playback Menu Display the playback menu to allow control of the currently play- ing music without leaving the plugin. Select Bookmark Select a saved bookmark. In the screenshot below, the “*” denotes the current page. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 132: Theme Remove

    Remove Options. This menu specifies which items are removed if Remove Theme is selected in the menu. One of the following options can be chosen for each setting. The Rockbox manual (version 3.14) Sansa Clip v2...
  • Page 133: Vbrfix

    Note: VBRfix can only run when music is turned off (since it uses the same memory as the player) and can take a while to complete if run on big files. 12.3.16. ZXBox Figure 12.46.: ZXBox The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 134 Options. Map Keys To Kempston. Controls whether the player’s buttons should sim- ulate a “Kempston” joystick or some assigned keys of the Spectrum keyboard. Display Speed. Toggle displaying the emulation speed (in percent). The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 135: Applications

    First select a track and play it, then launch the “alarmclock” plugin. The plugin pauses the playback. Enter a 24h-time (e.g. 13:58) and set the alarm. Music playback will resume when the set time is reached. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 136: Battery Benchmark

    U USB powered. Only for targets that support this. A “U” will indicate if the unit was using the USB port for power at the time of the measurement. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 137: Calculator

    Action Left / Right / Move around the keypad Play / Submenu Select Select a button Home Delete last entered digit or clear after cal- culation Long Select Calculate Power Quit The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 138: Calendar

    12.4.5. Chess Clock Figure 12.49.: Chess Clock The chess clock plugin is designed to simulate a chess clock, but it can be used in any kind of game with up to ten players. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 139 “ROUND UP!” is shown (press NEXT to continue). When the total time is up for a player the message “TIME UP!”is shown. The player will then be removed from the timer. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 140: Clock

    Backlight Choose whether to disable the backlight, use the user’s timeout setting, or keep the backlight on. Idle Poweroff Toggle Idle Poweroff. Note: This setting is not saved to disk. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 141 Circle mode, if enabled, draws empty and full circles, instead of zeros and ones. For help on reading http://en.wikipedia.org/wiki/Binary_numeral_system binary, please visit: The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 142: Dict

    Warning: Be careful when you use custom entries as you could accidentally delete important files. Available Options All selects all Linux, OS X, and Windows files. None deselects all file options. Linux selects Linux files. Default files are .dolphinview, .d3lphinview, and .Trash-*/. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 143: Keybox

    Lamp is a simple plugin to use your player as a lamp (flashlight, torch). You get an empty screen with maximum brightness. Action Select Toggle the button light Power or Long Exit to menu Power The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 144: Lrcplayer

    2. For each of the above directories, the plugin searches for a subdirectory named “Lyrics”. 3. Finally, the plugin will search as above, but within a directory called “/Lyrics”. The name of this directory can be customized, see below. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 145 Show Statusbar. Show / hide the statusbar. Display Title. Show / hide the track title. Display Time. Show / hide the current time. Backlight Force On. Do not turn off the backlight while displaying the lyrics. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 146: Main Menu Configuration

    Move Item down Swap the selected menu item with the next one Load Default Configuration Discards all customization Exit Save your changes to the configuration file and exit the plugin You can leave the plugin without saving by pressing Left. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 147: Md5Sum

    Parts can have these properties: finite or infinite duration in bars (navigation only jumps to the beginning of infinite parts), differing meters (4/4, 3/4, 6/8, etc., default 4/4), The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 148 “part I” , 12 bars long, in 3/4 meter with a tempo of 133 quarter beats per minute. Tempo changes are indicated by specifying a tempo range and the acceleration in one of these ways: The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 149 4 120-90 # changing tempo from 120 to 90 break: 2 1/4 90 # 2 1/4 bars at 90 rolling: 2 6/8 90 # 2 6/8 at same tempo (quarters!) The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 150: One-Time Password Client

    You may type anything you wish, but it should be memorable. It will then prompt you for the Base32-encoded secret. Most services will provide this to you directly, but some may only provide you with a QR code. In these cases, you The Rockbox manual (version 3.14) Sansa Clip v2...
  • Page 151: Advanced Settings

    (e.g. A, A#, B, etc.) The frequency will also be displayed. This may be a great assistance when tuning a musical instrument. Action Power Open menu Long Power Exit The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 152: Random Folder Advance Configuration

    Folder List Editor Keys Action Select or Right Delete selected folder Long Select Bring up the context menu which allows you to remove the selected folder or its entire folder tree Left Exit The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 153: Resistor Calculator

    This function produces safe estimates, but use your own judgement when using these output values. Power rating and displayed resistance are rounded up to the nearest common value. 12.4.21. Stats Figure 12.52.: The stats-plugin The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 154: Stopwatch

    Move the selection bar to the line you want to edit. Edit the highlighted text line or insert a new one using the Item Menu. When finished editing exit the Text Editor. You’ll be shown a list of save options. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 155 Note: When you have not changed the file the Text Editor will quit immediately. Action Select or Right Edit Line / Select Character Left Exit / Abort Editing Home Show Item Menu Long Select Delete Line The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 156: Advanced Topics

    File Browser. If you want a font to be loaded automatically every time you start up, it must be located in the /.rockbox/fonts directory and the filename must be at most 24 characters long. You can browse the fonts in /.rockbox/fonts under The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 157: Loading Languages

    This displays the menu starting at 15px from the left of the screen and 20px from the top of the screen. It is 100px wide and 150px high. The font is defined in the theme .cfg file or in the Theme Settings menu. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 158: Configuring The Theme

    Note: Keep in mind that your player’s resolution is 128 64 1 (with the last number giving the colour depth in bits) when designing your own WPS, or if you use a WPS designed for another target. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 159 %Vl(’identifier’,...) This tag preloads a viewport for later display. ‘identifier’ is a single lowercase letter (a-z) and the ‘. . . ’ parameters use the same logic as the %V tag explained above. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 160: Info Viewport (Sbs Only)

    %Fl(’id’,filename,glyphs) ‘id’ is the number you want to use in viewport declarations, 0 and 1 are reserved and so can’t be used. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 161 Items on a line are broken into sublines with the semicolon ‘;’ character. The display time for each subline defaults to 2 seconds unless modified by using the ‘%t’ tag to The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 162 (not displayed) when that condition is met. Using Images You can have as many as 52 images in your WPS. There are various ways of displaying images: 1. Load and always show the image, using the %x tag The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 163: Managing Rockbox Settings

    See section 13.3.2 (page 164) below for an explanation of the format for configuration files. See section 13.3.3 (page 164) for an explanation of how to create, edit and load configuration files. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 164: Specifications For .Cfg Files

    filename fixed.cfg. 13.3.3. The Manage Settings menu The Manage Settings menu can be found in the Main Menu. The Manage Set- tings menu allows you to save and load .cfg files. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 165: Firmware Loading

    13.5.1. Display backlight The active backlight consumes a lot of power. Therefore choose a setting that disables the backlight after timeout (for setting Backlight see section (page 63)). Avoid The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 166: Replaygain

    In general all kinds of sound processing will need more CPU time and therefore consume more power. The less sound processing you use, the better it is for the battery runtime (for options see section (page 47)). The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 167: A. File Formats

    Appendix A. File formats The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 168: Supported File Formats

    .sansa Text File Display the text file using the text .txt viewer plugin Voice file Allow Rockbox to speak menus .voice While Playing Screen Load the new WPS display config- .wps uration The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 169: Audio And Metadata Formats

    Dialogic telephony type .vox Windows Media Audio Standard .wma, .wmv, .asf Windows Media Audio Professional .wma, .wmv, .asf Note: AAC-HE profiles might not play in realtime on all devices due to CPU perfor- The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 170: Lossless Codecs

    DVI ADPCM (IMA ADPCM) 2/3/4/5 bit, Dialogic OKI AD- PCM, YAMAHA ADPCM, Adobe SWF ADPCM Wavpack Note: Free Lossless Audio multichannel tracks may not play in realtime on all devices due to CPU performance requirements. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 171: Other Codecs

    Atari SAP .sap Sound Interface Device Progress .sid seek use subtracks instead of seconds. SPC700 .spc Note: NSF and VGM might not play in realtime on all devices due to CPU performance requirements. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 172: Codec Featureset

    Boy Sound Format, AY Sound Chip Music, Hudson Entertainment System Sound, For- mat, MSX Konami Sound System and SMS/GG/CV Sound Format use subtracks instead of seconds, whereas each subtrack equals a second. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 173: Supported Metadata Tags

    Disc (string or number) Track (string or number) Year (string or number) Composer (string) Comment (string) Albumartist (string) Grouping (string) Note: Embedded album art for ASF is limited to pictures of maximum 64 KB size. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 174: Featureset For Codec Specific Metadata

    2. Only one tag type is supported for each audio format. 3. Overall there are 900 bytes available to load metadata strings. 4. The maximum size of each metadata item (e.g. Artists) is limited to 240 bytes. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 175: Album Art

    (a list in braces means that those file extensions are tried in that order): 1. embedded (JPEG images in ID3v2 or MP4 tags only) 2. ./filename.{jpeg,jpg,bmp} 3. ./albumtitle.{jpeg,jpg,bmp} 4. ./cover.{jpeg,jpg,bmp} 5. ./folder.jpg 6. /.rockbox/albumart/albumartist-albumtitle.{jpeg,jpg,bmp} 7. ../albumtitle.{jpeg,jpg,bmp} 8. ../cover.{jpeg,jpg,bmp} The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 176 If no album artist is set, artist will be used instead. See AlbumArt in the wiki for programs that will help you automate the process of putting album art on your player. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 177: Theme Tags

    When used conditionally, the “true” branch is completely ignored if it does not apply. Example: %?cc<%cH:%cM|No clock detected> The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 178: Information From The Track Tags

    Set the Info Viewport to use the viewport called label, as %VI(’label’) declared with the previous tag. Draw this viewport on the backdrop layer. D.5. Additional Fonts Description %Fl(’id’,filename) See section 13.2.4. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 179: Misc Coloring Tags

    “p” if the charger is connected (only on targets that can charge batteries) “c” if the unit is currently charging the battery (only on tar- gets that have software charge control or monitoring) Remaining time of the sleep timer (if it is set) The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 180: Information About The File

    %d(1) is “Isola”, %d(2) is “Kent” and %d(3) is “Rock”. These tags, when written with the first letter capitalized (e.g. %Fn or %D(2)), produce the information for the next file to be played. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 181: Playlist/Song Info

    10 seconds if no number is specified. %?pE(7)<in the last 7 seconds of track|in the rest of the track> Current playback pitch D.10. Playlist Viewer Description Display the playlist viewer in the current viewport. %Vp(start,code to render) The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 182: D.11.Runtime Database

    Crossfade setting, in the order: Off, Auto Skip, Man Skip, Shuffle, Shuffle and Man Skip, Always ReplayGain value (x.y dB). used conditional, Replaygain type use: %?rg<Off|Track|Album|TrackShuffle|AlbumShuffle|No tag> D.13. Hold Description “h” if the main unit keys are locked The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 183: D.14.Virtual Led

    Play status, 0-4, in the order: Stop, Play, Pause, Fast For- ward, Rewind, Recording, Recording paused, FM Radio play- ing, FM Radio muted Example: %?mp<Stop|Play|Pause|Ffwd|Rew|Rec|Rec pause|FM|FM pause> D.17. Current Screen Description The current screen, 1-20, in the order shown below The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 184: D.18.List Title (.Sbs Only)

    %?Lt<%Lt> to display the title within the viewport. If %Lt is present anywhere in the .sbs, then the %Vi viewport will not show the title. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 185: D.19.Changing Volume

    Draw a bar using from the setting. See section D.28 (page 190) %St(...) for details. Examples: 1. As a simple tag: %St(skip length) 2. As a conditional: %?St(eq enabled)<Eq is enabled|Eq is disabled> The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 186: D.21.Images

    9-patch images are bitmaps split into 9 segments where the four corners are unscaled, the four middle sections are scaled along one axis and the middle section is scaled on both axis. n: image ID Examples: The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 187: D.22.Fm Radio

    They need to be in either .bmp or .jpg format, and the radio must be in preset mode and tuned to a preset (and not recording) in order for them to be shown. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 188: D.23.Alignment And Language Direction

    %and(tag1, tag2, parameters are true.., tagN) Logical “or” operator. Will be evaluate to true if any of the %or(tag1, tag2, tag parameters are true.., tagN) Examples of the %if tag: The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 189: D.25.Subline Tags

    2-digit year 4-digit year Capital AM/PM Lowercase am/pm Weekday name Month name Day of week from 1 to 7, 1 is Monday Day of week from 0 to 6, 0 is Sunday The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 190: D.27.Text Translation

    – draw a preloaded image under the bar. The full image will be displayed and must be the same size as the bar. This must be followed by the label of the desired image. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 191: D.29.Other Tags

    – tag to get number – OPTIONAL. if this is present it will assume the substring is a number so it can be used with conditionals. (i.e %cM). 0 is the first conditional option The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 192 (given that the text is displayed; see conditionals above). You can specify up to ten scrolling lines. Scrolling lines can not contain dynamic content such as timers, peak meters or progress bars. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 193: Config File Options

    0 to 2500 scroll step devise a way to get ranges pixels from config-*.h screen scroll step devise a way to get ranges pixels from config-*.h Screen Scrolls Out Of on, off View The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 194 files in playlist 1000 - 32000 max files in dir 50 - 10000 lang /path/filename.lng /path/filename.wps autocreate bookmarks off, on autoload bookmarks off, on off, on most-recent-bookmarks The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 195 0 to 7 crossfade fade out delay 0 to 7 crossfade fade in duration 0 to 15 The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 196 1 to 126 peak meter hold off, 200ms, 300ms, 500ms, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 30, 1min The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 197 0:05, 0:10, 0:15, 0:30, 1:00, h:mm 2:00, 4:00, 6:00, 8:00, 16:00, 24:00 pre-recording time off, 1 to 30 rec path /path/to/dir force fm mono off, on The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 198: Menu Overview

    Appendix F. Menu Overview F. Menu Overview include an overview of the menu structure here The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 199: User Feedback

    2. Check that the feature has not already been implemented. Download the latest current/daily build and/or search the mail list archive. 3. Check that the feature is possible to implement (see section G.2.2 (page 200)). The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 200: Features We Will Not Implement

    Re- member, DRM achieves part of its security through obscurity, and publishing the keys necessary to decrypt DRM’d media would essentially render it useless. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 201: Credits

    Tat Tang Toshi- lore Huw Smith Garrett Derner hiko Itoh David J. Song Jeong Taek Barry McIntosh Leslie Donald- Anders Kagerin Peter D’Hoye Lee Pilgrim Zakk Roberts Ben Basha Brandon Low Nathan The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 202 Andrew Cupper Thilo-Alexander ulea Peter Harley Max Kel- Ginkel Adam Gashlin Robert Kukla Alexander Eickhoff Ken Faz- David Quesada Jared Stafford zone David Bishop Hein-Pieter Martin Hensel Stéphane Doyon van Braam Przemysław Hołubowski The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 203 Denes Balatoni Hughes Laurent Gautier Simon Wallace Eric Lassauge François Zhukovsky Daniel Kluz Phinit- Dinel Francesco Rigoni Joël Puik nun Chanasabaeng Tse-Hsien Chiang Klaas Bosteels Teruaki Kawashima Szymon Dziok Domenico Di Misa The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 204 The Fabother World team Postolati Stanislav Chizhik Desu (Fabien Sanglard and others) Rozen Olivier Kaloudoff Kessia sgt-puzzles team (Simon Tatham and Pinheiro Jean-Louis Biasini Lorenzo others) Miori James Hunt Artur Juraszek The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 205: Licenses

    Any member of the public is a licensee, and is addressed as “you”. You accept the license if you copy, modify or distribute the work in a way requiring permission under copyright law. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 206 A section “Entitled XYZ” means a named subunit of the Document whose title ei- The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 207 Transparent copy of the Document, free of added material. If you use the latter option, you must take reasonably prudent steps, when you begin The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 208 Modified Version as given on the Title Page. If there is no section Entitled “History” in the Document, create one stating the title, year, authors, and publisher of the Document as given The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 209 The author(s) and publisher(s) of the Document do not by this License give permission to use their names for publicity for or to assert or imply endorsement of any Modified Version. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 210 Cover Texts may be placed on covers that bracket the Document within the aggregate, or the electronic equivalent of covers if the Document is in electronic form. Otherwise they must appear on printed covers that bracket the whole aggregate. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 211 To use this License in a document you have written, include a copy of the License in the document and put the following copyright and license notices just after the title page: The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 212 If your document contains nontrivial examples of program code, we recommend re- leasing these examples in parallel under your choice of free software license, such as the GNU General Public License, to permit their use in free software. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 213: The Gnu General Public License

    To prevent this, we have made it clear that any patent must be licensed for everyone’s free use or not licensed at all. The precise terms and conditions for copying, distribution and modification follow. GNU General Public License The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 214 License. (Exception: if the Program itself is interactive but does not normally print The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 215 (in either source or binary form) with the major components (compiler, kernel, and so on) of the operating system on which the executable runs, unless that component itself accompanies the executable. The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 216 Many people have made generous contributions to the wide range of software distributed through that system in The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 217 12. In no event unless required by applicable law or agreed to in writ- ing will any copyright holder, or any other party who may modify The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 218 If the program is interactive, make it output a short notice like this when it starts in an interactive mode: Gnomovision version 69, Copyright (C) <year> <name of author> Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type The Rockbox manual Sansa Clip v2 (version 3.14)
  • Page 219 If your program is a subroutine library, you may consider it more useful to permit linking proprietary applications with the library. If this is what you want to do, use the GNU Library General Public License instead of this License. The Rockbox manual Sansa Clip v2 (version 3.14)

This manual is also suitable for:

Sansa clip+

Table of Contents