digikam-doc/post_processing/media_server.rst

0001 .. meta::
0002    :description: The digiKam Tool to Share With DLNA
0003    :keywords: digiKam, documentation, user manual, photo management, open source, free, learn, easy, dlna, upnp, share
0004
0005 .. metadata-placeholder
0006
0007    :authors: - digiKam Team
0008
0009    :license: see Credits and License page for details (https://docs.digikam.org/en/credits_license.html)
0010
0011 .. _media_server:
0012
0013 Media Server
0014 ============
0015
0016 .. contents::
0017
0018 DLNA Media-Server is used to automatically export digiKam photos through the local network to other `DLNA-compliant devices <https://en.wikipedia.org/wiki/Digital_Living_Network_Alliance>`_ like smart phones, TV, and tablets.
0019
0020 To start the media-server, head to the **Tools** tab from the **Right Sidebar**. You will find the **Share with DLNA** icon on the list. You can also start it from the :menuselection:`Tools --> Share with DLNA` menu entry. The media-server window will open as follows:
0021
0022 .. figure:: images/dlna_media_server.webp
0023     :alt:
0024     :align: center
0025
0026     The DLNA Media-Server Dialog
0027
0028 To share items just select your desired **Albums** from the nested lists. You can share from physical **Albums**, or virtual **Tags**, **Searches**, and **Labels**. When the selection is done, press the **Start** button, a wheel on the right side will indicate that server is currently running.
0029
0030 You can hide this media-server window (without closing the actual server) using the **Ok** button. If you want shutdown the server, re-open the Media-Server dialog and press the **Stop** button. Note that the files and folders you specify will be saved for you to use in later sessions.
0031
0032 Use the option **Start Server at Startup** if you want to run the media-server automatically once you start digiKam.
0033
0034 .. figure:: images/dlna_server_running.webp
0035     :alt:
0036     :align: center
0037
0038     The DLNA Media-Server is Running and can be Closed with the Stop Button
0039
0040 After you start the media-server, you might have to wait for about 30 seconds to one minute before other devices in the network can see your server, so please be patient.
0041
0042 This server was tested with some client applications. This list includes:
0043
0044     - GUPnP AV (PC - archlinux)
0045
0046     - Kodi media player (Android TV)
0047
0048     - BubbleUPnP (Android Tablet)
0049
0050     - MediaHouse (Android Phone)
0051
0052     - AnDLNA (Android)
0053
0054     - VLC media player 3.0.16 (PC - Ubuntu) - Note: Older versions of VLC do not work properly.
0055
0056 .. figure:: images/dlna_contents_vlc.webp
0057     :alt:
0058     :align: center
0059
0060     The Shared Contents from digiKam Discovered Over the Network by VLC Media Player