Skip to content

File Browser

project-owner edited this page Mar 2, 2024 · 19 revisions

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:

fb

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-image

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

Contents

Clone this wiki locally