background image

Appendix D. Theme Tags

185

D.21. Images

Tag

Description

%X(filename.bmp)

Load and set a backdrop image for the WPS. This image must
be exactly the same size as your LCD.

%x(n,filename[,x,y])

Load and display an image

n

: image ID for later referencing in

%xd

filename

: file name relative to

/.rockbox/

and including

“.bmp”

x

: x coordinate (defaults to 0 if both x and y are not specified)

y

: y coordinate. (defaults to 0 if both x and y are not speci-

fied)

%xl(n,filename,[x,y],

[nimages])

Preload an image for later display (useful for when your im-
ages are displayed conditionally).

n

: image ID for later referencing in

%xd

filename

: file name relative to

/.rockbox/

and including

“.bmp”
If the filename is “__list_icons__” the list icon bitmap will
be used instead

x

: x coordinate (defaults to 0 if both x and y are not specified)

y

: y coordinate. (defaults to 0 if both x and y are not speci-

fied)

nimages

: (optional) number of sub-images (tiled vertically, of

the same height) contained in the bitmap. Default is 1.

%xd(n[i] [,tag]

[,offset])

Display a preloaded image.

n

: image ID as it was specified in

%x

or

%xl

i

: (optional) number of the sub-image to display (a-z for 1-26

and A-Z for 27-52). (ignored when

tag

is used). Only useable

if the ID is a single letter. By default the first (i.e. top most)
sub-image will be used.

tag

: (optional) Another tag to calculate the subimage from

e.g

%xd(A, %mh)

would use the first subimage when

%mh

is on

and the second when it is off

offset

: (optional) Add this number to the value from the

tag

when chosing the subimage (may be negative)

%x9(n)

Display an image as a 9-patch bitmap covering the entire view-
port.
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

(version 3.14)

Olympus m:robe 100

Summary of Contents for m:robe 100

Page 1: ...The Rockbox Manual for Olympus m robe 100 rockbox org April 30 2017 ...

Page 2: ...José Maria Garcia Valdecasas Bernal Peter Schlenker Version 3 14 Built using pdfL A TEX Permission is granted to copy distribute and or modify this document under the terms of the GNU Free Documentation License Version 1 2 or any later version published by the Free Software Foundation with no Invariant Sec tions no Front Cover Texts and no Back Cover Texts A copy of the license is included in the ...

Page 3: ...ockbox 17 2 5 1 Automatic Uninstallation 17 2 5 2 Manual Uninstallation 17 2 6 Troubleshooting 17 3 Quick Start 18 3 1 Basic Overview 18 3 1 1 The player s controls 18 3 1 2 Turning the player on and off 19 3 1 3 Starting the original firmware 19 3 1 4 Putting music on your player 19 3 1 5 The first contact 19 3 1 6 Basic controls 20 3 1 7 Basic concepts 20 3 2 Customising Rockbox 21 3 3 USB Charg...

Page 4: ...sts 38 4 4 6 Loading saved playlists 38 4 5 Hotkeys 38 5 The Main Menu 39 5 1 Introducing the Main Menu 39 5 2 Navigating the Main Menu 39 5 3 Recent Bookmarks 40 5 4 Files 40 5 5 Database 41 5 6 Now Playing Resume Playback 41 5 7 Settings 41 5 7 1 Sound Settings 41 5 7 2 Playback Settings 41 5 7 3 General Settings 41 5 7 4 Theme Settings 41 5 7 5 Manage Settings 41 5 8 Playlists 42 5 9 Plugins 42...

Page 5: ... 9 Replaygain 56 7 10 Track Skip Beep 57 7 11 Auto Change Directory 57 7 12 Constrain Auto Change 57 7 13 Pause on Headphone Unplug 57 7 14 Last fm Log 58 7 15 Cuesheet Support 58 7 16 Skip Length 58 7 17 Prevent Track Skipping 58 7 18 Rewind Before Resume 59 7 19 Rewind on Pause 59 8 General Settings 60 8 1 Playlist 60 8 2 File View 60 8 3 Database 62 8 4 Display 62 8 5 System 66 8 5 1 Battery 66...

Page 6: ...lackjack 81 11 1 3 Boomshine 82 11 1 4 BrickMania 82 11 1 5 Bubbles 83 11 1 6 Chessbox 83 11 1 7 Chopper 84 11 1 8 Dice 85 11 1 9 Doom 85 11 1 10 Flipit 87 11 1 11 Goban 88 11 1 12 Jackpot 92 11 1 13 Jewels 93 11 1 14 Maze 93 11 1 15 MazezaM 94 11 1 16 Minesweeper 94 11 1 17 Pegbox 95 11 1 18 Pong 96 11 1 19 Puzzles 96 11 1 20 Reversi 97 11 1 21 Robotfindskitten 97 11 1 22 Rockblox 98 11 1 23 Rock...

Page 7: ...loscope 113 11 2 12 PictureFlow 114 11 2 13 Plasma 116 11 2 14 Rocklife 116 11 2 15 Snow 117 11 2 16 Starfield 117 11 2 17 VU meter 118 11 3 Viewers 118 11 3 1 Shortcuts 119 11 3 2 Chip 8 Emulator 120 11 3 3 Frotz 121 11 3 4 Image Viewer 122 11 3 5 Lua scripting language 123 11 3 6 Midiplay 123 11 3 7 MPEG Player 124 11 3 8 MP3 Encoder 126 11 3 9 Search 126 11 3 10 Shopper 126 11 3 11 Sort 127 11 ...

Page 8: ...Advanced Topics 156 12 1 Customising the User Interface 156 12 1 1 Customising The Main Menu 156 12 1 2 Getting Extras 156 12 1 3 Loading Fonts 156 12 1 4 Loading Languages 157 12 1 5 UI Viewport 157 12 2 Configuring the Theme 158 12 2 1 Themeing General Info 158 12 2 2 Themes Create Your Own 158 12 2 3 Info Viewport SBS only 160 12 2 4 Additional Fonts 160 12 3 Managing Rockbox Settings 163 12 3 ...

Page 9: ...ndling 173 C Album Art 174 C 1 Limitations 174 C 2 Where to put album art 174 D Theme Tags 176 D 1 Status Bar 176 D 2 Hardware Capabilities 176 D 3 Information from the track tags 177 D 4 Viewports 177 D 5 Additional Fonts 177 D 6 Misc Coloring Tags 178 D 7 Power Related Information 178 D 8 Information about the file 179 D 9 Playlist Song Info 180 D 10 Playlist Viewer 180 D 11 Runtime Database 181...

Page 10: ...90 E Config file options 191 F Menu Overview 196 G User feedback 197 G 1 Bug reports 197 G 1 1 Rules for submitting new bug reports 197 G 2 Feature ideas 197 G 2 1 Rules for submitting a new feature idea 197 G 2 2 Features we will not implement 198 H Credits 199 I Licenses 203 I 1 GNU Free Documentation License 203 I 2 The GNU General Public License 211 The Rockbox manual version 3 14 Olympus m ro...

Page 11: ...put into making Rockbox sound the best it can and improvements are constantly being made All models have access to a large number of plugins including many games applications and graphical demos You can load different configurations quickly for different purposes e g a large font for in your car different sound settings for at home Rockbox features a very wide range of languages and all supported ...

Page 12: ...icons on the margin to help you finding important parts or parts you could skip The following icons are used Note This indicates a note A note starts always with the text Note In order to b make finding notes easier each one is accompanied by an icon in the margin as here Notes are used to mark useful information that may help you to get the most out of Rockbox Warning This is a warning In contras...

Page 13: ...e manual way is still available to you There are three separate components two of which need to be installed in order to run Rockbox The Olympus bootloader The Olympus bootloader is the program that tells your player how to load and start the original firmware It is also responsible for any emer gency recovery or disk modes on your player This bootloader is stored in special flash memory in your O...

Page 14: ...all components you installed using Rockbox Utility Prebuilt binaries for Windows Linux and Mac OS X are available at the ZRockboxUtility wiki page When first starting Rockbox Utility run Autodetect found in the configuration dialog File Configure Autodetection can detect most player types If autodetection fails or is unable to detect the mountpoint make sure to enter the correct values The mountpo...

Page 15: ...nd potentially annoying bugs Unless you wish to try the latest and greatest features at the price of possibly greater instability or you wish to help with development you should stick with the release Please now go to section 2 2 3 page 16 to complete the installation procedure 2 2 2 Manual Installation The manual installation method is still available to you should you need or desire it by follow...

Page 16: ...ive unplug the cable and restart 2 2 4 Enabling Speech Support optional If you wish to use speech support you will also need a voice file Voice files allow Rockbox to speak the user interface to you Rockbox Utility can install an English voice file or you can download it from http www rockbox org daily shtml and unzip it to the root of your player Rockbox Utility can also aid you in the creation o...

Page 17: ...ck to using the original Olympus software connect the player to your computer and delete the pp5020 mi4 file and rename OF mi4 to pp5020 mi4 in the System directory on your m robe 100 If you wish to clean up your disk you may also wish to delete the rockbox directory and its contents Turn the Olympus off Turn the player back on and the original Olympus software will load 2 6 Troubleshooting File N...

