## Welcome to Gerbera

Gerbera is an open source UPnP-AV media server.

Username
Password

#### Add some files

Browse and import your multimedia files into Gerbera.

#### Browse indexed files

View, update and remove files from Gerbera.

#### Search indexed entries

Find files managed by Gerbera.

#### Show connected clients

View clients detected by Gerbera and their profile details.

#### Edit Configuration

Change settings for Gerbera.
Default
Light
Dark

#### Server Statistics

File Type | Count | Size
--- | --- | ---
General |  |
Audio |  |
Music Tracks |  |
Audiobooks |  |
Audio Broadcasts |  |
Videos |  |
Movies |  |
Video Broadcasts |  |
Music Video Clips |  |
Images |  |
Photos |  |
Text |  |
Total Media Files |  |

## Getting Started

If you are seeing this page it means the server is running successfully!

Take a minute to check out the documentation

#### Adding Content

There are two methods to add library paths:

1. ##### Set up Gerbera with dynamic content

   Easier to create but all setup is lost when your database is lost

   1. Go to File System view
   2. Look for folders containing your media files
   3. Click Add Autoscan Item
   4. Wait for import to complete
   5. Check logs for error messages

2. ##### Set up Gerbera with persistent content

   A bit more complicated but safer in the long run

   1. Add an Autoscan entry in config.xml ( See documentation )
   2. Adjust further settings as required
   3. Restart Gerbera service
   4. Wait for import to complete
   5. Check logs for error messages

### Search

Please use UPnP syntax for Query and Sort

- Query: upnp:class derivedfrom "object.item" and dc:title contains "music"
- Sort: -dc:title

##### Edit Item

ID
Parent ID
Type
Title
Location
Class
Sort Key
Description
Mimetype
Protocol
Flags
Restricted
Searchable
UseResourceRef
PersistentContainer
PlaylistRef
ProxyUrl
OnlineService
OggTheora
Last Modified
Last Updated

##### Edit Autoscan

This is a persistent autoscan directory (defined in config), it cannot be modified via the web UI.
ID:
Scan Mode
None Disable autoscanning for this directory
INotify Efficiently and quickly update based on system filesystem events. This is the suggested method unless the underlying system does not support it.
Timed Re-scans the directory at set intervals. Resource intensive if run too often.
Manual Scans have to be started manually
Recursive
Recursive Descend into child directories and index them.
Include Hidden
Include Hidden Files and Folders Include hidden files/directories
Follow Symlinks
Follow Symbolic Links Follow symbolic links and import them.
Apply Directory Types
Apply UPnP Directory Types Set UPnP Directory Type based on content.
Force Rescan
Force Rescan of Unknown Files Rescan unknown files on restart to fix missing properties.
Scan Interval (in seconds)
Number of Scan Retries
Audio
All Audio
Music
Audio Book
Audio Broadcast
Import audio files from directory.
Image
All Images
Photo
Import image files from directory.
Video
All Video
Movie
TV
Music Video
Import video files from directory.
Audio Container
Container type for audio files
Image Container
Container type for image files
Video Container
Container type for video files

##### Edit Directory Tweak

Location:
Inherit settings to subdirs:
Follow Symbolic Links:
Recursive import:
Include hidden files/directories:
Case sensitive resources:
Metadata Charset
Fan Art File
Subtitle File
Resource File