A Python UPnP Media Server
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
John-Mark Gurney fcfa5bdded convert README to markdown and minor updates.. 1 year ago
docs branch the files into a main line branch.. I should of done this 19 years ago
mpegts convert mostly to Python 3.. basic functions work... 1 year ago
patches add dependencies to the README, and include a couple patches... 18 years ago
xml branch the files into a main line branch.. I should of done this 19 years ago
.gitignore convert mostly to Python 3.. basic functions work... 1 year ago
Clip.py convert mostly to Python 3.. basic functions work... 1 year ago
ConnectionManager.py convert mostly to Python 3.. basic functions work... 1 year ago
ContentDirectory.py convert mostly to Python 3.. basic functions work... 1 year ago
DIDLLite.py a string player requires these changes.. 1 year ago
FSStorage.py add a date to files using their mtime.. 1 year ago
FileDIDL.py convert mostly to Python 3.. basic functions work... 1 year ago
QACheckList remove the shoutcast module.. 9 years ago
README.md convert README to markdown and minor updates.. 1 year ago
SSDP.py convert mostly to Python 3.. basic functions work... 1 year ago
ZipStorage.py convert mostly to Python 3.. basic functions work... 1 year ago
audio.py convert mostly to Python 3.. basic functions work... 1 year ago
audioraw.py convert mostly to Python 3.. basic functions work... 1 year ago
browse-zms.py switch to using tabs instead of spaces... 18 years ago
cddb.py preliminary version of the audio and slink modules... should 15 years ago
cdrtoc.py convert mostly to Python 3.. basic functions work... 1 year ago
cdsclient switch to using tabs instead of spaces... 18 years ago
connection-manager-scpd.xml branch the files into a main line branch.. I should of done this 19 years ago
content-directory-scpd.xml branch the files into a main line branch.. I should of done this 19 years ago
debug.py convert mostly to Python 3.. basic functions work... 1 year ago
dvd.py convert mostly to Python 3.. basic functions work... 1 year ago
et.py convert mostly to Python 3.. basic functions work... 1 year ago
filelock.py add close method to the filelock object.. and use that instead 15 years ago
flac.py fix len.. 10 years ago
interleave.c add support for multi-track FLAC files... add a interleaver to 15 years ago
item.py convert mostly to Python 3.. basic functions work... 1 year ago
mpegtsmod.py convert mostly to Python 3.. basic functions work... 1 year ago
pymediaserv convert mostly to Python 3.. basic functions work... 1 year ago
pymeds.py convert mostly to Python 3.. basic functions work... 1 year ago
pymeds.tac more cleaning up of shoutcast.. 9 years ago
pyvr.py convert mostly to Python 3.. basic functions work... 1 year ago
requirements.txt use local forks to fix modern Python issues.. 1 year ago
root-device.xml a string player requires these changes.. 1 year ago
slinke.py preliminary version of the audio and slink modules... should 15 years ago
slinkemod.py convert mostly to Python 3.. basic functions work... 1 year ago
soap_lite.py convert mostly to Python 3.. basic functions work... 1 year ago
upnp.py update email address... 17 years ago
xmlpretty switch to using tabs instead of spaces... 18 years ago

README.md

PyMedS

This is a UPnP Media Server based upon a plugable architecture to allow other media repositories than just a file system.

Tested basic functionality with the following devices and/or programs: Sony PlayStation 3 VLC BubbleUPnP (Android)

Historically tested basic functionality with the following devices and/or programs: Cidero UPnP A/V Controller Intel’s Media Control Point and Media Renderer D-Link DSM-520 Sony PlayStation 3 Linksys DMC-250

Usage

Either make a directory media and put the files there, or make a symlink named media to your media files. Either will work. Run it as:

./pymediaserv <localip> [ <http server port> ]

The following packages are required to run the media server: * Twisted (tested w/ 22.10.0) - https://twisted.org/ * SOAPpy-py3 - https://github.com/Synerty/SOAPpy-py3