Page 18: ...player with the black front facing you such that the m robe writing is read able Below the writing is the touch sensitive pad with the Menu Play Left Right and Displaycontrols indicated by their symbols The dotted center strip is devided in three parts Up Select and Down On the top of the unit on the right is the Power switch which is held down to turn the player on or off The Hold switch is locat...

Page 19: ...device like a USB Drive music files can be put on the player via any standard file transfer method that you would use to copy files between drives e g Drag and Drop Files may be placed wherever you like on the player but it is strongly suggested NOT to put them in the rockbox folder and instead put them in any other folder e g music or audio The default directory structure that is assumed by some ...

Page 20: ...list 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 modify 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 Playlists are covered in detail in section 4 4 page 35 Menu From the menu you can customise Rockbox R...

Page 21: ... shipped with Rockbox need additional fonts from the fonts b package so make sure you installed them Also if you downloaded additional themes from the Internet make sure you have the needed fonts installed as otherwise the theme may not display properly 3 3 USB Charging To charge your player over USB hold any button while plugging it in This will prevent it from connecting to your computer and let...

Page 22: ... music on your player using categories like album artist genre etc You can select whether to browse using the File Browser or the Database Browser by selecting either Files or Database in the Main Menu If you choose the File Browser the Show Files setting lets you select what types of files you wish to view See section 8 2 page 61 for more information on the Show Files setting Note The File Browse...

Page 23: ... audio playback Long Select Long Forward Enter the Context Menu Menu Heart Enter the Main Menu Long Menu Switch to the Quick Screen see sec tion 5 11 page 43 Display Menu Activate the Hotkey function see sec tion 4 5 page 38 4 1 2 Context Menu Figure 4 2 The Context Menu The Context Menu allows you to perform certain operations on files or directories To access the Context Menu position the select...

Page 24: ...ubdi rectories it may contain Deleted directories cannot be recovered Use this feature with caution Open with Runs a viewer plugin on the file Normally when a file is selected in Rock box Rockbox automatically detects the file type and runs the appropriate plugin The Open With function can be used to override the default action and select a viewer by hand For example this function can be used to v...

Page 25: ...he virtual keyboard that is used when entering text in Rockbox for example when renaming a file or creating a new directory The virtual keyboard can be easily changed by making a text file with the required layout More information on how to achieve this can be found on the Rockbox website at ZLoadableKeyboardLayouts Also you can switch to Morse code input mode by changing the Use Morse Code Input ...

Page 26: ... Morse code input mode 4 2 Database 4 2 1 Introduction This chapter describes the Rockbox music database system Using the information contained in the tags 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 database uses to sort the son...

Page 27: ...ery on boot up Note If you browse your music frequently using the database you should load b to RAM as this will reduce the overall battery consumption because the disk will not need to spin on each search Auto Update If Auto update is set to on each time the player boots the database will automatically be updated Initialize Now You can force Rockbox to rescan your disk for tagged files by using t...

Page 28: ... database If Auto Update is enabled this is per formed automatically when the database is initialized 4 2 4 Using the Database Once the database has been initialized you can browse your music by Artist Al bum Genre Song Name etc To use the database go to the Main Menu and select Database Note You may need to increase the value of the Max Entries in File Browser b setting Settings General Settings ...

Page 29: ...em length numeric system Lm track len min numeric system Ls track len sec numeric system 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 items can be turned on or off independently Refer to se...

Page 30: ...rate VBR files display average bitrate and avg Elapsed and total time A slidebar progress meter representing where in the song you are Peak meter See section 12 2 page 158 for details of customising your WPS While Playing Screen The Rockbox manual version 3 14 Olympus m robe 100 ...

Page 31: ...ck Screen see sec tion 5 11 page 43 Display Up Down Show Pitch Screen see section 4 3 3 page 34 Display Down Show current Playlist Display Menu Activate the Hotkey function see sec tion 4 5 page 38 Display Right or Short Right Long Right Short Forward Long Forward Skip to the next directory Display Left or Short Left Long Left Short Rewind Long Rewind Skip to the previous directory 4 3 2 Peak Mete...

Page 32: ...rrent playlist These and other operations are detailed in section 4 4 page 35 To change settings for the Playlist Viewer press Long Select while viewing the current playlist to bring up the Playlist Viewer Menu In this menu you can find the Playlist Viewer Settings Playlist Viewer Settings Show Icons This toggles display of the icon for the currently selected playlist entry and the icon for moving...

Page 33: ...ating value 0 10 to a track which can be displayed in the WPS and used in the Database browser The value wraps at 10 Bookmarks This allows you to create a bookmark in the currently playing track Show Track Info Figure 4 4 The track info viewer This screen is accessible from the WPS screen and provides a detailed view of all the identity information about the current track This info is known as met...

Page 34: ... playback speed without affecting the pitch and vice versa In timestretch mode there are separate displays for pitch and speed and each can be altered independently Due to the limitations of the algorithm speed is limited to be between 35 and 250 of the current pitch value Pitch must maintain the same ratio as well as remain between 50 and 200 The value of the rate pitch and speed is not persisten...

Page 35: ...er Rockbox can Insert into a playlist in several places Queue In Rockbox to Queue a song means to put the song into a playlist and then to remove the song from the playlist once it has been played The only difference between 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...

Page 36: ...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 Playlist Submenu is a submenu in the Context Menu see section 4 1 2 page 23 it allows you to put tracks into a dynamic playlist If there is no music currently play in...

Page 37: ...menu can be used to add either single tracks or entire directories to a playlist If the Playlist Submenu is invoked on a single track it will put only that track into the playlist On the other hand if the Playlist Submenu is invoked on a directory Rockbox adds all of the tracks in that directory to the playlist Note You can control whether or not Rockbox includes the contents of subdirectories b w...

Page 38: ...ge 25 enter a filename for your playlist and accept it and you are done 4 4 6 Loading saved playlists Through the File Browser Playlist files like regular music tracks can be selected through the File Browser 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 specif...

Page 39: ...ccesses the hard disk the next time for example when refilling the music buffer or navigating through the File Browser Changes to settings may therefore not be saved unless the player is shut down safely see section 3 1 2 page 19 5 2 Navigating the Main Menu Key Remote Key Action Down Display Select the next option in the menu Inside a setting increase the value or choose next option Up Play Selec...

Page 40: ...Select the previous bookmark Select or Right Forward Resume from the selected bookmark Left or Display or Power Rewind Exit Recent Bookmark menu Display Delete the currently selected bookmark Long Select Long Forward Enter the context menu for the selected bookmark There are two options in the context menu Resume will commence playback of the currently selected bookmark entry Delete will remove th...

Page 41: ...er value and would like to restore the default value 5 7 1 Sound Settings The Sound Settings menu offers a selection of sound properties you may change to customise your listening experience The details of this menu are covered in section 6 page 45 5 7 2 Playback Settings The Playback Settings menu allows you to configure settings related to audio play back The details of this menu are covered in ...

Page 42: ...then playlist is saved to the current directory View Catalogue Provides a simple interface to maintain several playlists see sec tion 4 4 page 35 5 9 Plugins With this option you can load and run various plugins that have been written for Rock box There are a wide variety of these supplied with Rockbox including several games some impressive demos and a number of utilities A detailed description o...

Page 43: ...ange the options navigate through the menus to the setting you want to add and press Long Select In the menu which appears you will be given options to place the setting on the Quick Screen Press Long Menu to access it and Menu to exit The direction buttons will modify the individual setting values as indicated by the arrow icons Please note that the settings at opposite sides of the screen cycle ...

Page 44: ...of the possible settings debug data is the name of the debug menu item to display separator data is ignored name can be used to display text or left blank to make the list more accessible with visual gaps time data needs to be either talk to talk the time or sleep X where X is the number of minutes to run the sleep timer for 0 to disable name is required for this shortcut type shutdown data is ign...

Page 45: ...ld a progressively softer volume Values higher than 0 dB are available and can be used to raise the volume more than would otherwise be possible These volume levels will ordi narily lead to distorted sound but might work nicely for music that has an otherwise low volume level The volume can be adjusted from a minimum of 73 dB to a maximum of 6 dB 6 2 Bass This setting emphasises or suppresses the ...

Page 46: ...ine both channels and send the resulting signal to both stereo channels resulting in a monophonic output Custom Allows you to manually specify a stereo width with the Stereo Width setting described later in this chapter Mono Left Plays the left channel in both stereo channels Mono Right Plays the right channel in both stereo channels Karaoke Removes all sound that is common to both channels Since ...

Page 47: ...e right channel into the left channel and vice versa in order to simulate the spatial cues that the ear and brain receive when listening to a set of loudspeakers placed in front of the listener The result is a more natural stereo image that can be especially appreciated in older rock and jazz records where one instrument is often hard panned to just one of the speakers Many people will find such r...

Page 48: ...idth of EQ bands separately The ability to adjust the frequency and width of bands enables more precise control of the EQ frequency response while avoiding the use of a large number of bands often 12 needed in a non parametric EQ The graphic below illustrates how the width of 10kHz band can be adjusted to cover a wider lower Q or narrower higher Q range of frequencies In some ways the EQ is simila...

