nik/FreedomBox
1
0
Fork 0
mirror of https://github.com/freedombox/FreedomBox.git synced 2026-02-18 08:33:41 +00:00
Code Issues Packages Projects Releases Wiki Activity
FreedomBox/doc/manual/en/MiniDLNA.raw.xml
James Valleroy 1e31f73e40
doc: Fetch latest manual 
Signed-off-by: James Valleroy <jvalleroy@mailbox.org>
2020-07-13 19:04:38 -04:00

1 line
14 KiB
XML
Raw Blame History

<?xml version="1.0" encoding="utf-8"?><!DOCTYPE article PUBLIC '-//OASIS//DTD DocBook XML V4.4//EN' 'http://www.docbook.org/xml/4.4/docbookx.dtd'><article><articleinfo><title>FreedomBox/Manual/MiniDLNA</title><revhistory><revision><revnumber>8</revnumber><date>2020-05-30 18:05:07</date><authorinitials>SunilMohanAdapa</authorinitials><revremark>Update the title to emphasize app name over its generic name</revremark></revision><revision><revnumber>7</revnumber><date>2020-05-27 00:16:26</date><authorinitials>SunilMohanAdapa</authorinitials><revremark>Add section on supported file formats</revremark></revision><revision><revnumber>6</revnumber><date>2020-05-26 22:31:38</date><authorinitials>SunilMohanAdapa</authorinitials><revremark>Minor styling</revremark></revision><revision><revnumber>5</revnumber><date>2020-05-26 22:29:28</date><authorinitials>SunilMohanAdapa</authorinitials><revremark>Add information about how to use in various devices/media players</revremark></revision><revision><revnumber>4</revnumber><date>2020-05-26 04:51:58</date><authorinitials>SunilMohanAdapa</authorinitials><revremark>Add note about not being available on OpenVPN</revremark></revision><revision><revnumber>3</revnumber><date>2020-05-23 19:54:42</date><authorinitials>JamesValleroy</authorinitials><revremark>add TableOfContents</revremark></revision><revision><revnumber>2</revnumber><date>2019-11-21 20:18:10</date><authorinitials>NektariosKatakis</authorinitials></revision><revision><revnumber>1</revnumber><date>2019-11-20 16:49:59</date><authorinitials>NektariosKatakis</authorinitials></revision></revhistory></articleinfo><section><title>MiniDLNA (Simple Media Server)</title><para>MiniDLNA is a media server with the aim to be compliant with DLNA/UPnP clients. </para><para>Note: This service is available only on networks configured as &quot;internal&quot; zone. It is not available when connected via OpenVPN. </para><section><title>What is UPnP/DLNA?</title><para>Universal plug &amp; play is a set of networking protocols that allow devices within a network such as PCs, TVs, printers etc. to seamlessly discover each other and establish communication for data sharing. It is zero configuration protocol and requires only a media server and a media player that are compliant with the protocol. </para><para>DLNA is derived from UPnP as a form of standardizing media interoperability. It forms a standard/certification which many consumer electronics conform to. </para></section><section><title>Setting up MiniDLNA on your FreedomBox</title><para>To install/enable the media server you need to navigate at MiniDLNA page and enable it. The application is intended to be available in the internal (home) network and therefore it requires a network interface configured for internal traffic. </para><para>After installation a web page becomes available on <ulink url="https://&lt;your-freedombox&gt;/_minidlna"/>. It includes information for how many files the server is detecting, how many connections exist etc. This is very useful if plugging external disks with media to check if the new media files are detected properly. If that is not happening, disabling and enabling the server will fix it. </para></section><section><title>Using MiniDLNA to play media on your devices</title><para>Any DLNA compliant device or media player should be able to automatically detect, browse and play media from MiniDLNA on FreedomBox. The following devices and media players have been tested: </para><itemizedlist><listitem><para><emphasis role="strong">GNOME Videos</emphasis>: Videos is the default media player on the popular GNU/Linux desktop environment GNOME. Open Videos, switch to 'Channels'. You should see a channel named 'freedombox: minidlna'. You will be able to browse and play media from it. </para></listitem><listitem><para><emphasis role="strong">VLC media player</emphasis>: VLC is a very popular media player for GNU/Linux, Android, Windows and macOS. Open VLC and click on 'View -&gt; Playlist'. In the playlist sidebar that appears, select 'Universal Plug'n'Play'. You should see an item named 'freedombox: minidlna'. You should be able to browse and play media from it. </para></listitem><listitem><para><emphasis role="strong">Kodi</emphasis>: Kodi is a popular media centre software with user interface designed for Televisions. Open Kodi, goto 'System -&gt; Service settings -&gt; UPnP/DLNA' and 'Enable UPnP support'. Then visit 'Home -&gt; Videos -&gt; Files -&gt; Add videos... -&gt; Browse -&gt; UPnP devices'. You should see 'freedombox: minidlna'. Select it and choose 'OK'. Then choose 'OK in the 'Add video source' dialog. From now on, you should see 'freedombox: minidlna' in 'Videos -&gt; Files' section. You should be able to browse and play media from it. See <ulink url="https://kodi.wiki/view/Settings/Services/UPnP_DLNA">Kodi documentation</ulink> for more information. </para></listitem><listitem><para><emphasis role="strong">Roku</emphasis>: Roku is an appliance connected to a TV for playing Internet streaming services. Many TVs also have Roku built into them. In Roku interface, find a channel called 'Roku Media Player' and open it. You should see an item called 'freedombox: minidlna'. You should be able to browse and play media from it. </para></listitem><listitem><para><emphasis role="strong">Rhythmbox</emphasis>: Rhythmbox is the default audio player on the popular GNU/Linux desktop environment GNOME. Open Rhythmbox and ensure that the side pane is open by clicking on 'Application menu -&gt; View -&gt; Side Pane'. In the side pane you should see 'freedombox:minidlna' under the 'Shared' section. You should be able to browse and play audio files from it. Video files will not show up. </para></listitem></itemizedlist></section><section><title>Supported media formats</title><para>MiniDLNA supports a wide variety of video and audio file formats. </para><itemizedlist><listitem><para><emphasis role="strong">Video</emphasis>: Files ending with .avi, .mp4, .mkv, .mpg, .mpeg, .wmv, .m4v, .flv, .mov, .3gp, etc. </para></listitem><listitem><para><emphasis role="strong">Audio</emphasis>: Files ending with .mp3, .ogg, .flac, .wav, .pcm, .wma, .fla, .aac, etc. </para></listitem><listitem><para><emphasis role="strong">Image</emphasis>: Files ending with .jpg, .jpeg </para></listitem><listitem><para><emphasis role="strong">Playlist</emphasis>: Files ending with .m3u, .pls </para></listitem><listitem><para><emphasis role="strong">Captions</emphasis>: Files ending with .srt, .smi </para></listitem></itemizedlist><para>Notably, it does <emphasis role="strong">not</emphasis> support the following file extensions. Renaming the file to a known extension seems to work in most cases. </para><itemizedlist><listitem><para><emphasis role="strong">Video</emphasis>: Files ending with .webm </para></listitem></itemizedlist><para>In addition to file format support from MiniDLNA, your media player or device needs to support the audio/video codecs with which the media has been encoded. MiniDLNA does not have the ability to translate files into a codec understood by the player. If you face problems with media playback, use the VLC player to find the codecs used in the media and the check your device or media player documentation on whether the codecs are supported. </para></section><section><title>File systems for external drives</title><para>If using an external drive that is used also from a Windows system the preferred filesystem should be NTFS. NTFS will keep Linux file permissions and UTF8 encoding for file names. This is useful if file names are in your language. </para></section><section><title>External links</title><para><ulink url="http://minidlna.sourceforge.net/"/> <ulink url="https://en.wikipedia.org/wiki/Digital_Living_Network_Alliance"/> </para><para>Back to <ulink url="https://wiki.debian.org/FreedomBox/Manual/MiniDLNA/FreedomBox/Features#">Features introduction</ulink> or <ulink url="https://wiki.debian.org/FreedomBox/Manual/MiniDLNA/FreedomBox/Manual#">manual</ulink> pages. </para><!--rule (<hr>) is not applicable to DocBook--><informaltable><tgroup cols="8"><colspec colname="col_0"/><colspec colname="col_1"/><colspec colname="col_2"/><colspec colname="col_3"/><colspec colname="col_4"/><colspec colname="col_5"/><colspec colname="col_6"/><colspec colname="col_7"/><tbody><row rowsep="1"><entry colsep="1" rowsep="1"><para><emphasis role="strong">Information</emphasis></para></entry><entry colsep="1" rowsep="1"/><entry colsep="1" rowsep="1"/><entry colsep="1" rowsep="1"><para><emphasis role="strong">Support</emphasis></para></entry><entry colsep="1" rowsep="1"><para><emphasis role="strong">Contribute</emphasis></para></entry><entry colsep="1" rowsep="1"/><entry colsep="1" rowsep="1"><para><emphasis role="strong">Reports</emphasis></para></entry><entry colsep="1" rowsep="1"><para><emphasis role="strong">Promote</emphasis></para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para><ulink url="https://wiki.debian.org/FreedomBox/Manual/MiniDLNA/FreedomBox/Introduction#">Overview</ulink> </para></entry><entry colsep="1" rowsep="1"><para><ulink url="https://wiki.debian.org/FreedomBox/Manual/MiniDLNA/FreedomBox/Hardware#">Hardware</ulink> </para></entry><entry colsep="1" rowsep="1"><para><emphasis role="strong"> </emphasis></para></entry><entry colsep="1" rowsep="1"><para><ulink url="https://wiki.debian.org/FreedomBox/Manual/MiniDLNA/FreedomBox/Support#">Live Help</ulink> </para></entry><entry colsep="1" rowsep="1"><para><ulink url="https://wiki.debian.org/FreedomBox/Manual/MiniDLNA/FreedomBox/Contribute#">Where To Start</ulink> </para></entry><entry colsep="1" rowsep="1"><para><ulink url="https://wiki.debian.org/FreedomBox/Manual/MiniDLNA/FreedomBox/Translate#">Translate</ulink> </para></entry><entry colsep="1" rowsep="1"><para><ulink url="https://wiki.debian.org/FreedomBox/Manual/MiniDLNA/FreedomBox/ProgressCalls#">Calls</ulink> </para></entry><entry colsep="1" rowsep="1"><para><ulink url="https://wiki.debian.org/FreedomBox/Manual/MiniDLNA/FreedomBox/TalksAndPresentations#">Talks</ulink> </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para><ulink url="https://wiki.debian.org/FreedomBox/Manual/MiniDLNA/FreedomBox/Features#">Features</ulink> </para></entry><entry colsep="1" rowsep="1"><para><ulink url="https://wiki.debian.org/FreedomBox/Manual/MiniDLNA/FreedomBox/Vision#">Vision</ulink> </para></entry><entry colsep="1" rowsep="1"><para><emphasis role="strong"> </emphasis></para></entry><entry colsep="1" rowsep="1"><para><ulink url="https://wiki.debian.org/FreedomBox/Manual/MiniDLNA/FreedomBox/QuestionsAndAnswers#">Q&amp;A</ulink> </para></entry><entry colsep="1" rowsep="1"><para><ulink url="https://wiki.debian.org/FreedomBox/Manual/MiniDLNA/FreedomBox/Design#">Design</ulink> </para></entry><entry colsep="1" rowsep="1"><para><ulink url="https://wiki.debian.org/FreedomBox/Manual/MiniDLNA/FreedomBox/TODO#">To Do</ulink> </para></entry><entry colsep="1" rowsep="1"><para><ulink url="https://wiki.debian.org/FreedomBox/Manual/MiniDLNA/FreedomBox/ReleaseNotes#">Releases</ulink> </para></entry><entry colsep="1" rowsep="1"><para><ulink url="https://wiki.debian.org/FreedomBox/Manual/MiniDLNA/FreedomBox/Press#">Press</ulink> </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para><ulink url="https://wiki.debian.org/FreedomBox/Manual/MiniDLNA/FreedomBox/Download#">Download</ulink> </para></entry><entry colsep="1" rowsep="1"><para><ulink url="https://wiki.debian.org/FreedomBox/Manual/MiniDLNA/FreedomBox/Manual#">Manual</ulink> </para></entry><entry colsep="1" rowsep="1"><para><emphasis role="strong"> </emphasis></para></entry><entry colsep="1" rowsep="1"/><entry colsep="1" rowsep="1"><para><ulink url="https://wiki.debian.org/FreedomBox/Manual/MiniDLNA/FreedomBox/Contribute/Code#">Code</ulink> </para></entry><entry colsep="1" rowsep="1"><para><ulink url="https://wiki.debian.org/FreedomBox/Manual/MiniDLNA/FreedomBox/Contributors#">Contributors</ulink> </para></entry><entry colsep="1" rowsep="1"/><entry colsep="1" rowsep="1"><para><ulink url="https://wiki.debian.org/FreedomBox/Manual/MiniDLNA/FreedomBox/Blog#">Blog</ulink> </para></entry></row><row rowsep="1"><entry colsep="1" nameend="col_1" namest="col_0" rowsep="1"><para> <ulink url="https://en.wikibooks.org/wiki/FreedomBox_for_Communities">FreedomBox for Communities</ulink> </para></entry><entry colsep="1" rowsep="1"/><entry colsep="1" rowsep="1"/><entry colsep="1" nameend="col_5" namest="col_4" rowsep="1"><para> <ulink url="https://docs.freedombox.org">FreedomBox Developer Manual</ulink> </para></entry><entry colsep="1" rowsep="1"/><entry colsep="1" rowsep="1"/></row></tbody></tgroup></informaltable><para><!--"~-smaller-~" is not applicable to DocBook-->HELP &amp; DISCUSSIONS: <ulink url="https://discuss.freedombox.org">Discussion Forum</ulink> - <ulink url="https://lists.alioth.debian.org/mailman/listinfo/freedombox-discuss">Mailing List</ulink> - <ulink url="irc://irc.debian.org/freedombox">#freedombox irc.debian.org</ulink> | CONTACT <ulink url="https://freedomboxfoundation.org/">Foundation</ulink> | JOIN <ulink url="https://salsa.debian.org/freedombox-team/">Project</ulink> </para><para><link linkend="">Next call</link>: Sunday, July 26th at 17:00 UTC </para><para><link linkend="">Latest news</link>: Announcing Pioneer FreedomBox Kits - 2019-03-26 </para><para>This page is copyright its contributors and is licensed under the <ulink url="https://creativecommons.org/licenses/by-sa/4.0/">Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0)</ulink> license. </para><!--rule (<hr>) is not applicable to DocBook--><para> <ulink url="https://wiki.debian.org/FreedomBox/Manual/MiniDLNA/CategoryFreedomBox#">CategoryFreedomBox</ulink> </para></section></section></article>
Reference in New Issue View Git Blame Copy Permalink