# DLNAmpcRenderer
A script in Python 3 to turn mpc-hc into a DLNA / UPnP renderer
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.
DLNAmpcRenderer is an application written in Python 3 designed as a wrapper for mpc-hc to use the player as a DLNA/UPnP renderer, on a computer running under Windows. The script does not need any other package, only the presence of an executable of mpc-hc is required. The application has been tested with a few DLNA controlers (Windows Media Player Digital Media Controller, Bubble UPnP, UPnPlay, DLNAPlayOn) but should work with any DLNA compliant controler. Subtitles management is enabled through the DIDL description ('subtitlefileuri' or 'captioninfo'/'captioninfoex' tags) or the use of a 'captioninfo.sec' header in the response to the HEAD/GET request for the content to be played. Several instances can run in parallel provided they use different ports and names.
To install the application:
- of course, install Python 3
- copy DLNAmpcRenderer.py, icon.png and mpc.bat in the same folder
- install mpc-hc (https://github.com/clsid2/mpc-hc/releases) and madVR (http://madvr.com/) for proper image display and rotation
- open mpc.bat and, if needed, change the path of mpc-hc executable
- optionally, install jpegtran (https://jpegclub.org/jpegtran ), copy jpegtrans.bat, and change the path of jpegtran executable
- allow mpc-hc and python to communicate through the firewall (for more precise needs, see below)
To run the application:
DLNAmpcRenderer -h to display the complete syntax of command line and abbreviated commands
DLNAmpcRenderer [-h] [--bind [RENDERER_IP]] [--port RENDERER_TCP_PORT] [--name RENDERER_NAME] [--minimize] [--fullscreen] [--rotate_jpeg ROTATE_MODE] [--wmpdmc_no_mkv] [--trust_controler] [--search_subtitles] [--no_part_req_intermediate] [--verbosity VERBOSE]
--bind RENDERER_IP: the ip address used by the renderer on the local machine for communications with the controllers (to set it manually if the script does not manage to self-determine the ip address of the host or to select a specific network interface or all interfaces if no address is provided)
--port RENDERER_TCP_PORT: the port used by the renderer on the local machine sent to the controlers in the advertisements and the answers to the search requests
--name RENDERER_NAME: the name of the renderer, used to generate the uuid
--minimize: when set, minimizes the window of mpc-hc when inactive and restore it to its previous size when a playback is launched (useful when displaying photos as some controlers stop the playback between two consecutive pictures or when playing music as there is no use showing the window)
--fullscreen: when set, makes mpc-hc go fullscreen each time a playback starts (can be combined with 'minimize')
--rotate_jpeg ROTATE_MODE: when set to 'k' or 'j', tries to read the orientation metadata of jpeg pictures, and sends an accordingly rotation command to mpc-hc if 'k' (needs mpc-hc version 1.9.8.26 or higher to work properly), or sends a rotated picture with jpegtran to mpc_hc if 'j'
--wmpdmc_no_mkv: when set, Windows Media Player Digital Media Controller will transcode 'mkv' (matroska) files to 'mpegts' before streaming the content, allowing remote control of the playback, otherwise, the 'mkv' file will be streamed as it is, and the seekbar will probably be inactive in WMPDMC (but available in mpc-hc)
--trust_controler: when set, the URL of the content sent to the renderer is not checked before being passed to mpc-hc
--search_subtitles: when set, always requests subtitles, trying different extensions if no subtitle uri is provided by the controler or the server (may slow down the process)
--no_part_req_intermediate: when set, intermediates servers rejecting partial requests in order to allow mpc-hc to use Lav Splitter source (needs --trust_controler disabled)
--verbosity VERBOSE: for troubleshooting purposes, from 0 (default) to 2
Example: DLNAmpcRenderer -p 9100 -m -f -r j
As for the settings of the firewall, mpc-hc needs outgoing TCP connections allowed, and python outgoing TCP and UDP connections, as well as incoming TCP connections from local network on local port RENDERER_TCP_PORT (as in command line), incoming UDP connections from local network on local port 1900.
If with some files, in particular mpeg-ts contents, only audio is played, consider increasing the "stream analysis duration" of the "network settings" of Lav Splitter.
Raw data
{
"_id": null,
"home_page": "https://github.com/PCigales/DLNAmpcRenderer",
"name": "DLNAmpcRenderer",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": null,
"author": "PCigales",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/74/f7/28830529e02982dd0c035a09209e239d0ceca28b66ecaae56db6f4be662f/dlnampcrenderer-1.3.2.tar.gz",
"platform": "win64",
"description": "# DLNAmpcRenderer\r\nA script in Python 3 to turn mpc-hc into a DLNA / UPnP renderer \r\n\r\nThis program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.\r\n\r\nDLNAmpcRenderer is an application written in Python 3 designed as a wrapper for mpc-hc to use the player as a DLNA/UPnP renderer, on a computer running under Windows. The script does not need any other package, only the presence of an executable of mpc-hc is required. The application has been tested with a few DLNA controlers (Windows Media Player Digital Media Controller, Bubble UPnP, UPnPlay, DLNAPlayOn) but should work with any DLNA compliant controler. Subtitles management is enabled through the DIDL description ('subtitlefileuri' or 'captioninfo'/'captioninfoex' tags) or the use of a 'captioninfo.sec' header in the response to the HEAD/GET request for the content to be played. Several instances can run in parallel provided they use different ports and names.\r\n\r\nTo install the application:\r\n\r\n - of course, install Python 3\r\n - copy DLNAmpcRenderer.py, icon.png and mpc.bat in the same folder\r\n - install mpc-hc (https://github.com/clsid2/mpc-hc/releases) and madVR (http://madvr.com/) for proper image display and rotation\r\n - open mpc.bat and, if needed, change the path of mpc-hc executable\r\n - optionally, install jpegtran (https://jpegclub.org/jpegtran ), copy jpegtrans.bat, and change the path of jpegtran executable\r\n - allow mpc-hc and python to communicate through the firewall (for more precise needs, see below)\r\n\r\nTo run the application:\r\n\r\nDLNAmpcRenderer -h to display the complete syntax of command line and abbreviated commands\r\n\r\nDLNAmpcRenderer [-h] [--bind [RENDERER_IP]] [--port RENDERER_TCP_PORT] [--name RENDERER_NAME] [--minimize] [--fullscreen] [--rotate_jpeg ROTATE_MODE] [--wmpdmc_no_mkv] [--trust_controler] [--search_subtitles] [--no_part_req_intermediate] [--verbosity VERBOSE]\r\n\r\n--bind RENDERER_IP: the ip address used by the renderer on the local machine for communications with the controllers (to set it manually if the script does not manage to self-determine the ip address of the host or to select a specific network interface or all interfaces if no address is provided) \r\n--port RENDERER_TCP_PORT: the port used by the renderer on the local machine sent to the controlers in the advertisements and the answers to the search requests \r\n--name RENDERER_NAME: the name of the renderer, used to generate the uuid \r\n--minimize: when set, minimizes the window of mpc-hc when inactive and restore it to its previous size when a playback is launched (useful when displaying photos as some controlers stop the playback between two consecutive pictures or when playing music as there is no use showing the window) \r\n--fullscreen: when set, makes mpc-hc go fullscreen each time a playback starts (can be combined with 'minimize') \r\n--rotate_jpeg ROTATE_MODE: when set to 'k' or 'j', tries to read the orientation metadata of jpeg pictures, and sends an accordingly rotation command to mpc-hc if 'k' (needs mpc-hc version 1.9.8.26 or higher to work properly), or sends a rotated picture with jpegtran to mpc_hc if 'j' \r\n--wmpdmc_no_mkv: when set, Windows Media Player Digital Media Controller will transcode 'mkv' (matroska) files to 'mpegts' before streaming the content, allowing remote control of the playback, otherwise, the 'mkv' file will be streamed as it is, and the seekbar will probably be inactive in WMPDMC (but available in mpc-hc) \r\n--trust_controler: when set, the URL of the content sent to the renderer is not checked before being passed to mpc-hc \r\n--search_subtitles: when set, always requests subtitles, trying different extensions if no subtitle uri is provided by the controler or the server (may slow down the process) \r\n--no_part_req_intermediate: when set, intermediates servers rejecting partial requests in order to allow mpc-hc to use Lav Splitter source (needs --trust_controler disabled) \r\n--verbosity VERBOSE: for troubleshooting purposes, from 0 (default) to 2 \r\n\r\nExample: DLNAmpcRenderer -p 9100 -m -f -r j\r\n\r\nAs for the settings of the firewall, mpc-hc needs outgoing TCP connections allowed, and python outgoing TCP and UDP connections, as well as incoming TCP connections from local network on local port RENDERER_TCP_PORT (as in command line), incoming UDP connections from local network on local port 1900.\r\n\r\nIf with some files, in particular mpeg-ts contents, only audio is played, consider increasing the \"stream analysis duration\" of the \"network settings\" of Lav Splitter.\r\n",
"bugtrack_url": null,
"license": "GNU GPLv3",
"summary": "A script in Python 3 to turn mpc-hc into a DLNA / UPnP renderer",
"version": "1.3.2",
"project_urls": {
"Bug Tracker": "https://github.com/PCigales/DLNAmpcRenderer/issues",
"Homepage": "https://github.com/PCigales/DLNAmpcRenderer"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "72796aa7aa95a68f96a1e79390db6b349ccb4266df2712a267f632317afa372b",
"md5": "f98db9e2a6a54dc8bf8ce71ec40b015d",
"sha256": "6465f363d1f04658a33cb288875e053a533d10a7f2fe02dbb036b3de7d42203a"
},
"downloads": -1,
"filename": "DLNAmpcRenderer-1.3.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "f98db9e2a6a54dc8bf8ce71ec40b015d",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 51965,
"upload_time": "2024-09-27T16:30:32",
"upload_time_iso_8601": "2024-09-27T16:30:32.170471Z",
"url": "https://files.pythonhosted.org/packages/72/79/6aa7aa95a68f96a1e79390db6b349ccb4266df2712a267f632317afa372b/DLNAmpcRenderer-1.3.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "74f728830529e02982dd0c035a09209e239d0ceca28b66ecaae56db6f4be662f",
"md5": "478c1ed2f5e94cec381473669639465d",
"sha256": "e600ef3724a5c921fa470030dc4a6f7a10cf32870f05e9d317f319355608df15"
},
"downloads": -1,
"filename": "dlnampcrenderer-1.3.2.tar.gz",
"has_sig": false,
"md5_digest": "478c1ed2f5e94cec381473669639465d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 52407,
"upload_time": "2024-09-27T16:30:33",
"upload_time_iso_8601": "2024-09-27T16:30:33.624415Z",
"url": "https://files.pythonhosted.org/packages/74/f7/28830529e02982dd0c035a09209e239d0ceca28b66ecaae56db6f4be662f/dlnampcrenderer-1.3.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-09-27 16:30:33",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "PCigales",
"github_project": "DLNAmpcRenderer",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "dlnampcrenderer"
}
JSON