Page 49: ...frequency range cen tered at the centre frequency chosen Graphic equalizers in home stereos are usually peaking filters The peaking filters in Rockbox s EQ lets you adjust three different parameters for EQ bands 1 through 8 The centre parameter controls the centre frequency of the frequency range that is affected as described above The gain parameter controls how much each band is adjusted and wor...

Page 50: ...rs that can be adjusted using the graphical EQ With the Simple EQ the only parameter that can be adjusted is the gain Advanced EQ This sub menu provides options for adjusting the same parameters as the Graphical EQ The only difference is that the parameters are adjusted through textual menus rather than through a graphic interface Save EQ Preset This option saves the current EQ configuration in a ...

Page 51: ...ntended for speech playback and may significantly dilute your listening experience with more complex audio See section 4 3 3 page 34 for more details about how to use the feature 6 12 Haas Surround This setting implements the Haas effect with adjustable delay time to enhance the stereo effect of the sound A full range Haas effect creates the impression that sound starts from one channel and ends i...

Page 52: ...limit This is desirable because the compressed signal without makeup gain is quieter than the input signal Makeup Gain in Auto restores the signal to the maximum possible level and brings the quieter audio up with it This is what makes it possible to hear the quieter audio in noisy environments The Ratio setting determines how aggressively the compressor reduces gain above the threshold For exampl...

Page 53: ...es Rockbox b will move on to the next directory on your hard drive If the Auto Change Directory option is set to No playback will stop when the current directory or playlist is finished All The current playlist will repeat when it is finished One Repeat one track over and over Shuffle When the current playlist has finished playing it will be shuffled and then repeated A B Repeats between two user ...

Page 54: ...fer can be set to various values between 5 seconds and 10 minutes Note Having a large anti skip buffer tends to use more power and may reduce your b battery life It is recommended to always use the lowest possible setting that allows correct and continuous playback 7 6 Fade on Stop Pause Enables and disables a fade effect when you pause or stop playing a song If the Fade on Stop Pause option is se...

Page 55: ...ime between when the crossfade process begins and when the new track begins to fade in Fade In Duration The length of time in seconds that it takes your music to fade in once the Fade In Delay has ended Fade Out Delay The fade out delay is the length of time between when the crossfade process begins and when the old track begins to fade out Fade Out Duration The length of time in seconds that it t...

Page 56: ...o apply Album Gain Maintain a constant volume level between albums but keep any intentional volume variations between songs in an album If album gain value is not available uses track gain information Track Gain Maintain a constant volume level between tracks If track gain value is not available no replaygain is applied Track Gain If Shuffling Maintains a constant volume between tracks if Shuffle ...

Page 57: ...e requires you to first generate a folder list via the Random Folder Advance Configuration plugin see section 11 4 18 page 151 Note You must have the Repeat option set to No for Auto Change Directory to b function properly Note This feature only works when songs have been played from the file browser Using b it with the database may cause unexpected behaviour 7 12 Constrain Auto Change If enabled ...

Page 58: ...rom the ID3 tags When you enable this option you ll have to reboot for it to come into effect Cuesheet files should have the same file name as the audio file they reference except with the extension cue This file can either reside in the same directory as the audio file checked first or within the rockbox cue directory The contents of a cuesheet file can also be embedded within the metadata of an ...

Page 59: ... stopped The size of the rewind can be set to various values between 0 off and 60 seconds Note This option does not apply to resuming a paused track Use the next option for b rewinding on pause Note The actual rewind distance may differ a little from the requested value depending b on the file in question 7 19 Rewind on Pause This option rewinds the current track by a small amount whenever it is p...

Page 60: ...with options relating to how the File Browser displays files Sort Case Sensitive If this option is set to Yes all files that start with upper case letters will be listed first followed by all files that begin with lower case letters If this option is set to NO then case will be ignored when sorting files Sort Directories This option controls how Rockbox sorts directories The default is to sort the...

Page 61: ... shown No files or directories are hidden Supported The File Browser displays all directories and files supported by Rockbox see section A 1 page 167 Files and directories starting with dot or with the hidden flag set are hidden Music The File Browser displays only directories playlists and the supported audio file formats Extensions are stripped Files and directories starting with or with the hid...

Page 62: ...ile Plugged In This setting is equivalent to the Backlight set ting except it applies when the player is plugged into the charger Backlight on Hold This setting controls the behavior of the backlight when the Hold switch is toggled If set to Normal the backlight will behave as usual If set to Off the backlight will be turned off immediately when the Hold switch is engaged and if set to On the back...

Page 63: ...hanges the contrast of your LCD display Warning Setting the contrast too dark or too light can make it hard to find this menu option again LCD Mode This setting lets you invert the colours of the display Upside Down Displays the screen so that the top of the display is nearest the buttons This is sometimes useful when carrying the player in a pocket for easy access to the headphone socket Remote L...

Page 64: ...lling Scroll Step Size Defines the number of pixels the text should move for each step as used by the Scroll Speed setting Remote Scrolling Options The options here have the same effect on the remote LCD as the options mentioned above have on the main LCD Bidirectional Scroll Limit Rockbox has two different automatic horizontal scrolling methods 1 always scrolling the text to the left until the li...

Page 65: ... whether the peak meter displays linear or logarithmic values The human ear perceives loudness on a logarithmic scale If the Scale setting is set to Logarithmic dB scale the volume values are scaled logarithmically The volume meters of digital audio devices usually are scaled this way On the other hand if you are interested in the power level that is applied to your headphones you should choose Li...

Page 66: ...pins up to fill the audio buffer it automatically spins down afterwards Directory Cache Rockbox has the ability to cache the contents of your drive in RAM The Directory Cache takes a small amount of memory away from Rockbox that would otherwise be used to buffer music but it speeds up navigation in the file browser by eliminating the slight pause between the time a navigation button is pressed and...

Page 67: ...nabled 8 5 5 Button Light Timeout This setting controls the amount of time the button lights shine after a button press If set to Off the LEDs will not light when a button is pressed If set to On the lights will never shut off If set to a time 1 to 120 seconds the buttons will stay lit for that amount of time after a button press 8 5 6 Keyclick This menu controls key clicks on button presses Keycl...

Page 68: ...ture On and Off When this feature is enabled the player enumerates as a Human Interface Device HID composed of several HID sub devices Since the player also enumerates as a Mass Storage Device it becomes a USB Composite Device which contains both these devices 8 5 9 USB Keypad Mode This setting control the keypad mode when the player is attached to a computer through USB Pressing a key on the play...

Page 69: ...ontrol for this purpose Key Remote Key Action Play Play Slideshow start Display Long Play Long Play Slideshow leave Left Rewind Slide previous Right Forward Slide next Long Left Long Rewind Slide first Long Right Long Forward Slide last Menu Display Black screen Long Menu Long Display White screen Up Down Volume Up Volume Down Previous next link in slide respectively Select Heart Perform a mouse c...

Page 70: ...d right button clicking and dragging and dropping Key Remote Key Action Up Down Left Right Play Display Rewind Forward Cursor move up down left right respectively Menu Heart Left mouse button click Play Right mouse button click Volume up Volume down Volume Up Volume Down Mouse wheel scroll up down respec tively 8 6 Startup Shutdown The Startup Shutdown sub menu allows you to configure items which ...

Page 71: ...ep Timer duration Shown when the Sleep Timer is inactive this option will initiate a Sleep Timer with the duration shown in brackets Cancel Sleep Timer remaining Shown when the Sleep Timer is active this option will cancel the current Sleep Timer The time remaining before completion is shown in brackets Default Sleep Timer Duration The default number of minutes a new Sleep Timer will run for The v...

Page 72: ...cent bookmarks list Ask Recent Only Ask if a bookmark should be created but only add it to the recent bookmarks list When either Yes Recent Only or Ask Recent Only is selected bookmarks are only created if the Maintain a List of Recent Bookmarks is enabled Note The Resume function remembers your position in the most recently ac b cessed track regardless of how the Bookmark on Stop option is set Up...

Page 73: ...us bookmark Select or Right Forward Resumes from the selected bookmark Left or Display or Power Rewind Exits Recent Bookmark menu Display Deletes the currently selected bookmark Long Select Long Forward Enters the context menu for the selected bookmark There are two options in the context menu Resume will commence playback of the currently selected bookmark entry Delete will remove the currently s...

Page 74: ...d yet it asks whether it should be initialized right away Resume on automatic track change Controls whether the next track in an automatic track transition should be resumed at its last playback position as well No Automatic resume works only for manual track selection Yes Always attempt to resume for both manual and automatic track changes In custom directories only Configure directories in which...

Page 75: ...s for directories On Use special pre recorded files _dirname talk in each directory These must be generated in advance and are typically produced synthetically using a text to speech engine on a PC Off No checking is made for directory talk clips they are not used even if present This can reduce disk activity Use of a talk clip takes precedence over other directory name voicing Otherwise e g if a ...

Page 76: ...es is set to Spell Directory will be voiced after each spelled out directory Announce Battery Level When this option is enabled the battery level is announced when it falls under 50 30 and 15 See ZVoiceHowto for more details on configuring speech support in Rockbox 8 11 Hotkey WPS Hotkey File Browser Hotkey These options set the hotkey function for their respective screens see section 4 5 page 38 ...