The requirements are in requirements.txt and can be installed via pip intall -r requirements.txt.

Misc Issues

Thanks to Coherence for soap_lite that solved the issues w/ PS3 not seeing the media server. The PS3 with the latest firmware (2.50 and later) now plays a lot more media than before. It will stream ATSC streams (OTA HD) w/ AC3 (5.1) audio, but the stream has to have PAT followed by PMT to see the stream as valid. If it is PAT, PAT, PMT or PMT, PAT, the PS3 will think the stream is corrupted. Support for WMV and Xvid in AVI seems to work well.

For more information, check out the software page at: https://www.funkthat.com/~jmg/jmpc/pymeds.html

Good Luck!

John-Mark Gurney jmg@funkthat.com

License Information

This code is based upon code by Tim Potter.

It is licensed under the MIT license at: http://opensource.org/licenses/mit-license.php

Ideas for future improvements: I have received a few ECONNABORTED errors at times. The patch twisted.internet.tcp.py.patch catches this error, and handles it properly. Add res to the DVDTitle container to play the title, and for other containers that it makes sense for. Make the directory persistant so that the server’s UUID does not change each run and we don’t have to recreate the objects. This will mean we can add additional meta data. Figure out how to rearchitect ContentDirectoryControl so I don’t need to use doRecall. This may be helped by not necessarily figuring out all the children of a member just to fetch it. childCount isn’t a required attribute. Possibly doing the work in a thread would be a good solution. Autodetect IP address. Support sorting by other attributes. Finish support for playing DVD’s. Support custom icon like MediaTomb does. Support a generic layer for transcoding, and supporting detection of types for devices to only present the optimal type. Less of an issue now the PS3 video support has been expanded. Use deferredGenerator to eliminate doRecall. Make the ShoutCast module only do one connection and farm it to all requestors. How will we handle a blocked, non-reading client, drop them? How do we detect them to prevent blocking other clients. Add support to call Browse in a thread. Convert Browse to be a deferredGenerator so we can

v0.x: Ignore AppleDouble Resource Fork Files. (Maybe we should ignore all dot files.) Readded SOAPpy/fpconst requirement as it is necessary for twisted. Made it a bit closer to a real twisted project, in the process, pymediaserv looks more like a normal program. It allows you to override the media path and title of the server. Minor change to checkUpdate API, we didn’t use the return value, so don’t return one anymore. Support .scst files which is a file containing a URL to a .pls file. This means that you can support streaming radio stations that provides a .pls file such as KCSM 91.1. Fix ShoutCast error handling to be correct. Add support for an XML file containing an object so you can create an item that points to an mp3 streaming url that isn’t a .pls. Add support for playing parts of TS streams. This is useful for splitting apart a TS stream w/ multiple clips (like HDV) w/o creating the files. If we get an error parsing the genres of ShoutCAST, try again. Print out the modules that failed to load. Added an Audio module that will stream audio using the ossaudiodev module. Added SLink module for accessing Sony CD Changers. Add support for WAX/ASX files in shoutcast. Removed support for shoutcast as the module used was too old. Add support for FLAC audio files. If you have libFLAC installed, it will dynamicly decompress the audio. It supports seeking so goto should also be supported. If you want faster decoding there is a interleave.c that can be compiled to _interleave.so as interleaving the data in python code is much slower. Multi-track FLAC files (ones w/ an embeded cue-sheet are supported) will appear as a directory with each track in the directory. Files in the root directory of zip archives should now work. Support automatic formating of some attributes. One is duration, you can now store the number of seconds (as an int or a float), and a correctly formated duration will be automaticly generated. Add ability to turn on debugging on a per module basis. Saves from having to output tons of debug data. Support transcoding to mp4 format, video will be h.264 and audio will be AAC. Switch iterzipfile to use twisted’s zipstream. This fixes the problem where it would not work on Python 2.5 as Python removed a previously documented member. This also makes the code MUCH smaller.

