View Files with Plugins

A viewer-plugin is a plugin that is programmed just like any other plugin, but acts to display, edit, write or otherwise deal with a file.

Viewer plugins are kept in ".rockbox/viewers/". They can be used to browse a file when invoked with the ON+PLAY menu choice "view with" and they are invoked when a file with its associated registered extension is used.

The extension <=> plugin connection is set in the ".rockbox/viewers.config" file.

Below follows an example showing the file format of the viewers.config file. The 6 hexadecimal digits are the icon for the extension that shows up in the file browser.

ch8,viewers/chip8,70 70 7f 7f 70 70
txt,viewers/viewer,55 55 55 55 55 55
jpg,viewers/jpeg,18 24 3C 3C 24 18
ucl,viewers/rockbox_flash,2A 7F 41 41 7F 2A
rvf,viewers/video,5D 7F 5D 7F 5D 7F
mp3,viewers/vbrfix,10 08 58 38 04 02
m3u,viewers/search,00 00 00 00 00 00
txt,viewers/sort, 00 00 00 00 00 00