Page 77: ...fonts on your player Selecting one will activate it See section 12 1 3 page 156 for further details about fonts While Playing Screen Opens the File Browser in the rockbox wps directory and displays all wps files Selecting one will activate it Left or Display or Power will exit back to the menu For further information about the WPS see section 4 3 page 29 For information about editing a wps file se...

Page 78: ...45 for more on the volume set ting Battery Display Controls whether the battery charge status is displayed as a graphic or numerical percentage value on the Status Bar 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 version 3 ...

Page 79: ...d Date Time related menu options Pressing Long Select will voice the current time if voice support is enabled Set Time Date Set current time and date Time Format Choose 12 or 24 hour clock The Rockbox manual version 3 14 Olympus m robe 100 ...

Page 80: ...n the Context Menu 11 1 Games See also the Chip 8 emulator in section 11 3 2 page 120 Frotz in section 11 3 3 page 121 and ZXBox in section 11 3 15 page 132 11 1 1 2048 Figure 11 1 2048 2048 is a simple addictive puzzle game played by moving tiles in around on a 4x4 grid Tiles slide as far as possible in the direction chosen by the player each turn until they are stopped by either another tile or ...

Page 81: ...our hand The rules are simple try to get as close to 21 without going over or simply beat out the dealer for the best hand Although this may not seem difficult blackjack is a game renowned for the strategy involved This version includes the ability to split buy insurance and double down For the full set of rules to the game and other fascinating information visit http www blackjackinfo com blackja...

Page 82: ...e Sometimes a special item falls down when you destroy a brick For a special item to take effect you must catch it with the paddle Look out for the bad ones Special items Displayed Name Description N Normal Returns paddle to normal D Die Ball dies lose a life L Life Gain a life F Fire Allows you to shoot bricks with paddle G Glue Ball sticks to paddle each time it hits B Ball Immediately fires ano...

Page 83: ...ver when any bubbles on the board extend below the bottom line To make things more difficult the entire board is shifted down every time a certain number of shots have been fired Points are awarded depending on how quickly the level was completed Key Remote Key Action Up Play Pause game Left Right Rewind Forward Aim the bubble Select Fire bubble Power or Long Power Exit to menu 11 1 6 Chessbox Fig...

Page 84: ...thinking will cause it to make its move immediately If done while it s your turn the computer will move for you and flip the board so that you are playing from the other side If you want you can force play an entire game and watch the artificial intelligence fight against itself When you quit the game the current state will be saved and restored when you resume the game The menu also allows the us...

Page 85: ...m This is the famous Doom game Getting started For the game to run you need wad game files located in rockbox doom on your player Create the directory and save the following files there rockdoom wad The Rockbox wad based on prboom wad from prboom 2 2 6 Your wad files Copy all Doom wads you wish to play into that directory The needed files can be found at ZPluginDoom To play addon wads create the a...

Page 86: ...en Options Menu This menu has the following options Sound Enable or Disable sound in Doom Set Keys Change the game key configuration Time Demo Run a timed demo to test game speed on a player Only runs on Doom Shareware Player Bobbing Enable or Disable player up Down movement Translucency Enable or Disable sprite translucency Fireballs Plasma Fake Contrast Enable or Disable modified game lighting A...

Page 87: ...t Display Shoot Menu Open Power InGame Menu Select Enter Change Weapon Playing the game After installation of the wad files is complete you can start the game more description is needed 11 1 10 Flipit Figure 11 8 Flipit 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 co...

Page 88: ...es file format 3 or 4 with few problems It attempts to preserve SGF properties which it doesn t understand and most common SGF properties are handled fully It is possible to view and edit if you like Kogo s Joseki Dictionary http waterfire us joseki htm with this plugin although the load and save times can be on the order of a minute or two on particularly slow devices Large SGF files may stop aud...

Page 89: ...nu option of the Context Menu or the Power button C There is a comment at the current node It can be viewed edited using the Add Edit Comment menu option of the Context Menu Controls Key Remote Key Action Up Move cursor up Down Move cursor down Left Move cursor left Right Move cursor right Select Play a move or use a tool if play mode has been changed Menu Retreat one node in the game tree Play Ad...

Page 90: ...ult of the current game This text must follow the format specified at http www red bean com sgf properties html RE to be read by other SGF readers Some examples are B R Black wins by resignation B 5 5 Black wins by 5 5 points W T White wins on Time Handicap The handicap of the current game Komi The komi of the current game compensation to the white player for black having the first move Ruleset Th...

Page 91: ... variations by simply playing the first move in the sequence Unless it is following a variation this mode will not allow you to play illegal moves This is the default mode before another is set after loading a game or creating a new one Add Black Mode Add black stones to the board as desired These stones are not moves and do not perform captures or count as ko threats Add White Mode Add white ston...

Page 92: ...crement the letter 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 11 1 12 Jackpot Figure 11 10 Jackpot This is a jackpot slot machine game At the beginning of the game you have 20 Payouts are given when three matching symbols come up Key Remote Key Action Select ...

Page 93: ...el after every one hundred points and randomly clears several jewels In puzzle mode the aim of the game is to connect the puzzles by skillfully swapping pairs of jewels Key Remote Key Action Left Right Up Down Move the cursor around the jewels Select Select a jewel Power Menu 11 1 14 Maze This is a simple maze generator that creates perfect mazes that have only one solution Key Remote Key Action U...

Page 94: ...er go by selecting retry level from the menu but this will cost you a life You start the game with three lives Luckily there are checkpoints at levels four and eight Key Remote Key Action Up Down Left Right Play Display Rewind Forward Move Character Power Menu 11 1 16 Minesweeper Figure 11 13 Minesweeper plugin The classic game of minesweeper The aim of the game is to uncover all of the squares on...

Page 95: ...y Toggle flag on off Select Reveal the contents of the current square Menu Display the current game status Power Exit the game 11 1 17 Pegbox Figure 11 14 pegbox To beat each level you must destroy all of the pegs If two like pegs are pushed into each other they disappear except for triangles which form a solid block and crosses which allow you to choose a replacement block Key Remote Key Action U...

Page 96: ...ses to the player so for a single player game just press the appropriate buttons to control the side you want to play For a two player game both players should just press the appropriate buttons for their side Key Remote Key Action Menu Left player up Left Left player down Play Right player up Right Right player down Power Quit 11 1 19 Puzzles WARNING Image not found Figure 11 16 Cube from Puzzles...

Page 97: ... can be found in the internet You can choose to play manually you place both the white and dark pieces or to play against a not very smart robot 11 1 21 Robotfindskitten Figure 11 18 Robotfindskitten In this game you are robot Your job is to find kitten This task is complicated by the existence of various things which are not kitten Robot must touch items to determine if they are kitten or not The...

Page 98: ...he pile of blocks reaches the ceiling the game is over Key Remote Key Action Display Restart game Left Move left Right Move right Down Move down Menu Rotate anticlockwise Play Rotate clockwise Select Drop Hold switch Pause Power Quit 11 1 23 Rockblox1d Rockblox1d is a game for people who find rockblox too hard In this version the second dimension is missing so the user only has to move the bricks ...

Page 99: ... 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 Key Remote Key Action Left Right Up and Down Move Tile Select Shuffle Display Switch between pictures default puzzle and your own image if launched via Open With and numbered tiles Power Stop the game 11 1 25 Snake Figure 11 21 Snake The Rockbox manu...

Page 100: ... 26 Snake 2 Figure 11 22 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 Each time an apple is eaten the snake gets longer The game ends when the snake hits a wall or runs into itself Key Remote Key Action Up Down Left Right Steer the snake Select Pause and resume the game Power Quit In game A the maze stays the sa...

Page 101: ...rmat see http sokobano de wiki index php title Level_format Key Remote Key Action In game Up Down Left Right Move the sokoban up down left or right Power Menu Back to previous level Menu Restart level Play Go to next level Select Undo last movement Display Redo previously undone move Solution playback Select Pause resume Up Down Increase decrease playback speed Left Right Go backward forward while...

Page 102: ...s 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 Key Remote Key Action Up Down Left Right Move Cursor around Select Select cards move cards reveal hidden cards Menu If a card was selected unselect it else Draw 3 new cards from the remains stack Display Left Put the card from the top of the remains ...

Page 103: ... hit by them Once in a while a UFO will appear shoot this for extra points Key Remote Key Action Select Shoot Up Thrust Left Right Turn left right Down Teleport Display Pause game Power Quit 11 1 30 Star Figure 11 26 Star game This is a puzzle game It is actually a rewrite of Star a game written by CDK designed for the hp48 calculator The Rockbox manual version 3 14 Olympus m robe 100 ...

Page 104: ...r When starting Sudoku from the Browse Plugins menu a random game will be generated automatically and an estimate of its difficulty very easy easy medium hard or fiendish will be displayed on the screen New games can be generated from the Generate menu option When playing an existing Sudoku game file from Rockbox file browser the plugin is invoked as viewer The selected Sudoku will get loaded and ...

Page 105: ... not saved when saving the game b Key Remote Key Action Up Down Left Right Move the cursor Select Change number under the cursor Long Select Constantly changing the number under the cursor Menu Open Menu Display Add Remove number to scratchpad 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 ...

