1. Manuals
  2. Brands
  3. Rockbox Manuals
  4. MP3 Player
  5. Archos Ondio 128 FM
  6. Manual

Rockbox Archos Ondio 128 FM Manual

Digital audio players
Hide thumbs
Table of Contents

Advertisement

Quick Links

Download this manual
The Rockbox Manual
for
Archos Ondio 128 FM
rockbox.org
October 20, 2008

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the Archos Ondio 128 FM and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Related Manuals for Rockbox Archos Ondio 128 FM

Summary of Contents for Rockbox Archos Ondio 128 FM

  • Page 1 The Rockbox Manual Archos Ondio 128 FM rockbox.org October 20, 2008...
  • Page 2 Open Source Jukebox Firmware Rockbox and this manual is the collaborative effort of the Rockbox team and its contributors. See the appendix for a complete list of contributors. c 2003-2008 The Rockbox Team and its contributors, c 2004 Christi Alice Scarborough, c 2003 Jos´...

  • Page 3: Table Of Contents

    ........2.3. Installing Rockbox .......

  • Page 4: Contents

    ONTENTS 4.2.3. The Database Menu ......4.2.4. Using the Database ......4.3.

  • Page 5: Contents

    ONTENTS 6.9. Super Bass ........6.10.
  • Page 6 ......10.3.5. Rockbox flash ......

  • Page 7: Contents

    ..... . . 110 11.5.4. Updating the Rockbox Image in Flash ....111 11.5.5.

  • Page 8: Contents

    ONTENTS B.11. Alignment ........119 B.12.

  • Page 9: Introduction

    fixes each day to provide you with the best possible experience on your digital audio player. A major goal of Rockbox is to be simple and easy to use, yet remain very cus- tomisable and configurable. We believe that you should never need to go through a series of menus for an action you perform frequently.

  • Page 10: Naming Conventions And Marks

    If you think you have found a bug please make sure it actually is a bug and is still present in the most recent version of rockbox. You should try to confirm that by using the above mentioned support channels first. After that you can submit that issue to our tracker.

  • Page 11: Installation

    Rockbox itself comes as a single package. There is no need to install additional soft- ware for running Rockbox. Apart from the required parts there are some addons you might be interested in in- stalling.

  • Page 12: Installing Rockbox

    Text editor. As you will see in the following chapters, Rockbox is highly configurable. In addition to saving configurations, Rockbox also allows you to create customised configuration files.

  • Page 13: Manual Installation

    Current Build. The current build is built at each source code change to the Rockbox SVN 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. You can download the current build from http://build.rockbox.org/.

  • Page 14: Enabling Speech Support (Optional)

    Rockbox has a fonts package that is available at http://www.rockbox.org/daily.shtml from the extras link in the menu on the Rockbox website. While the current builds and daily builds change frequently, the fonts package rarely changes and is therefore not included in these builds. When installing Rockbox for the first time, you should install the fonts package.

  • Page 15: Uninstalling Rockbox

    file. If you wish to clean up your disk, you may also wish to delete the .rockbox direc- tory and its contents. Turn the Archos off. Turn the player back on and the original Archos software will load.

  • Page 16: Quick Start

    ¸ Additional information for blind users is available on the Rockbox website at ZBlindFAQ. The main characteristic of the Ondio case is the dent on its lower right side which is the MMC slot. Holding the player with this slot in the described position you’ll find...

  • Page 17: Turning The Player On And Off

    files between drives (e.g. Drag ’n’ Drop). The default directory structure that is assumed by some parts of Rockbox (album art searching, WPS missing- tag fallback) is: /ArtistName/AlbumName/*.ext. See section ?? (page ??) for a list of supported audio formats.

  • Page 18: Basic Concepts

    3.1.6. Basic concepts Playlists Rockbox is playlist oriented. This means that every time you play an audio file, a so- called “dynamic playlist” is generated, unless you play a saved playlist. You can mod- ify the dynamic playlist while playing and also save it to a file. If you do not want to use playlists you can simply play your files directory based.

  • Page 19: Browsing And Playing

    4. Browsing and playing 4.1. File Browser Figure 4.1.: The file browser Rockbox lets you browse your music in either of two ways. The F lets ROWSER you navigate through the files and directories on your player, entering directories and executing the default action on each file.

  • Page 20: File Browser Controls

    4. B HAPTER ROWSING AND PLAYING 4.1.1. File Browser Controls Action Up/Down Go to previous/next item in list. If you are on the first/last entry, the cursor will wrap to the last/first entry. Left Go to the parent directory. Executes the default action on the se- Right lected file or enters a directory.

  • Page 21: Virtual Keyboard

    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 it’s location in the F ROWSER 4.1.3.

  • Page 22: Database

    Rockbox website at ZDataBase. 4.2.2. Initializing the Database The first time you use the database, Rockbox will scan your disk for audio files. This can take quite a while depending on the number of files on your player. This scan happens...

  • Page 23: The Database Menu

    files. To PDATE remove deleted files from the database you need to run U PDATE Initialize Now You can force Rockbox to rescan your disk for tagged files by using the function in the D NITIALIZE ATABASE Warning: I removes all database files (removing runtimedb data...

  • Page 24: Using The Database

    4. B HAPTER ROWSING AND PLAYING 4.2.4. Using the Database Once the database has been initialized, you can browse your music by Artist, Album, Genre, Song Name, etc. To use the database, go to the M and select D ATABASE Note: You may need to increase the value of the M setting AX FILES IN DIR BROWSER...

  • Page 25: While Playing Screen

    4. B HAPTER ROWSING AND PLAYING 4.3. While Playing Screen The While Playing Screen (WPS) displays various pieces of information about the cur- rently playing audio file. The appearance of the WPS can be configured using WPS configuration files. The items shown depend on your configuration – all item can be turned on or off independently.

  • Page 26: Wps Key Controls

    4. B HAPTER ROWSING AND PLAYING 4.3.1. WPS Key Controls Action Up / Down Volume up/down. Left Go to beginning of track, or if pressed while in the first seconds of a track, go to previous track. Long Left Rewind in track. Right Go to next track.

  • Page 27: The Wps Context Menu

    4. B HAPTER ROWSING AND PLAYING The scale: Between the indicators of the right and left channel there are little dots. 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): 0db, -3db, -6db, -9db, -12db, -18db, -24db, -30db, -40db, -50db, -60db.
  • Page 28 4. B HAPTER ROWSING AND PLAYING Playback Settings This is a shortcut to the P , where you can configure shuf- LAYBACK ETTINGS fle, repeat, party mode, study mode and other settings affecting the playback of your music. Rating The menu entry is only shown if G is enabled.

  • Page 29: Working With Playlists

    Some 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 a playlist, and in some situations, Rockbox will create a playlist automatically.

  • Page 30: Creating Playlists

    I option does not. NSERT 4.4.2. Creating playlists Rockbox can create playlists in four different ways. By selecting (“playing”) a song from the File Browser Whenever a song is selected from the F with Right, Rockbox will auto-...

  • Page 31: Adding Music To Playlists

    “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.

  • Page 32: Modifying Playlists

    LAYLIST UBMENU 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 playlists. Set the S...

  • Page 33: Helpful Hints

    It can be used like the F ROWSER 4.4.7. Helpful Hints Including subdirectories in playlists You can control whether or not Rockbox includes the contents of subdirectories when adding an entire directory to a playlists. Set the M ETTINGS LAYLIST...

  • Page 34: The Main Menu

    The M is the screen from which all of the Rockbox functions can be accessed. This is the first screen you will see when starting Rockbox. To return to the M , hold the Mode button. All settings are stored on the unit. However, Rockbox does not spin up the disk solely for the purpose of saving settings.

  • Page 35: Recent Bookmarks

    See section (page 51) for more details on configuring bookmarking in Rockbox. Note: This entry is not shown in the M when the option is off and the option is off by default.

  • Page 36: Sound Settings

    firmwares, and finally resetting your player back to initial configuration. This menu also allows the user to load different versions of the Rockbox firmware. The details of this menu are covered in section 11.3 (page 107).

  • Page 37: Fm Radio

    5. T HAPTER (page 55)). The R shows the time elapsed and the size of the file ECORDING CREEN being recorded. A peak meter is present to allow you set gain correctly. There is also a volume setting, this will only affect the output level of the player and does not affect the recorded sound.

  • Page 38: Playlist

    5. T HAPTER Action Left, Right Change frequency in SCAN mode or jump to next/previous station in PRE- SET mode Long Left, Right Seek to next station or preset in SCAN mode. Up, Down Change volume. On/Off Leave the radio screen with the radio playing.

  • Page 39: Plugins

    Warning: It is not recommended that users access this menu unless instructed to do so in the course of fixing a problem with Rockbox. If you think you have messed up your settings by use of this menu please try to reset all settings before asking for help.

  • Page 40: Sound Settings

    This setting adjusts the volume of your music. Like most professional audio gear and many consumer audio products, Rockbox uses a decibel scale where 0 dB is a refer- ence that indicates the maximum volume that the player can produce without possible distortion (clipping).

  • Page 41: Balance

    6. S HAPTER OUND ETTINGS 6.4. Balance This setting controls the balance between the left and right channels. The default, 0, means that the left and right outputs are equal in volume. Negative numbers increase the volume of the left channel relative to the right, positive numbers increase the vol- ume of the right channel relative to the left.

  • Page 42: Auto Volume

    The MDB parameters are as follows: MDB enable: This turns the MDB feature on or off. For many users this will be the only setting they need, since Rockbox picks sensible defaults for the other parameters. MDB is turned off by default.
  • Page 43 ‘loudness’ of these notes. For most users, the defaults should provide an improvement in sound quality and can be safely left as they are. For reference, the defaults Rockbox uses are: Setting Value...

  • Page 44: General Settings

    LAYBACK Shuffle Turning shuffle on will cause Rockbox to randomly re-order the playlist. Thus, to shuffle all of the audio files on the player, you first need to create a playlist con- taining all of them.
  • Page 45 If the player is knocked, shaken or jogged heavily while Rockbox is trying to read the hard drive, Rockbox might not be able to read the drive. Rockbox will retry over and over again until it succeeds, but may eventually reach the end of the memory buffer.

  • Page 46: Playlist

    , Rockbox will prompt the user about whether to include sub-directories. Warn When Erasing Dynamic Playlist. If set to Y , Rockbox will provide a warn- ing if the user attempts to take an action that will cause Rockbox to erase the current dynamic playlist. 7.3. File View The File View menu deals with options relating to how the File Browser displays files.
  • Page 47 first. B Y DATE sorts them with the newest directory first. NEWEST DATE Sort Files: This option controls how Rockbox sorts files. All of the options for S are available in this option. In addition, there is a B option IRECTORIES Y TYPE which sorts files alphabetically by their type (such as .mp3) then alphabetically...

  • Page 48: Database

    Rockbox chooses which method it should use depending of how much it has to scroll to the left. This setting lets you tell Rockbox where that limit is, expressed in percentage of the line length.
  • Page 49 7. G HAPTER ENERAL ETTINGS Status/Scrollbar: Settings related to on screen status display and the scrollbar. Scroll Bar: Enables or disables the scroll bar at the left. Status Bar: Enables or disables the status bar at the upper side. Volume Display: Controls whether the volume is displayed as a graphic or a numeric value on the Status Bar.

  • Page 50: System

    The two supported battery types are “Alkaline” or “NiMH”. 7.6.3. Idle Poweroff Rockbox can be configured to turn off power after the unit has been idle for a defined number of minutes. The player is idle when playback is stopped or paused. It is not idle while the USB or charger is connected , or while recording.

  • Page 51: Bookmarking

    (saved) playlists. They are stored next to the directory/playlist they reference. You can store multiple bookmarks for the same track. Bookmark on Stop. This option controls whether Rockbox writes a bookmark to the disk when playback is stopped. Setting this to N turns automatic bookmarking completely off.

  • Page 52: Language

    Voice Menus. This option controls the voicing of menus/settings as they are selected by the cursor. In order for this to work, a voice file must be present in the /.rockbox/langs/ directory on the player. Voice files are large and are not shipped with Rockbox by default.
  • Page 53 Announce Battery Level. When this option is enabled the battery level is announced when it falls under 50%, 30% and 15%. ZVoiceHowto for more details on configuring speech support in Rockbox. OCKBOX MANUAL RCHOS NDIO...

  • Page 54: Theme Settings

    .wps file see section 11.2 (page 103). Show Icons. Rockbox has the ability to display an icon to the left of the file in the F . For details of these icons, see section (page 113). These icons can...

  • Page 55: Recording Settings

    9. R HAPTER ECORDING ETTINGS 9. Recording Settings Figure 9.1.: The recording settings screen Note: To change the location where recordings are stored open the C ONTEXT (see section 4.1.2 (page 20)) on the directory where you want to store them in the F and select S ROWSER ECORDING...

  • Page 56: Source

    9. R HAPTER ECORDING ETTINGS standard the sound is recorded using: MPEG v1 for 48, 44.1 and 32 MPEG v2 for 24, 22.05 and 16 9.3. Source Choose the source of the recording. The options are: M , and L .

  • Page 57: Prerecord Time

    9. R HAPTER ECORDING ETTINGS 9.7. Prerecord Time This setting buffers a small amount of audio so that when the record button is pressed, the recording will begin from that number of seconds earlier. This is useful for ensuring that a recording begins before a cue that is being waited for. 9.8.
  • Page 58 9. R HAPTER ECORDING ETTINGS is set to linear the threshold is displayed as percentage.) In the peak meter at the bottom of the screen the start threshold is displayed graphically by a little triangle pointing to the right. There are two special values. The value O turns the start condition off.

  • Page 59: Plugins

    LUGINS 10. Plugins Plugins are programs that Rockbox can load and run. Only one plugin can be loaded at a time. Plugins have exclusive control over the user interface. This means you cannot switch back and forth between a plugin and Rockbox. When a plugin is loaded, you need to exit it to return to the Rockbox interface.

  • Page 60: Brickmania

    10. P HAPTER LUGINS Action In menu Mode Start new game Down Resume saved game Show high scores On/Off Quit In game Left / Right / Up / Down Enter betting amount Left Hit (Draw new card) Right Stay (End hand) Double down Down Save game...

  • Page 61: Bubbles

    10. P HAPTER LUGINS Special items Displayed Name Description Normal Returns paddle to normal. Ball dies; lose a life. Life Gain a life. Fire Allows you to shoot bricks with pad- dle. Glue Ball sticks to paddle each time it hits. Ball Immediately fires another ball.

  • Page 62: Chessbox

    10. P HAPTER LUGINS Action In menu Mode Start new game Down Resume saved game Show high scores Left+Right Select starting level On/Off Quit In game Mode Pause game Left / Right Aim the bubble Fire bubble Down Save game On/Off Exit to menu 10.1.4.

  • Page 63: Chopper

    10. P HAPTER LUGINS Keys Action Direction keys Move the cursor Mode Pick up / Drop piece Mode+On/Off Change level Long Mode Force play On/Off Show the menu 10.1.5. Chopper Navigate a cavernous maze without banging into walls, the ceiling, or the floor. How long can you fly your chopper? Action Up / Mode...

  • Page 64: Jewels

    10. P HAPTER LUGINS Flipping the colour of the token under the cursor also flips the tokens above, below, left and right of the cursor. The aim is to end up with a screen containing tokens of only one colour. Action Up / Down / Left Move the cursor...

  • Page 65: Mazezam

    10. P HAPTER LUGINS 10.1.9. MazezaM Figure 10.7.: MazezaM The goal of this puzzle game is to escape a dungeon consisting of ten “mazezams”. These are rooms containing rows of blocks which can be shifted left or right. You can move the rows only by pushing them and if you move the rows carelessly, you will get stuck.

  • Page 66: Pegbox

    10. P HAPTER LUGINS Action Up / Down / Left Move the cursor across the minefield / Right Mode Toggle flag on / off Long Mode Reveal the contents of the current square Long Display the current game status Mode+On/Off On/Off Exit the game 10.1.11.

  • Page 67: Pong

    10. P HAPTER LUGINS 10.1.12. Pong Figure 10.10.: Pong Pong is a simple two player “tennis game”. Whenever a player misses the ball the other scores. Action Left Left player up Left player down Mode Right player up Down Right player down On/Off Quit 10.1.13.

  • Page 68: Rockblox

    10.1.14. Rockblox Figure 10.12.: Rockblox Rockblox is a rockbox version of the classic falling blocks game. The aim of the game is to make the falling blocks of different shapes form full rows. Whenever a row is com- plete it will be cleared and the game score will increase. For every ten lines completed the game level increases, making the blocks fall faster.

  • Page 69: Sliding Puzzle

    10. P HAPTER LUGINS 10.1.16. Sliding Puzzle Figure 10.13.: Sliding puzzle The classic sliding puzzle game. Rearrange the pieces so that you can see the whole picture, or switch to number tiles if you like it a little easier Key controls: Action Left, Right, Up Move Tile...

  • Page 70: Snake 2

    10. P HAPTER LUGINS Action Up/Down Change levels (1 is slowest, 9 is fastest) Mode Toggle Play/Pause 10.1.18. Snake 2 Figure 10.15.: Snake 2 – The Snake Strikes Back Another version of the Snake game. Move the snake around, and eat the apples that pop up on the screen.

  • Page 71: Sokoban

    10. P HAPTER LUGINS 10.1.19. Sokoban Figure 10.16.: Sokoban The object of the game is to push boxes into their correct position in a crowded ware- house with a minimal number of pushes and moves. The boxes can only be pushed, never pulled, and only one can be pushed at a time.

  • Page 72: Solitaire

    10.1.20. Solitaire Figure 10.17.: Klondike solitaire This is the classic Klondike solitaire game for Rockbox. This is probably the best-known solitaire in the world. Many people do not even realize that other games exist. Though the name may not be familiar, the game itself certainly is. This is due in no small part to Microsoft’s inclusion of the the game in every version of Windows.

  • Page 73: Spacerocks

    10. P HAPTER LUGINS 10.1.21. Spacerocks Figure 10.18.: Spacerocks Spacerocks is a clone of the old arcade game Asteroids. The goal of the game is to blow up the asteroids and avoid being hit by them. Once in a while, a UFO will appear – shoot this for extra points.

  • Page 74: Sudoku

    Next level On/Off Exit the game 10.1.23. Sudoku Figure 10.20.: Sudoku Sudoku in Rockbox is implemented as both a plugin and a viewer. When you start Sudoku in plugin mode from the B menu, a random game will be ROWSE LUGINS generated automatically, and an estimate of its difficulty (very easy, easy, medium, hard...

  • Page 75: Wormlet

    10.1.24. Wormlet Figure 10.21.: Wormlet game Wormlet is a multi-worm game on a multi-threaded multi-functional Rockbox console. You navigate a hungry little worm. Help your worm to find food and to avoid poisoned argh-tiles. The goal is to turn your tiny worm into a big worm for as long as possible.
  • Page 76 10. P HAPTER LUGINS Action Left Turn left Right Turn right Turn Up Down Turn Down The game Use the control keys of your worm to navigate around obstacles and find food. Worms do not stop moving except when dead. Dead worms are no fun. Be careful as your worm will try to eat anything that you steer it across.
  • Page 77 10. P HAPTER LUGINS The scoreboard On the right side of the game field is the score board. For each worm it displays its status and its length. The top most entry displays the state of worm 1, the second worm 2 and the third worm 3.

  • Page 78: Xobox

    Open menu 10.2. Demos 10.2.1. Bounce Figure 10.23.: Bounce This demo is of the word “Rockbox” bouncing across the screen. In S CROLL MODE bouncing text is replaced by a different one scrolling from right to left. OCKBOX MANUAL RCHOS...

  • Page 79: Credits

    Xsane/Ysane. Changes the appearance of the bouncing. 10.2.2. Credits The credits plugin scrolls the entire list of the names of all the Rockbox contributors after displaying the Rockbox logo and version. This plugin is called when selecting from the S section of the Rockbox main menu.

  • Page 80: Demystify

    10. P HAPTER LUGINS 10.2.4. Demystify Figure 10.25.: Demystify Demystify is a screen saver like demo. Action Up / Down Increase / decrease speed Right / Left Add / remove polygon Quit On/Off 10.2.5. Fire Figure 10.26.: Fire Fire is a demo displaying a fire effect. Action Up / Down Increase / decrease number of flames...

  • Page 81: Logo

    10. P HAPTER LUGINS 10.2.6. Logo Demo showing the Rockbox logo bouncing around the screen. Action Right / Left Increase / decrease speed on the x-axis Up / Down Increase / decrease speed on the y-axis On/Off Quit 10.2.7. Mandelbrot Figure 10.27.: Mandelbrot...

  • Page 82: Mosaique

    10. P HAPTER LUGINS 10.2.8. Mosaique Figure 10.28.: Mosaique This simple graphics demo draws a mosaic picture on the screen of the player. Press On/Off to quit. 10.2.9. Oscilloscope Figure 10.29.: Oscilloscope This demo shows the shape of the sound samples that make up the music being played. Keys Action Mode...

  • Page 83: Plasma

    10. P HAPTER LUGINS 10.2.10. Plasma Figure 10.30.: Plasma Plasma is a demo displaying a 80’s style retro plasma effect. Action Up / Down Adjust frequency Quit On/Off 10.2.11. Snow Figure 10.31.: Have you ever seen snow falling? This demo replicates snow falling on your screen. If you love winter, you will love this demo.

  • Page 84: Vu Meter

    Raise Volume Lower Volume Down 10.3. Viewers Viewers are plugins which are associated with specific file extensions. They cannot be run directly but are started by “playing” the associated file. Viewers are stored in the /.rockbox/rocks/viewers/ directory. OCKBOX MANUAL RCHOS NDIO...

  • Page 85: Shortcuts

    10. P HAPTER LUGINS 10.3.1. Shortcuts The Shortcuts Plugin allows you to jump to places within the file browser without hav- ing to navigate there manually. The plugin works with .link files. A .link file is just a text file with every line containing the name of the file or the directory you want to quickly jump to.

  • Page 86: Chip-8 Emulator

    That .c8k file contains 16 characters describing the mapping from the Chip8 keyboard to the default key mapping (that way, several Chip8 keys can be pressed using only one Rockbox key). For example, a file containing the single line: 0122458469ABCDEF...

  • Page 87: Movie Player

    10.3.4. Movie Player Play movies on your player! In order to do this, movies must be in AVI format, and then converted to .RVF, Rockbox’s own video format. For more details on how to use this plugin, please see ZVideoTutorial.

  • Page 88: Sort

    10. P HAPTER LUGINS 10.3.7. 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 C menu option REATE LAYLIST (see section 5.10 (page 38)). 10.3.8.

  • Page 89: Vbrfix

    10. P HAPTER LUGINS Join joins lines. Useful for adopting the orphans that occur with e-mail style (i.e. pre-wrapped) text files. Normal breaks lines at newline characters. Wide View toggles between Narrow and Wide. Yes sets maximum column to 114. Useful for navigating large files. (Cur- rently, Wide and Join cannot be selected together.) No (Narrow) sets maximum column to the screen width.

  • Page 90: Wavplay

    filebrowser. 10.3.11. ZXBox Figure 10.35.: ZXBox ZXBox is a port of the “Spectemu” ZX Spectrum 48k emulator for Rockbox (Zproject’s homepage). To start a game open a tape file or snapshot saved as .tap, .tzx, .z80 or .sna in the file browser.
  • Page 91 ZXBox menu Vkeyboard. This is a virtual keyboard representing the Spectrum keyboard. Controls are the same as in standard Rockbox, but you just press one key instead of enter- ing a phrase. Play/Pause Tape. Toggles playing of the tape (if it is loaded).

  • Page 92: Applications

    find the benchmark output data in a file on your player /battery bench.txt. ZBatteryRuntime Please submit your results to the Rockbox wiki. How it works After you load the plug-in the operation of your player continues as normal. You can do whatever you could do before loading the plugin except loading another plugin.
  • Page 93 Level The percent level of the battery estimated by Rockbox. This is an estimation and not an accurate result. Using the real percentage (current battery voltage / top battery voltage) * 100) we can calculate the difference between the estima- tion.

  • Page 94: Calculator

    10. P HAPTER LUGINS 10.4.2. Calculator Figure 10.36.: Calculator This is a simple scientific calculator for use on the player. It works like a standard calculator. Pressing the “1st” and “2nd” buttons will toggle between other available math functions. Action Left / Right / Up Move around the keypad / Down...

  • Page 95: Disk Tidy

    10. P HAPTER LUGINS Setup Action Up / Down Increase / decrease displayed Value Right Move to next screen Mode Move to previous screen First enter the number of players (1–10) Then set the total game time in mm:ss Then the maximum round time is entered. For example, this could be used to play Scrabble for a maximum of 15 minutes each, with each round taking no longer than one minute.

  • Page 96: Firmware Flash

    [Warning: Image ignored] Firmware flash Use when flashing Rockbox (see section ?? (page ??). In the ideal case, you’ll need this tool only once. For safety reasons you may wish to delete firmware flash.rock from /.rockbox/rocks once flashing is complete.

  • Page 97: Random Folder Advance Configuration

    -/CDs and CDs as entries. Edit Folder List Enter the folder list editor Export List To Textfile Exports the list to /.rockbox/folder advance list.txt Import List From Textfile Imports the list from /.rockbox/folder advance list.txt Quit...
  • Page 98 10. P HAPTER LUGINS file as the desired recording. The purpose of the split editor is to split an mp3 file (the input file) at a point in time (split point). Two new files can be generated from the input file.
  • Page 99 10. P HAPTER LUGINS solid part of the time bar represents the position and length of the displayed part of the song. The scale mode On the right side of the bottom line the scale mode is displayed. The waveform can be scaled either logarithmically or linearly. In logarithmic scale mode the letters “dB”...
  • Page 100 10. P HAPTER LUGINS Save dialogue In the save dialogue it is possible to specify which of the files you want to save and their names. When finished, select “Save” and the files will be written to disk. Note that files can not be overwritten, so filenames that do not exist yet must be chosen.

  • Page 101: Stats

    10. P HAPTER LUGINS 10.4.9. Stats Figure 10.40.: The stats-plugin The stats-plugin simply counts the number of files, music files and directories on your player. Press On/Off to abort counting and exit the plugin. Press it again to quit after counting has finished.
  • Page 102 10. P HAPTER LUGINS Usage If you start the Text Editor from the plugin browser you will be greeted with a blank screen. When started from the O menu item your file should be shown on PEN WITH the screen. You can now edit the file. The Text Editor is line based. This means you can edit one line at a time using the V (see section 4.1.3...

  • Page 103: Advanced Topics

    Rockbox source code. 11.1.3. Loading Languages Rockbox can load language files at runtime. Simply copy the .lng file (do not use the .lang file) to the player and “play” it in the Rockbox directory browser or select S...

  • Page 104: Wps - Build Your Own

    11. A HAPTER DVANCED OPICS of WPS files included in Rockbox, and you can load one of these at anytime by selecting it in G ENERAL ETTINGS ISPLAY ROWSE WPS FILES Note: “Playing” a .wps from the file browser has the same effect.
  • Page 105 11. A HAPTER DVANCED OPICS The last else part is optional, and will be displayed if the tag has no value. The WPS parser will always display the last part if the tag has no value, or if the list of alternatives is too short.
  • Page 106 11. A HAPTER DVANCED OPICS XAMPLE %?it %t8%s%it %s%fn ;%?ia %t3%s%ia %t0 The format above will do two different things depending if ID3 tags are present. If the ID3 artist and title are present: Display id3 title for 8 seconds, Display id3 artist for 3 seconds, repeat.

  • Page 107: Managing Rockbox Settings

    files. 11.3.2. Specifications for .cfg Files. The Rockbox configuration file is a plain text file, so once you use the S CFG FILE option to create the file, you can edit the file on your computer using any text editor program.

  • Page 108: The Manage Settings Menu

    A special case configuration file can be used to force a particular setting or settings every time Rockbox starts up (e.g. to set the volume to a safe level). Format a new configuration file as above with the required setting(s) and save it into the /.rockbox directory with the filename fixed.cfg.

  • Page 109: Using Rolo (Rockbox Loader)

    1.31f or 1.32b! These versions are flash updates themselves. If they are applied when Rockbox is flashed, you’ll end up with a garbled flash ROM and hence a dead box. There’s an ultimate safety net to bring back boxes with even completely garbled flash content: the UART boot mod, which in turn requires the serial mod.

  • Page 110: Initial Flashing Procedure

    (main) image. In current firmware files this first image contains Bootbox (see wiki for details). The second image is what is booted by default. The current firmware files contain a copy of Rockbox 3.0.1 in the main image. It can easily be updated/replaced later.

  • Page 111: Updating The Rockbox Image In Flash

    Rockbox, you also need to update the image in the flash. This is a simple and safe procedure: 1. Download (or build) the Rockbox build you want to use, and unzip it to the root of your player. Safely disconnect USB.

  • Page 112: File Formats

    A. F PPENDIX ILE FORMATS OCKBOX MANUAL RCHOS NDIO...

  • Page 113: Supported File Formats

    File Type Extension Action when selected Directory none The browser enters that directory Audio file Rockbox takes you to the .mp2, .mp3 WPS and starts playing the file Cuesheet View a cuesheet file .cue Wave Audio File Play a WAV file .wav...

  • Page 114: Wps Tags

    B. WPS T PPENDIX B. WPS Tags B.1. Status Bar Description Status Bar Enabled Status Bar Disabled These tags override the player setting for the display of the status bar. They must be noted on their own line. B.2. ID3 Info Description ID3 Artist ID3 Composer...

  • Page 115: Power Related Information

    B. WPS T PPENDIX B.3. Power Related Information Description Show numeric battery level in percent. Can also be used in a conditional: %?bl -1 0 1 2 ... N Where the -1 value is used when the battery level isn’t known (it usually is). Show the battery level in volts Show estimated battery time left “p”...

  • Page 116: Playlist/Song Info

    B. WPS T PPENDIX B.5. Playlist/Song Info Description Progress Bar This will replace the entire line with a progress bar. You can set the height, position and width of the progressbar (in pixels): %pb height leftpos rightpos toppos Percentage Played In Song Current Time In Song Total Number of Playlist Entries Peak Meter.

  • Page 117: Repeat Mode

    B. WPS T PPENDIX B.8. Repeat Mode Description Repeat mode, 0-4, in the order: Off, All, One, Shuffle Example: %?mm Off All One Shuffle A-B B.9. Playback Mode Tags Description Play status, 0-4, in the order: Stop, Play, Pause, Fast forward, Rewind Example: %?mp Stop Play Pause Ffwd Rew OCKBOX MANUAL RCHOS...

  • Page 118: Images

    first (i.e. top most) sub-image will be used. Examples: 1. Load and display the image /.rockbox/bg.bmp with ID “a” at 37, 109: %x a bg.bmp 37 109 2. Load a bitmap strip containing 5 volume icon images (all the same size) with image ID “M”, and then reference the individual sub-images in a conditional:...

  • Page 119: Alignment

    B. WPS T PPENDIX The images must be in a rockbox compatible format (1 bit per pixel BMP) The image tag must be on its own line The ID is case sensitive, giving 52 different ID’s The size of the LCD screen for each player varies. See table below for appropriate sizes of each device.

  • Page 120: Other Tags

    B. WPS T PPENDIX B.13. Other Tags Description Display a ‘%’ Display a ‘ ’ Display a ‘ ’ Display a ‘ ’ Display a ‘;’ Indicate that the line should scroll. Can occur anywhere in a line (given that the text is displayed;...

  • Page 121: Config File Options

    C. C PPENDIX ONFIG FILE OPTIONS C. Config file options Setting Allowed Values Unit volume -100 -to +12 bass -15 to +15 treble -15 to +15 balance -100 to +100 channels stereo, mono, custom, mono left, mono right, karaoke stereo width 0 to 250 shuffle on, off...
  • Page 122 C. C PPENDIX ONFIG FILE OPTIONS Setting Allowed Values Unit show path in browser off, current directory, full path contrast 0 to 63 backlight timeout off, on, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, seconds 20, 25, 30, 45, 60, 90, 120 backlight timeout plugged off, on, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, seconds...
  • Page 123 C. C PPENDIX ONFIG FILE OPTIONS Setting Allowed Values Unit skip length track, 1, 2, 3, 4, 5, 10, 15 minutes start in screen previous, root, files, db, wps, menu, recording, radio, bookmarks playlist catalog directory /path/to/dir peak meter release 1 to 126 peak meter hold off, 200ms, 300ms, 500ms, 1, 2, 3,...
  • Page 124 C. C PPENDIX ONFIG FILE OPTIONS OCKBOX MANUAL RCHOS NDIO...

  • Page 125: User Feedback

    To suggest an idea for a feature or to read those made by others, see http://forums. rockbox.org/index.php?board=49.0. Please keep in mind that this forum is for the dis- cussion of feature ideas - they are not requests and there is no guarantee they will be acted upon.

  • Page 126: Features We Will Not Implement

    D. U PPENDIX SER FEEDBACK D.2.2. Features we will not implement This is a list of Feature Requests we get repeatedly that we simply cannot do. View it as the opposite of a TODO! Record to WAV (uncompressed) or MP3pro format! The recording hardware (the MAS) does not allow us to do this Crossfade between tracks! Crossfading would require two mp3 decoders, and we only have one.
  • Page 127 Support other file systems than FAT32 (like NTFS or ext2 or whatever)! No. Rockbox needs to support FAT32 since it can only start off a FAT32 partition (since that is the only way the ROM can load it), and addingsupport for more file systems will just take away valuable ram for unnecessary features.

  • Page 128: Changelog

    2007-06-29: Rocklife plugin 2007-06-28: Maze game 2007-06-17: Custom filetype colour feature introduced 2007-05-23: The 80GB Ipod Video is now supported by Rockbox 2007-04-09: WAV file viewer 2007-03-11: Sound on the Sansa e200 2007-03-04: Rockbox runs and plays music on the iAudio M5...

  • Page 129: Enhancements

    2006-08-07: Initial version of mpegplayer plugin 2006-07-19: Rockpaint plugin 2006-07-18: Playlist catalog 2006-04-19: Rockbox is functional and plays audio on the iPod Mini 1G 2006-03-30: Rockbox is functional and plays audio on the iPod Mini 2G 2006-03-28: DOOM 2006-03-28: Sound on the iAudio X5 , X5L and X5V...

  • Page 130: New Codecs Supported

    E. C PPENDIX HANGELOG 2007-01-23: Settings are now saved to /.rockbox/config.cfg and the hidden config sector is not used anymore 2006-11-29: Playlists are saved with the extension .m3u8, extension .m3u is now read using the chosen codepage 2006-09-16: New scheduler. Audio playback is now prioritised over other tasks 2006-09-02: Enhanced statusbar in recording screen 2006-08-15: Support for displaying the path in the file browser...

  • Page 131: Credits

    F. C PPENDIX REDITS F. Credits People that have contributed to the project, one way or another. Friends! ¨ · B · L · F · M TENBERG INUS IELSEN ELTZ RANCOIS OUCHER ATTHIAS · A · A · B ·...
  • Page 132 F. C PPENDIX REDITS ´ · N · N · S · S · A · A ATHAN ANHAM E PHANE OYON USTIN PPEL · M · T · I BASTIAN ENRIKSEN ARTIN CARRATT MITH RAVIS YYPPA EBBER B ¨ ·...
  • Page 133 F. C PPENDIX REDITS · P · D · J · M RAAM RZEMYSŁAW OŁUBOWSKI AVIDE ENTILE AMES ASILE · S · J · M · M TEPAN OSKOVCHENKO HAMED AREK URKE ICHAEL · B · S · M · T J.

  • Page 134: Licenses

    G. L PPENDIX ICENSES G. Licenses G.1. GNU Free Documentation License Version 1.2, November 2002 Copyright c 2000,2001,2002 Free Software Foundation, Inc. 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed.
  • Page 135 G. L PPENDIX ICENSES A ”Modified Version” of the Document means any work containing the Document or a portion of it, either copied verbatim, or with modifications and/or translated into another language. A ”Secondary Section” is a named appendix or a front-matter section of the Doc- ument that deals exclusively with the relationship of the publishers or authors of the Document to the Document’s overall subject (or to related matters) and contains noth- ing that could fall directly within that overall subject.
  • Page 136 G. L PPENDIX ICENSES is precisely XYZ or contains XYZ in parentheses following text that translates XYZ in another language. (Here XYZ stands for a specific section name mentioned below, such as ”Acknowledgements”, ”Dedications”, ”Endorsements”, or ”History”.) To ”Pre- serve the Title” of such a section when you modify the Document means that it remains a section ”Entitled XYZ”...
  • Page 137 G. L PPENDIX ICENSES begin distribution of Opaque copies in quantity, to ensure that this Transparent copy will remain thus accessible at the stated location until at least one year after the last time you distribute an Opaque copy (directly or through your agents or retailers) of that edition to the public.
  • Page 138 G. L PPENDIX ICENSES as given on its Title Page, then add an item describing the Modified Version as stated in the previous sentence. J. Preserve the network location, if any, given in the Document for public access to a Transparent copy of the Document, and likewise the network locations given in the Document for previous versions it was based on.
  • Page 139 G. L PPENDIX ICENSES 5. COMBINING DOCUMENTS You may combine the Document with other documents released under this License, under the terms defined in section 4 above for modified versions, provided that you include in the combination all of the Invariant Sections of all of the original documents, unmodified, and list them all as Invariant Sections of your combined work in its license notice, and that you preserve all their Warranty Disclaimers.
  • Page 140 G. L PPENDIX ICENSES 8. TRANSLATION Translation is considered a kind of modification, so you may distribute translations of the Document under the terms of section 4. Replacing Invariant Sections with trans- lations requires special permission from their copyright holders, but you may include translations of some or all Invariant Sections in addition to the original versions of these Invariant Sections.
  • Page 141 G. L PPENDIX ICENSES Copyright c YEAR YOUR NAME. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documen- tation License, Version 1.2 or any later version published by the Free Soft- ware Foundation;...

  • Page 142: The Gnu General Public License

    G. L PPENDIX ICENSES G.2. The GNU General Public License Version 2, June 1991 Copyright c 1989, 1991 Free Software Foundation, Inc. 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed.
  • Page 143 G. L PPENDIX ICENSES GNU G ENERAL UBLIC ICENSE ERMS AND ONDITIONS OPYING ISTRIBUTION AND ODIFICATION 0. This License applies to any program or other work which contains a notice placed by the copyright holder saying it may be distributed under the terms of this Gen- eral Public License.
  • Page 144 G. L PPENDIX ICENSES these conditions, and telling the user how to view a copy of this License. (Exception: if the Program itself is interactive but does not normally print such an announcement, your work based on the Program is not required to print an announcement.) These requirements apply to the modified work as a whole.
  • Page 145 G. L PPENDIX ICENSES include anything that is normally distributed (in either source or binary form) with the major components (compiler, kernel, and so on) of the operating sys- tem on which the executable runs, unless that component itself accompanies the executable.
  • Page 146 G. L PPENDIX ICENSES It is not the purpose of this section to induce you to infringe any patents or other property right claims or to contest validity of any such claims; this section has the sole purpose of protecting the integrity of the free software distribution system, which is implemented by public license practices.
  • Page 147 G. L PPENDIX ICENSES HE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU HOULD THE PROGRAM PROVE DEFECTIVE YOU ASSUME THE COST OF ALL NECESSARY SERVICING REPAIR OR CORRECTION 12. I N NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRIT ING WILL ANY COPYRIGHT HOLDER OR ANY OTHER PARTY WHO MAY MODIFY OR REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE...
  • Page 148 G. L PPENDIX ICENSES Also add information on how to contact you by electronic and paper mail. 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;...

Table of Contents