v0.5: Support multiple SSDP servers on the same box. Fix SSDP to set the max-age to 7 days. We now retransmit replies and reannounce ourselves randomly before our original announcement expires. This fixes the Server Disconnects I was seeing on the DSM-520! Change how the mpegtsmod handles multi-stream TS’s. Instead of calling tssel.py, we fixup the PAT to only contain the channel we want. This does mean we send more data than we need, but means that we can make the stream seekable. Now works w/ PS3. The PS3 as of 2.50 supports AC3 audio in MPEG-TS streams. Add rar file support. This is optional, and if rarfile is not installed, things will work, just not be able to look into rar files. Fix problem when adding multiple res with same mime-type and adding transcoding mime-types to all files, not just video type files. Speed up detection of large zip files. Previously we would instantiate the ZipFile class, which was expensive. Use the is_zipfile function instead. Fix handling of Containers. Previously we would rescan the root dir many times due to calling doUpdate when we just wanted to update the SystemID. There was also a bug where we would do a lot more work than necessary. This significantly speeds up large directories. Improve mpegtsmod so that it doesn’t always scan the first 2 megs of the file. Do a quick check of the first few KB first. Create a new module that fetchs an XML files, parses it, and presents the media in it. This is to integrate my Python PVR so that I can browse the shows I have recorded. Fix transcoding of MPEG-2, use mp2 audio instead of mp3. Sync up the programs in mpegts. Skip directories in ZipStorage for zip and rar archives. For ShoutCast streams, override the User-Agent, apparently some/most stations now block the default one.

v0.3: Include some patches for twisted in the distro, in the directory patches. Look inside MPEG-TS for TVCT and/or PAT and if there is more than one program, make it a container w/ the different programs. Includes the program and MPEG-TS python module in the mpegts directory. Add support for multiple res elements and automatic transcoding to either avi/xvid or mpeg2 using ffmpeg. Update the path to ffmpeg in the FSStorage.py file. Look inside DVDs and handle titles and chapters. We can not yet play the streams. This requires pydvdread which is included in the directory pydvdread. It depends upon libdvdread and requires swig and a C compiler to build. Empty dirs w/ no content would disappear, and cause a short response to BrowseDirectChildren. The DSM-520 askes for one more than displayed, and uses the existant of the extra item as indication if there are more items. Understands zip and tar files now. It will dynamicly extract items, so you can zip up your jpegs and view them w/o having to unzip them. tar files can be gzip’d or bzip2’d. Each item now has an optinal content attribute, which if set is installed in the web server. Don’t send ‘foobar’ when exiting, stops a traceback on another instance of PyMedS. Properly fix deleting items. If you had another item with zero children which was before the deleted item, it would get removed from the list instead of the deleted item.

v0.2: No longer require restarting to see new files/dirs in hierarchy. Add FSStorage which is a set of classes for handling filesystem objects, also handles updateID’s. Make the root container customizable, so you don’t end up with a single entry (like media) at the root. This lets us use a FSDirectory as the root and get auto-enumeration Support returning custom error codes, so that we can return 701 No such object among others. Support deleting items, so we can remove them when no longer on the file system. Make Containers a subclass of list. This lets use populate childCount properly. Add required attributes to Storage* classes. Support custom container classes to addContainer. Add a few more custom mime-types. Sort listings by name for now.

v0.1: Don’t bind the UDP socket to the multicast address, so replies go out on our local IP. Send out notify requests when we register the services with SSDP. Send out byebye notifications when we are shutting down. Randomize the UUID for the server (this should be part of the saved state). Randomize the port, or optionally set it on the command line. Teach ContentDirectory.py the basics on handling Containers and generic browse support. You can addItem and addContainer, which each return either respective ObjectID. We already support partial chunking of responses, but we don’t yet support filtering or sorting.