Page 106: ...y circumstances Arghs have the annoying tendency to accumulate Worms Thou shall not eat worms Neither other worms nor thyself Eating worms is blasphemous cannibalism not healthy and causes instant death 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 Walls Don t crash into the walls Walls are not edible Cras...

Page 107: ...core board entry displays Argh it means the worm is dead because it tried to eat an argh Until we can make the worm say Argh it is your job to say Argh aloud 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 Hints Initially you will be busy with controlling your worm Try to avoid o...

Page 108: ...er Open menu 11 1 34 XWorld 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 XWorld requires the data files BANK and MEMLIST BIN from the original Another World PC game to be copied into the rockbox x...

Page 109: ...mode the bouncing text is replaced by a different one scrolling from right to left Key Remote Key Action Up Down Moves to next previous option Right Left Increases decreases option value Select Toggles Scroll mode Power or Long Power Exits bounce demo Available options are Xdist Ydist The distance to X axis and Y axis respectively Xadd Yadd How fast the code moves on the sine curve on each axis Xs...

Page 110: ...m the System section of the Rockbox main menu Exit at any time by pressing Left or Display or Power 11 2 3 Cube Figure 11 31 Cube This is a rotating cube screen saver in 3D Key Remote Key Action Display Display at maximum frame rate Up Pause Menu Cycle draw mode Right Left Select axis to adjust Up Down Change speed angle speed can not be changed while paused Power Quit The Rockbox manual version 3...

Page 111: ... Rewind Forward Increase decrease speed Up Down Play Display Add remove polygon Power Quit 11 2 5 FFT This plugin is a basic frequency analyzer with 3 different frequency amplitude plots lines bars and spectrogram 11 2 6 Fire Figure 11 33 Fire Fire is a demo displaying a fire effect The Rockbox manual version 3 14 Olympus m robe 100 ...

Page 112: ...greyscale engine Key Remote Key Action Direction keys Move about the image Zoom in Long Select Zoom out Play Decrease iteration depth less detail Menu Increase iteration depth more detail Display Reset and return to the default image Power Quit 11 2 8 Logo Demo showing the Rockbox logo bouncing around the screen Key Remote Key Action Right Left Increase decrease speed on the x axis Up Down Increas...

Page 113: ...1 2 10 Mosaique Figure 11 35 Mosaique This simple graphics demo draws a mosaic picture on the screen of the player Key Remote Key Action Up Change the gap between the drawing lines Select Restart the drawing process Power or Long Power Exits Mosaique demo 11 2 11 Oscilloscope Figure 11 36 Oscilloscope The Rockbox manual version 3 14 Olympus m robe 100 ...

Page 114: ...2 12 PictureFlow Figure 11 37 PictureFlow PictureFlow provides a visualisation of your albums with their associated cover art It is possible to start playback of the selected album from PictureFlow Playback will start from the selected track The PictureFlow plugin will continue to run while your tracks are played Requirements PictureFlow uses both the album art see section C page 174 and database ...

Page 115: ... PictureFlow plugin Settings Menu Show FPS Displays frames per second on screen Spacing The distance between the front edges of the side slides i e changes the degree of overlap of the side slides A larger number means less overlap Scales with zoom Centre margin The distance in screen pixels with zoom at 100 between the centre and side slides Scales with zoom Number of slides Sets the number of sl...

Page 116: ...mplementation of J H Conway s Game of Life see http en wikipedia org wiki Conway 27s_Game_of_Life for a detailed description Rockbox can open files with a configuration description cells files Just play such file and the game configuration stored in it will be loaded into this plugin A cells file is a text file A capital O marks a live cell a dot marks a dead cell all other characters are ignored ...

Page 117: ...winter you will love this demo Or maybe not Press Power or Long Power to quit 11 2 16 Starfield Figure 11 40 Starfield Starfield simulation like the classic screensaver Key Remote Key Action Right Left Increase decrease number of stars Up Down Increase decrease speed Power or Long Power Quit The Rockbox manual version 3 14 Olympus m robe 100 ...

Page 118: ...ngs menu the decay time for the meter its memory the meter type and the meter scale can be changed Key Remote Key Action Power Save settings and quit Display Help Menu Settings Up Raise Volume Down Lower Volume 11 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 rock...

Page 119: ...you can use the context menu on either a file or a directory in the file browser tree and use the Add to shortcuts menu option This will append a line with the full name of the file or the directory to the shortcuts link file in the root directory of the player The file will be created if it does not exist yet You can later rename the automatically created shortcuts link file or move it to another...

Page 120: ...p8 is a kind of assembly language for a long gone architecture This plugin runs games written using the chip8 instructions To start a game open a ch8 file in the File Browser There are lots of tiny Chip8 games usually only about 256 bytes to a couple of KB which were made popular by the HP48 calculator s emulator for them The original Chip8 had 64 32 pixel graphics and the new superchip emulator s...

Page 121: ...ire lines and for typing single characters when the game requires single character input Sounds pictures colour and Unicode are not currently supported but the interpreter informs the game of this and almost all games will adapt so that they are still playable This port of Frotz attempts to be compliant with the Z Machine Specification version 1 0 Some places where you can find Z Machine games and...

Page 122: ...te When an audio file is playing the size of the image is limited as the decoding b process needs to share memory with audio tracks To be able to view a bigger file you may need to stop playback Key Remote Key Action Up Down Left Right Move around in zoomed in image Select Zoom in Play Zoom out Display Right Next image in directory Display Left Previous image in directory Menu Show menu Abort Powe...

Page 123: ...s The coroutine debug and math libraries are not supported Partially supported libraries The os and package libraries are only partially supported Additional libraries The bitlib library is integrated to support bitwise operators See http luaforge net projects bitlib and http lua users org wiki BitwiseOperators Documentation of the API is still a work in progress and the API itself is not finalise...

Page 124: ...own Adjust volume up down Left Right Rewind Fast Forward Menu Open the MPEG Player menu When a video file is selected the Start Menu will be displayed unless it is disabled via the Resume Options see below In the latter case the video will start playing immediately Start Menu Play from beginning Resume information is discarded and the video plays from the start Resume at mm ss Resume video playbac...

Page 125: ...skipped see the Skip Frames option the current time in 100 Hz ticks and the time the current frame is due to be displayed Limit FPS default on With this option disabled mpegplayer will display the video as fast as it can Useful for benchmarking Skip frames default on This option causes mpegplayer to attempt to maintain real time playback by skipping the display of frames but these frames are still...

Page 126: ...oder Note The encoder will choose the appropriate bitstream format from the sample rate of b the input file The output bitstream format is MPEG 1 Layer 3 for 32 44 1 and 48 kHz and MPEG 2 Layer 3 for 16 22 05 and 24 kHz MPEG 2 5 Layer 3 is not supported 11 3 9 Search This plugin can be used on playlists It searches through the playlist that it opened on looking for any occurrences of the string en...

Page 127: ...Shopper the last view is saved including which items you have se lected so if you re open the shopping list it will be as you left it There are additional menu options for clearing the list selecting all items showing and hiding the categories toggling the categories and displaying the playback menu Shopper Keys Key Remote Key Action Select or Right Forward Select or clear an item Menu or Long Sel...

Page 128: ...g viewed Viewer Options Change settings for the current file Encoding Set the codepage in the text viewer Available settings ISO 8859 1 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 UTF 8 Unicode This setting ...

Page 129: ... not display see section 9 page 77 the status bar is not displayed even if you select Yes No Do not display the status bar Yes Display the status bar Scroll Settings The scrolling settings submenu 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 No ...

Page 130: ...roll up or down one full screen Top Bottom Page Move to the top or bottom page Indent Spaces Set the number of spaces to indent the text when line mode is set to Reflow Lines Available options are 0 to 5 spaces If you select 0 a blank line is displayed as an indent Show Playback Menu Display the playback menu to allow control of the currently play ing music without leaving the plugin Select Bookma...

Page 131: ... txt is created in the root di rectory of your player listing all the changes 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 Ask for Removal Selecting this option brings up a dialogue with two options press Select to confirm deletion or any other key to cancel Remove if not Used Selectin...

Page 132: ...late average bit rate time information and to more accurately fwd rew in the stream This function is especially useful when the playback of a file skips fwd rew does not work correctly or the time display is incorrect To use this plugin open the Context Menu see section 4 1 2 page 23 upon a mp3 file and select Open With vbrfix Note VBRfix can only run when music is turned off since it uses the sam...

Page 133: ... zxboxq z80 Save Snapshot Saves a snapshot of the current state You would enter the full path and desired name for example games zx snapshots chuckie sna The snapshot format will be chosen after the extension you specified per default z80 will be taken in case you leave it open Toggle Fast Mode Toggles fastest possible emulation speed no sound maximum frameskip etc This is Useful when loading tape...

Page 134: ...ul tools can be found at the World of Spectrum site http www worldofspectrum org utilities html 11 4 Applications 11 4 1 Alarm Clock This plugin is an alarm clock which resumes a paused song at a given time Key configuration Key Remote Key Action Left Right Rewind Forward Switch between hours minutes selection Up Down Play Display Increase Decrease hours minutes Select Set the alarm Power Exit Set...

