Add description for the shortcuts plugin (FS#8829 by Alexander Levin).
[Rockbox.git] / manual / plugins / main.tex
blobd7af3c4ada564a8c7a044985b8ce6b8c3605e5f1
1 % $Id$ %
2 \chapter{Plugins}\label{ref:plugins}
3 Plugins are little programs that Rockbox can load and run. Only one plugin can
4 be loaded at a time. Plugins have exclusive control over the user interface.
5 This means you cannot switch back and forth between a plugin and Rockbox, a
6 plugin is loaded, run and then exited, which returns control to Rockbox. Most
7 plugins will not interfere with music playback but some of them will stop
8 playback while running. Plugins have the file extension \fname{.rock}. Most of
9 them can be started from \setting{Browse Plugins} in the \setting{Main Menu}.
11 Viewer plugins get started automatically by opening an associated file (i.e.
12 text files, chip8 games), or from the \setting{Open with} option on the
13 \setting{Context Menu}.
15 \section{Games}
16 \opt{lcd_bitmap}
17 {See also the Chip{}-8 emulator in \reference{ref:Chip8emulator}
18 \opt{recorder,recorderv2fm,h1xx,m5,lcd_color}
19 {and Rockboy in \reference{ref:Rockboy}}.}
21 \opt{lcd_bitmap}{\input{plugins/blackjack.tex}}
23 \opt{lcd_bitmap}{\input{plugins/brickmania.tex}}
25 \opt{lcd_bitmap}{\input{plugins/bubbles.tex}}
27 \opt{lcd_bitmap}{\input{plugins/chessbox.tex}}
29 \opt{swcodec}{\input{plugins/doom.tex}}
31 {\input{plugins/flipit.tex}}
33 \opt{player}{\input{plugins/jackpot.tex}}
35 \opt{lcd_bitmap}{\input{plugins/jewels.tex}}
37 \opt{lcd_bitmap}{\input{plugins/minesweeper.tex}}
39 \opt{player}{\input{plugins/nim.tex}}
41 \opt{h1xx,m5,lcd_color}{\input{plugins/pacbox.tex}}
43 \opt{lcd_bitmap}{\input{plugins/pong.tex}}
45 \opt{lcd_bitmap}{\input{plugins/robotfindskitten.tex}}
47 {\input{plugins/rockblox.tex}}
49 \opt{lcd_bitmap}{\input{plugins/sliding.tex}}
51 \opt{lcd_bitmap}{\input{plugins/snake.tex}}
53 \opt{lcd_bitmap}{\input{plugins/snake2.tex}}
55 \opt{lcd_bitmap}{\input{plugins/sokoban.tex}}
57 \opt{lcd_bitmap}{\input{plugins/solitaire.tex}}
59 \opt{lcd_bitmap}{\input{plugins/spacerocks.tex}}
61 \opt{lcd_bitmap}{\input{plugins/star.tex}}
63 \opt{lcd_bitmap}{\input{plugins/sudoku.tex}}
65 \opt{lcd_bitmap}{\input{plugins/wormlet.tex}}
67 \opt{lcd_bitmap}{\input{plugins/xobox.tex}}
69 \section{Demos}
71 \opt{lcd_bitmap}{\input{plugins/bounce.tex}}
73 {\input{plugins/credits.tex}}
75 {\input{plugins/cube.tex}}
77 \opt{lcd_bitmap}{\input{plugins/demystify.tex}}
79 \opt{lcd_bitmap}{\input{plugins/fire.tex}}
81 {\input{plugins/logo.tex}}
83 \opt{lcd_bitmap}{\input{plugins/mandelbrot.tex}}
85 {\input{plugins/mosaic.tex}}
87 \opt{lcd_bitmap}{\input{plugins/oscilloscope.tex}}
89 \opt{lcd_bitmap}{\input{plugins/plasma.tex}}
91 {\input{plugins/snow.tex}}
93 \opt{lcd_bitmap}{\input{plugins/starfield.tex}}
95 \opt{lcd_bitmap}{\input{plugins/vumeter.tex}}
97 \section{\label{ref:Viewersplugins}Viewers}
99 Viewers are plugins which are associated with specific file extensions.
100 They cannot be run directly but are started by ``playing''
101 the associated file. Viewers are stored in the
102 \textbf{/.rockbox/viewers/ }directory.
104 {\input{plugins/shortcuts.tex}}
106 \opt{lcd_bitmap}{\input{plugins/chip8emulator.tex}}
108 \opt{lcd_bitmap}{\input{plugins/jpegviewer.tex}}
110 \opt{recorder,recorderv2fm,ondio}{\input{plugins/movieplayer.tex}}
112 \opt{lcd_color}{\input{plugins/mpegplayer.tex}}
114 \opt{recorder,recorderv2fm,ondio}{\input{plugins/rockbox_flash.tex}}
116 \opt{recorder,recorderv2fm,h1xx,m5,lcd_color}{\input{plugins/rockboy.tex}}
118 {\input{plugins/search.tex}}
120 {\input{plugins/sort.tex}}
122 {\input{plugins/text_viewer.tex}}
124 {\input{plugins/vbrfix.tex}}
126 \opt{recorder,recorderv2fm,ondio}{\input{plugins/wavplay.tex}}
128 \section{Applications}
130 \opt{player,recorder,recorderv2fm}{\input{plugins/alpinecdc.tex}}
132 {\input{plugins/batterybenchmark.tex}}
134 \opt{lcd_bitmap}{\input{plugins/calculator.tex}}
136 \opt{recorder,recorderv2fm}{\input{plugins/calendar.tex}}
138 {\input{plugins/chess_clock.tex}}
140 \opt{rtc}{\input{plugins/clock.tex}}
142 {\input{plugins/dice.tex}}
144 {\input{plugins/disktidy.tex}}
146 \opt{player}{\input{plugins/euro_converter.tex}}
148 \opt{recorder,recorderv2fm,ondio}{\input{plugins/firmware_flash.tex}}
150 {\input{plugins/metronome.tex}}
152 \opt{recorder,recorderv2fm,ondio}{\input{plugins/split_editor.tex}}
154 {\input{plugins/stats.tex}}
156 {\input{plugins/stopwatch.tex}}
158 \opt{lcd_bitmap}{\input{plugins/text_editor.tex}}