File Browser - project-owner/Peppy.doc GitHub Wiki

File Browser screen allows to navigate through the file system and select audio files for playback. The screen can be opened from the File Player screen and consists of the following components:

If folder contains one of the image files listed in the property folder.images then that image will be scaled down and displayed as folder icon in the Folder/File menu. If folder doesn't have such images then the default folder icon will be displayed instead.

If audio file in MP3 or FLAC format has an embedded image then that image will be displayed in the file browser instead of the default file icon. Only the first image will be displayed if the file has multiple embedded images. The same image will be displayed in the file player. The following screenshots show embedded images for each FLAC file in the file browser and in the file player.

File Types

The file browser will display only items of four types:

Icon	Type	Description
	Audio File	Files with extensions aac, ac3, aiff, ape, flac, m4a, mp3, mp4, ogg, opus, wav, wma, wv
	Playlist	Files with extensions m3u and cue
	Image File	Files with extensions jpg, png, gif, tga, tif
	Folder	Folder which contains any files. It can be empty.

Performance

To improve the performance of the File Browser the functionality which is reading and processing images is disabled by default. That includes the functionality which reads and shows the folder image (e.g. folder.jpg), reads and shows the images embedded into the audio files and functionality which reads and shows the icons for the image files (e.g. jpg, png). The following properties control this functionality:

[file.browser]
...
enable.folder.images = False
enable.embedded.images = False
enable.image.file.icon = False

Property	False (default)	True
enable.embedded.images
enable.folder.images
enable.image.file.icon

Each enabled functionality will slow down the File Browser as it will need to read potentially large images and scale them down to the icon size. That will increase time required to show the folder content especially when folder contains many files.

Navigation

Icon	Name	Remote Control (WD TV)	Keyboard	Voice Command	Description
	Previous Page		Page Down	previous page	Switch to the previous page
	Home		Home	home, go home	Go to Home Screen
	Music Folder/User Home		M	music	Switch to the Music Folder (if present) or User Home
	Root Folder		R	root	Switch to OS Root Folder
	Parent Folder		P	parent	Go to the Parent Folder
	Back to File Player		Esc	back, go back	Go back to the File Player
	Next Page		Page Up	next page	Switch to the next page
	Left		Arrow key Left	left, go left	Select item on the left
	Right		Arrow key Right	right, go right	Select item on the right
	Up		Arrow key Up	up, go up	Select item above
	Down		Arrow key Down	down, go down	Select item below
	Select menu item		Enter	okay, select	Select highlighted menu item
	Voice Assistant				Activate/Deactivate Voice Assistant

<<Previous | Next>>