Page 135: ...not deleted Information explained At the top of the battery_bench txt file is various information on how to use the plugin followed by the data themselves Time This column reports the total time of operation of the player It is not the time that you started the plug in If you have your player on for 5 minutes and then start the plugin it will start measuring from 5 minutes Seconds The same as Time...

Page 136: ...o disk in order to save them it is possible that should Rockbox shut down due to low battery then there will not be enough power remaining to write the data to disk Therefore all measurements since the previous save will be lost 11 4 3 Calculator Figure 11 46 Calculator This is a simple scientific calculator for use on the player It works like a standard calculator Pressing the 1st and 2nd buttons...

Page 137: ...n select what day is first day of week by the setting First Day of Week in the menu Key Remote Key Action Left Right Up Down Move the selector Select Show memos for the selected day Menu Up Down Previous Next month Power Quit 11 4 5 Chess Clock Figure 11 48 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 Roc...

Page 138: ...below is the time remaining for that round and possibly also the total time left if different Keys are as follows Key Remote Key Action Power Exit plugin Display Restart round for the current player Select Pause the time press again to continue Up Switch to next player Down Switch to previous player Menu Open menu Select to select From the menu it is possible to delete a player modify the round ti...

Page 139: ...de Selector Opens a menu from which you can select a clock mode to view Counter Settings Opens a menu from which you can adjust settings pertaining to the counter Mode Settings Opens a menu from which you can adjust settings pertaining to the current clock mode analog digital binary General Settings Reset Settings Reset all settings to their default values Save Settings Save all settings to disk S...

Page 140: ...ate readout if enabled is displayed at the bottom center The Second readout if in Text mode is displayed at the top center if in Bar mode is displayed as a progress bar at the top of the LCD if in Invert mode will invert the LCD left to right as the seconds pass a fully inverted LCD means the entire minute has passed The Counter if displayed is shown at the upper left The Blinking Colon if enabled...

Page 141: ...ing you will see is the text input screen Type part of a word or the whole word or anything the dict files have a definition to and accept the text input The plugin will search for matching entries on the dict index file and display according description meaning contained in the dict desc file If no matches are found on the dictionary a Not found message will be displayed and the plugin will exit ...

Page 142: ... Algorithm with a key derived using md5 Using Keybox To get started start up the plugin and select Enter Keybox The first time you enter Keybox you will be prompted for a master password and for confirmation of the master password The master password is the password that you must use to access your stored passwords Once inside enter the context menu by pressing Long Select From the context menu yo...

Page 143: ...T tags in mp3 files lrc8 files are the same as lrc files except that they are UTF8 encoded The Lyrics3 tag is not supported Supported tags and formats for lrc files The following tags are supported ti title ar artist offset offset msec Each line should resemble one of the following time tag line time tag time tag line time tag word time tag word word time tag word time tag The time tag must be in ...

Page 144: ...yrics The name of this directory can be customized see below If the audio file currently playing is Music Artist Album Title mp3 then the fol lowing files will be searched for in this order ext is one of the supported extensions from the list above and will be searched for in the same order as in that list Music Artist Album Title ext Music Artist Title ext Music Title ext Title ext Music Artist A...

Page 145: ...gs 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 Display Settings Change how the lyrics are displayed Wrap Breaks lines at white space Wipe Wipes the text Alignment Align text to the left centre or right Activate Only Current Line Activate only the c...

Page 146: ...Up Swap the selected menu item with the previous one 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 or Display or Power 11 4 13 md5sum Open a file a directory or just launch it from the plugin menu to creat...

Page 147: ...preprogrammed metronome track consisting out of multiple parts each with possibly different properties In contrast to the simple mode there exists the notion of meter and bars along with emphasis on certain beats 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 differing tempo a...

Page 148: ... das nasophon de klick Actually the goal is to keep compatibility between klick and this Rockbox metronome The parts of a track are specified one line each in this scheme pieces in optional name bars meter tempo tempo2 accel accel pattern volume The bar count and tempo always have to be specified the rest is optional One example is part I 12 3 4 133 for a part named part I 12 bars long in 3 4 mete...

Page 149: ...6 120 x x X X Xx X X The 12 12 for the shuffle create 1 4 triplets Just do a bit of math This is still a metronome not a drum machine but it can act like a basic one helping you to figure out a certain rhythm within the meter The UI is developed so that it fits into the display of a Sansa Clip and that is the hardware device it is tested on It seems to work reasonably on some other models in the s...

Page 150: ...de a scannable QR code that encodes a OTP URI In order to use those first scan the QR code separately and save the URI to a file on your device If necessary rewrite the URI so it is in the format shown above For example GitHub s URI has a slash after the provider In order for this URI to be properly parsed you must rewrite the account name so that it does not contain a slash Manual Import If direc...

Page 151: ... viewing of details of elements giving a detailed output for each selection Navigate the table using the directional keys pressing back or exit exits the plugin Key Remote Key Action Up Down Left Right Play Display Rewind Forward Move cursor Power Quit 11 4 18 Random Folder Advance Configuration This plugin is used to configure the folders which will be considered when the Auto Change Directory fe...

Page 152: ...layback Quit Folder List Editor Keys Key Remote Key Action Select or Right Forward Delete selected folder Long Select Long Forward Bring up the context menu which allows you to remove the selected folder or its entire folder tree Left or Display or Power Rewind Exit 11 4 19 Resistor Calculator Figure 11 50 Resistor calculator The resistor calculator is a plugin that works in 3 modes Colour to Resi...

Page 153: ...st common and a safe bet and the current that it will draw likewise with the first option Then use the onscreen keyboard to type in the supply voltage and if selected the custom forward current 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 11 4 20 Stats Figure 11 51 Th...

Page 154: ...e If you start the Text Editor from the plugin browser you will be greeted with a blank screen When started from the Open with menu item your file should be shown on 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 Virtual Keyboard see section 4 1 3 page 25 Move the selection bar to the line you want to edit Edit the highlighte...

Page 155: ...mote Key Action Select or Right Forward Edit Line Select Character Left or Display or Power Rewind Exit Abort Editing Menu Heart Show Item Menu Long Select Long Forward Delete Line The Rockbox manual version 3 14 Olympus m robe 100 ...

Page 156: ...en The following configuration example will change the main menu so that it will contain only the items for the file browser for resuming the playback and for changing the settings the latter will be added automatically Example root menu order files wps To reset the menu items to the default use root menu order i e use a hyphen instead of items This configuration entry can only be created and edit...

Page 157: ...mum of 24 characters long If your language is not yet supported and you want to write your own language file find the instructions on the Rockbox website ZLangFiles 12 1 5 UI Viewport By default the UI is drawn on the whole screen This can be changed so that the UI is confined to a specific area of the screen by use of a UI viewport This is done by adding the following line to the cfg file for a t...

Page 158: ...eme you must save the theme files with UTF 8 character encoding This can be done in most editors for example Notepad in Windows 2000 or XP but not in 9x ME can do this Files Locations Each different themeable aspect requires its own file WPS files have the extension wps FM screen files have the extension fms and SBS files have the extension sbs The main theme file has the extension cfg All files s...

Page 159: ...ewports will be drawn over any other viewports already drawn onto that area of the screen Viewport Declaration Syntax V x y width height font font is a number 0 is the built in system font 1 is the current menu font and 2 9 are additional skin loaded fonts see section 12 2 4 page 160 Only the coordinates have to be specified Leaving the other definitions blank will set them to their default values...

Page 160: ...t through the SBS file and to conditionally select different UI viewports Vi label This viewport is used as Custom UI Viewport in the case that the theme doesn t have a ui viewport set in the theme cfg file Having this is strongly recommended since it makes you able to use the SBS with other themes If label is set this viewport can be selectivly used as the Info Viewport using the VI tag The param...

Page 161: ...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 Next Song Info You can display information about the next song the song that is about to play after the one currently playing unless you change the plan If you use the upper case versions of the three tags F I and D they will instead refer to the next song inste...

Page 162: ...r 2 seconds Display current and remaining track time for 3 seconds repeat Conditionals can be used with sublines to display a different set and or number of sublines on the line depending on the evaluation of the conditional Example subline with conditionals Example it t 8 s it s fn ia t 3 s ia t 0 The format above will do two different things depending if ID3 tags are present If the ID3 artist an...

Page 163: ...a id id pb pc pt That is tracknum title artist album where most fields are only displayed if avail able Could also be rendered as filename or tracknum title artist 12 3 Managing Rockbox Settings 12 3 1 Introduction to cfg Files Rockbox allows users to store and load multiple settings through the use of configuration files A configuration file is simply a text file with the extension cfg A configur...

Page 164: ...Rockbox options You can create configuration files that change only certain set tings So for example suppose you typically use the player at one volume in the car and another when using headphones Further suppose you like to use an inverse LCD when you are in the car and a regular LCD setting when you are using headphones You could create configuration files that control only the volume and LCD se...

Page 165: ... extension and is used to store all of the sound related settings Save Theme Settings This option writes a cfg file to your player s disk The config uration file has the cfg extension and is used to store all of the theme related settings 12 4 Firmware Loading 12 4 1 Using ROLO Rockbox Loader Rockbox is able to load and start another firmware file without rebooting You just play a file with the ex...

Page 166: ...tion 4 3 2 page 31 12 5 5 Audio format and bitrate In general the fastest decoding audio format will be the best in terms of battery runtime on your player An overview of different codec s performance on different players can be found at ZCodecPerformanceComparison Your target uses a hard disk which consumes a large amount of power while spinning up to several hundred mA The less often the hard di...

Page 167: ...t fnt Change the user interface font to this one Image jpg View the JPEG image Link link Display list of target files and di rectories selecting one jumps to the target See section 11 3 1 page 119 Language File lng Load the language file Playlist m3u m3u8 Load the playlist and start playing the first file Rockbox firmware mi4 Load the new firmware with ROLO Video mpg mpeg mpv m2v Play the MPEG1 2 ...

Page 168: ... Layer 1 2 3 Musepack mpc Supports SV7 and SV8 in mono stereo OGG Vorbis ogg oga Playback of some old floor 0 files may fail on low memory targets Files with album art larger than available RAM will be skipped Chained Ogg files are not supported Sony Audio oma aa3 rm ra rmvb Supports ATRAC3 RealAudio rm ra rmvb Supports RealAudio G2 Cook Speex spx Dialogic telephony type vox Windows Media Audio St...

Page 169: ...e Lossless Audio flac Supports multichannel playback in cluding downmixing to stereo Apple Lossless m4a mp4 Shorten shn Seeking not supported True Audio tta Wave64 w64 Supports same formats as Wave form audio format Waveform audio format wav Linear PCM 8 16 24 32 bit IEEE float 32 64 bit ITU T G 711 a law µ law Microsoft ADPCM In tel DVI ADPCM IMA ADPCM 2 3 4 5 bit Dialogic OKI AD PCM YAMAHA ADPCM...

Page 170: ...racks instead of seconds MSX Konami Sound System kss Progress bar and seek use subtracks instead of seconds SMS GG CV Sound Format sgc Supports Sega Mas ter System and Game Gear Sound Format Progress bar and seek use subtracks instead of seconds Video Game Music Format vgm Gzipped Video Game Music Format vgz MOD mod NES Sound Format nsf nsfe Progress bar and seek use subtracks instead of seconds A...

Page 171: ...rmat x x x Wavpack x x x Atari Sound Format x Synthetic music Mobile Application Format x x Game Boy Sound Format x AY Sound Chip Music x Hudson Entertainment System Sound Format x MSX Konami Sound System x SMS GG CV Sound Format x Video Game Music Format x x Gzipped Video Game Music Format x x MOD x NES Sound Format x Atari SAP x Sound Interface Device x SPC700 x Note The seek implementations of ...

Page 172: ...wma wmv asf Codec specific mmf mod nsf nsfe sap sid spc gbs ay kss sgc vgm None a52 ac3 adx oma aa3 aif aiff au snd shn vox w64 wav cmc cm3 cmr cms dmc dlt mpt mpd hes vgz B 2 1 Featureset for generic metadata tags Feature ID3 APE Vorbis MP4 ASF Embedded albumart bmp Embedded albumart jpg x x x x Embedded albumart png Embedded cuesheet x x Replaygain information x x x x x Title string x x x x x Ar...

Page 173: ... sid nsf nsfe gbs ay sgc vgm Genre tta spc sap Disc tta Track tta Year spc sid sap Composer mmf Comment spc rm ra rmvb vgm Albumartist None Grouping None B 2 3 Limitations of metadata handling 1 Multiple tags e g for Genre are not supported The first tag item of a set of multiple tags is used 2 Only one tag type is supported for each audio format 3 Overall there are 900 bytes available to load met...

Page 174: ...ges require much more memory to decode C 2 Where to put album art The pictures can be named a number of different ways and placed to a number of different locations You can have pictures specific to the file or the album or use a generic picture You can place the picture in the same directory as the file in the parent directory or in a fixed directory named rockbox albumart The order Rockbox uses ...

Page 175: ...bumtitle bmp or albumartist albumtitle bmp Doublequotes will be replaced by single quotes If no album artist is set artist will be used instead See ZAlbumArt in the wiki for programs that will help you automate the process of putting album art on your player The Rockbox manual version 3 14 Olympus m robe 100 ...

Page 176: ...ne which will not be shown in the WPS D 2 Hardware Capabilities Tag Description cc Check for presence of a real time clock returns c when used unconditionally tp Does this target have a radio Tp Indicates that the target has a touchscreen With the above tags it is possible to find out about the presence of certain hardware and make the theme adapt to it This can be very useful for designing a them...

Page 177: ...ports Tag Description V x y width height font See section 12 2 2 Vl identifier 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 Vd identifier Display the identifier viewport E g C Vd a Vd b will show viewport a if album art is found and b if it isn t Vi label Declare a Custom UI Viewport The paramet...

Page 178: ...re the value 1 is used when the battery level isn t known it usually is The value N is only used when the battery level is ex actly 100 percent An image can also be used the propor tion of the image shown corresponds to the battery level bl x y width height image bmp bv The battery level in volts bt Estimated battery time left bp p if the charger is connected only on targets that can charge batter...

Page 179: ...pcsv8 aache ay gbs hes sgc vgm kss unknown The codec or der is as shown above ff File Frequency in Hz fk File Frequency in kHz fm File Name fn File Name without extension fp File Path fs File Size in Kilobytes fv avg if variable bit rate or empty string if constant bit rate d N N th segment from the end of the file s directory N can be 1 2 3 Example for the d N commands If the file is Rock Kent Is...

Page 180: ...ck time pv Current volume in dB Can also be used in a conditional pv Mute 0 dB Above 0 dB Mute is 0 volume is the values between Mute and max 0 dB is max volume and Above 0 dB is amplified volume This can also be used like pb to provide a continuous scale pv x y width height image bmp pS Track is starting An optional number gives how many seconds the tag remains true for after the start of the tra...

Page 181: ...ion then either the track title from the tags or the filename The viewer will display as many tracks as will fit in the viewport D 11 Runtime Database Tag Description rp Song playcount rr Song rating 0 10 This tag can also be used in a conditional tag rr 0 1 2 3 4 5 6 7 8 9 10 ra Autoscore for the song D 12 Sound DSP settings Tag Description Sp Current playback pitch xf Crossfade setting in the or...

Page 182: ...mm Off All One Shuffle A B D 16 Playback Mode Tag Description mp 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 Tag Description cs The current screen 1 20 in the order shown below The Rockbox manual version 3 14 Olympus m robe 100 ...

Page 183: ...io some values will never be returned Examples You are in the cs Main menu WPS Recording screen FM Radio screen if cs 2 This is the WPS D 18 List Title sbs only Tag Description Lt Title text Should be used in a conditional so that non list screens don t show a title when they shouldn t Li Title icon This uses the same order as custom icons see ZCustomIcons in the wiki except that here 0 is no icon...

Page 184: ...ed It can produce neat effects when used with conditional viewports Example mv 2 5 Volume changing pv The example above will display the text Volume changing if the volume is being changed and 2 5 seconds after the volume button has been released After that it will display the volume value D 20 Settings Tag Description St setting name The value of the Rockbox setting with the specified name See se...

Page 185: ...ts to 0 if both x and y are not speci fied nimages optional number of sub images tiled vertically of the same height contained in the bitmap Default is 1 xd n i tag offset Display a preloaded image n image ID as it was specified in x or xl i optional number of the sub image to display a z for 1 26 and A Z for 27 52 ignored when tag is used Only useable if the ID is a single letter By default the f...

Page 186: ...ts D 22 Alignment and language direction Tag Description al Align the text left aL Align the text left or to the right if RTL language is in use ac Centre the text ar Align the text right aR Align the text right or to the left if RTL language is in use ax The next tag should follow the set language direction When prepended to a viewport declaration the viewport will be horizontally mirrored if the...

Page 187: ...he tag parameters are true or tag1 tag2 tagN Logical or operator Will be evaluate to true if any of the tag parameters are true Examples of the if tag if pv 0 Clipping possible Volume OK will display Clipping possible if the volume is higher than or equal to 0 dB Volume OK if it is lower if ia Ia same artist this artist and the next artist are the same Note When performing a comparison against a s...

Page 188: ...eekday name cb Month name cu Day of week from 1 to 7 1 is Monday cw Day of week from 0 to 6 0 is Sunday D 26 Text Translation Tag Description Sx English Display the translation of English in the current language English must be a phrase used in the language file It should match the Source line in the language file Note checkwps cannot verify that the string is correct so please check on either the...

Page 189: ...abel of the desired image backdrop 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 nofill don t draw the bar only its frame for use with the slider option noborder don t draw the border for image less bars instead maximise the filling over the specified area This doesn t work for bars...

Page 190: ...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 Tag Description The character The character The character The character The character The character The character The character The character s Indicate that the line should scroll Can occur anywhere in a line given that the text is displayed see conditionals above You c...

Page 191: ... A antiskip 5s 15s 30s 1min 2min 3min 5min 10min N A volume fade on off N A sort case on off N A show files all supported music playlists N A show filename exts off on unknown view_all N A follow playlist on off N A playlist viewer icons on off N A playlist viewer indices on off N A playlist viewer track display track name full path N A recursive directory insert on off ask N A scroll speed 1 to 2...

Page 192: ... s battery capacity devise a way to get ranges from config h mAh usb hid on off N A usb keypad mode multimedia presentation browser mouse N A qs top any setting name for none N A qs bottom any setting name for none N A qs left any setting name for none N A qs right any setting name for none N A shortcuts instead of quickscreen off on N A idle poweroff off 1 2 3 4 5 6 7 8 9 10 15 30 45 60 min sleep...

Page 193: ... alpha oldest newest N A sort interpret number digits numbers N A tagcache_autoupdate on off N A warn when erasing dynamic playlist on off N A cuesheet support on off N A folder navigation off on random N A constrain next folder off on N A gather runtime data off on N A skip length outro track 1s 2s 3s 5s 7s 10s 15s 20s 1min 90s 2min 3min 5min 10min 15min N A prevent track skip on off N A start in...

Page 194: ...ff in Hz q 0 to 64 gain 240 to 240 eq peak filter 4 cutoff in Hz q 0 to 64 gain 240 to 240 eq peak filter 5 cutoff in Hz q 0 to 64 gain 240 to 240 eq peak filter 6 cutoff in Hz q 0 to 64 gain 240 to 240 eq peak filter 7 cutoff in Hz q 0 to 64 gain 240 to 240 eq peak filter 8 cutoff in Hz q 0 to 64 gain 240 to 240 eq high shelf filter cutoff in Hz q 0 to 64 gain 240 to 240 0 1 dB dithering enabled ...

Page 195: ... to 100 dB or statusbar off top bottom N A remote statusbar off top bottom N A scrollbar off left right N A scrollbar width 3 to LCD width 10 devise a way to get ranges from config h pixels volume display graphic numeric N A battery display graphic numeric N A font path filename fnt N A kbd path filename kbd N A invert on off N A flip display on off N A selector type pointer bar inverse N A show i...

Page 196: ...Appendix F Menu Overview 196 F Menu Overview include an overview of the menu structure here The Rockbox manual version 3 14 Olympus m robe 100 ...

Page 197: ...id and what happened Whether the problem is repeatable or a one time occurrence All relevant data regarding the problem such as playlists MP3 files etc IMPORTANT G 2 Feature ideas 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 ther...

Page 198: ...nderstand them Add scandisk like features It would be a very slow operation that would drain the batteries and take a lot of useful ram for something that is much better and faster done when connected to a host computer Alphabetical list skipping Skipping around the lists by jumping letters i e skip all C s and go straight to the first D This isn t feasible with the current list implementation if ...

Page 199: ...Frederic Dang Ngoc Pierre De lore Huw Smith Garrett Derner Barry McIntosh Leslie Donald son Lee Pilgrim Zakk Roberts Francois Boucher Matthias Wien tapper Brent Coutts Jens Arnold Gerald Vanbaren Christi Scarbor ough Steve Cundari Mat Holton Jan Gajdos Antoine Cellerier Brian King Jiri Jurecek Jacob Erl beck Jean Philippe Bernardy Dave Hooper Jonas Häggqvist Thom Johansen Rinat Zakirov Manuel Dejo...

Page 200: ...Ginkel Adam Gashlin Robert Kukla David Quesada Jared Stafford Martin Hensel Stéphane Doyon Austin Appel Andre Smith Travis Hyyppa Ian Webber Pavel Gnelitsa Lutz Böhne Will Robertson Robert Carboneau Ye Wei Bryan Childs Mike Schmitt Chris Taylor Tobias Langhoff Steve Gotthardt Greg White Mattieu Favréaux Malcolm Tyrrell Piotr Jafis zow Gary Allen John BouAntoun Tomasz Mon Jakub Matoušek Al bert Vel...

Page 201: ...Wallace Eric Lassauge François Dinel Francesco Rigoni Joël Puik Klaas Bosteels Teruaki Kawashima Marcin Łukasik Le Jin Alex Ben nee Stéphane Quertinmont Bartosz Fabianowski Adam Hogan Andrew Mahone Anton Veretenenko Vi cente Ibarra Rui Araújo Brian Cloutier Olivier Barbut Yoshi hisa Uchida Sanggon Lee Kaspar Rothenfußer Ryan Press Craig El liott Kenderes Tamas Eric Shat tow Joshua Simmons Sei Aoyu...

Page 202: ...lav Chizhik Desu Rozen Olivier Kaloudoff Kessia Pinheiro Jean Louis Biasini Lorenzo Miori James Hunt Artur Juraszek Wieland Hoffmann Nathan Ko rth Igor Petelin Cástor Muñoz Albert Barca Fukuda Takafumi Dimitar Dimitrov Osborne Jacobs Marty Miller Eduardo Gonzalez Enric Morales Mateusz Renkiewicz Dario Castellarin Thiago Kenji Okada Manuel Flury Vanja Cvelbar Richard Quirk Kirill Stryaponoff Roman ...

Page 203: ...ch is a copyleft license designed for free software We have designed this License in order to use it for manuals for free software be cause free software needs free documentation a free program should come with manuals providing the same freedoms that the software does But this License is not limited to software manuals it can be used for any textual work regardless of subject matter or whether it...

Page 204: ...cation is available to the general public that is suitable for re vising the document straightforwardly with generic text editors or for images composed of pixels generic paint programs or for drawings some widely available drawing edi tor and that is suitable for input to text formatters or for automatic translation to a variety of formats suitable for input to text formatters A copy made in an o...

Page 205: ...s under the same conditions stated above and you may publicly display copies 3 COPYING IN QUANTITY If you publish printed copies or copies in media that commonly have printed covers of the Document numbering more than 100 and the Document s license notice requires Cover Texts you must enclose the copies in covers that carry clearly and legibly all these Cover Texts Front Cover Texts on the front c...

Page 206: ...vious version if the original publisher of that version gives permission B List on the Title Page as authors one or more persons or entities responsible for authorship of the modifications in the Modified Version together with at least five of the principal authors of the Document all of its principal authors if it has fewer than five unless they release you from this requirement C State on the Ti...

Page 207: ...ew front matter sections or appendices that qualify as Secondary Sections and contain no material copied from the Document you may at your option designate some or all of these sections as invariant To do this add their titles to the list of Invariant Sections in the Modified Version s license notice These titles must be distinct from any other section titles You may add a section Entitled Endorse...

Page 208: ...nts released under this License and replace the individual copies of this License in the various docu ments with a single copy that is included in the collection provided that you follow the rules of this License for verbatim copying of each of the documents in all other respects You may extract a single document from such a collection and distribute it individ ually under this License provided yo...

Page 209: ...stribute the Document is void and will automatically terminate your rights under this License However parties who have received copies or rights from you under this License will not have their licenses terminated so long as such parties remain in full compliance 10 FUTURE REVISIONS OF THIS LICENSE The Free Software Foundation may publish new revised versions of the GNU Free Doc umentation License ...

Page 210: ...tions Front Cover Texts and Back Cover Texts replace the with Texts line with this with the Invariant Sections being LIST THEIR TITLES with the Front Cover Texts being LIST and with the Back Cover Texts being LIST If you have Invariant Sections without Cover Texts or some other combination of the three merge those two alternatives to suit the situation If your document contains nontrivial examples...

Page 211: ...ns that forbid anyone to deny you these rights or to ask you to surrender the rights These restrictions translate to certain responsibilities for you if you distribute copies of the software or if you modify it For example if you distribute copies of such a program whether gratis or for a fee you must give the recipients all the rights that you have You must make sure that they too receive or can ...

Page 212: ...ep intact all the notices that refer to this License and to the absence of any warranty and give any other recipients of the Program a copy of this License along with the Program You may charge a fee for the physical act of transferring a copy and you may at your option offer warranty protection in exchange for a fee 2 You may modify your copy or copies of the Program or any portion of it thus for...

Page 213: ... you also do one of the following a Accompany it with the complete corresponding machine readable source code which must be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange or b Accompany it with a written offer valid for at least three years to give any third party for a charge no more than your cost of physically performing source distri...

Page 214: ...s and conditions You may not impose any further restrictions on the recipients exercise of the rights granted herein You are not responsible for enforcing compliance by third parties to this License 7 If as a consequence of a court judgment or allegation of patent infringement or for any other reason not limited to patent issues conditions are imposed on you whether by court order agreement or oth...

Page 215: ...at version or of any later version published by the Free Software Foundation If the Program does not specify a version number of this License you may choose any version ever published by the Free Software Foundation 10 If you wish to incorporate parts of the Program into other free programs whose distribution conditions are different write to the author to ask for permission For software which is ...

Page 216: ...at least the copyright line and a pointer to where the full notice is found one line to give the program s name and a brief idea of what it does Copyright C year name of author This program is free software you can redistribute it and or modify it un der the terms of the GNU General Public License as published by the Free Software Foundation either version 2 of the License or at your option any la...

Page 217: ...chool if any to sign a copyright disclaimer for the program if necessary Here is a sample alter the names Yoyodyne Inc hereby disclaims all copyright interest in the program Gnomovision which makes passes at compilers written by James Hacker signature of Ty Coon 1 April 1989 Ty Coon President of Vice This General Public License does not permit incorporating your program into propri etary programs ...

Reviews: