Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Newer
Older
100644 58 lines (35 sloc) 2.963 kb
2cb5041 @chocolateboy flesh out README
authored
1 # Synopsis <a name="Synopsis"></a>
2
1d14b35 @chocolateboy picotweako
authored
3 This is a plugin for [PS3 Media Server](http://code.google.com/p/ps3mediaserver/) that adds configurable support for Web video streaming via MEncoder.
2cb5041 @chocolateboy flesh out README
authored
4
5 # Prerequisites <a name="Prerequisites"></a>
6
cf68a3d @chocolateboy tips + issues
authored
7 Due to a [bug](http://code.google.com/p/ps3mediaserver/issues/detail?id=766) in the Mac OS X build of PS3 Media Server, PMSEncoder doesn't currently work on Macs. It should work on all other platforms supported by PS3 Media Server.
2cb5041 @chocolateboy flesh out README
authored
8
9 These instructions assume you have the latest versions of [PS3 Media Server](http://ps3mediaserver.org/forum/viewtopic.php?f=2&t=3217) (PMS) and [Java](http://www.java.com/en/download/index.jsp), and a recent MEncoder.
10
d20cfc7 @chocolateboy doctweak
authored
11 # Installation <a name="Installation"></a>
2cb5041 @chocolateboy flesh out README
authored
12
6b06d52 @chocolateboy docfix
authored
13 * download the [PMSEncoder jar file](http://github.com/downloads/chocolateboy/pmsencoder/pmsencoder-1.0.1.jar) and place it in the PMS `plugins` directory
2cb5041 @chocolateboy flesh out README
authored
14 * add `pmsencoder` to the front of the list of engines in PMS.conf e.g.
a586763 @chocolateboy fmt
authored
15 * `engines = pmsencoder,mencoder,tsmuxer,mplayeraudio` &c.
2cb5041 @chocolateboy flesh out README
authored
16 * if you previously used the standalone version of PMSEncoder, disable it by removing the `mencoder_path = /path/to/pmsencoder` line.
17 * restart PMS
18
adf6239 @chocolateboy fmt
authored
19 ## Upgrading <a name="Upgrading"></a>
d20cfc7 @chocolateboy doctweak
authored
20
6b06d52 @chocolateboy docfix
authored
21 To upgrade to a new version of the plugin, simply replace the old jar file with the new version in the `plugins` directory, and restart PMS.
04c2fd7 @chocolateboy upgrade notes
authored
22
cf68a3d @chocolateboy tips + issues
authored
23 # Tips
24
86e3239 @chocolateboy tweaklet
authored
25 * To work around the PMS [bug](http://code.google.com/p/ps3mediaserver/issues/detail?id=759) that causes web video playback to be delayed for ~40s, uncheck "HTTP Engine V2" in the PMS "General Configuration" tab. This can also be done by setting `http_engine_v2 = false` in PMS.conf. Then restart PMS.
cf68a3d @chocolateboy tips + issues
authored
26
2cb5041 @chocolateboy flesh out README
authored
27 # Troubleshooting <a name="Troubleshooting"></a>
28
3ec91e7 @chocolateboy doc tweak
authored
29 * Make sure there's only one version of the plugin in the `plugins` directory.
756d999 @chocolateboy doc tweak
authored
30 * Make sure the edited PMS.conf is the one PMS is using (search the filesystem for other copies).
3ec91e7 @chocolateboy doc tweak
authored
31 * Make sure `pmsencoder` is at the start of the list of engines in PMS.conf.
afe9352 @chocolateboy doc tweaklet
authored
32 * Make sure `mencoder_path` is not set (or is not pointing to the standalone PMSEncoder).
2cb5041 @chocolateboy flesh out README
authored
33 * Check the PMS debug.log.
34 * Check the pmsencoder.log, which should be in the same location as the debug.log.
35
169a62d @chocolateboy fmt
authored
36 ## Reporting Issues <a name="Help"></a>
b7effc3 @chocolateboy separate issue-reporting section
authored
37
2cb5041 @chocolateboy flesh out README
authored
38 Please do the following when reporting any issues:
39
afe9352 @chocolateboy doc tweaklet
authored
40 1. restart (or start) PMS
2cb5041 @chocolateboy flesh out README
authored
41 2. try to stream a web video
42 3. wait until it fails
43 4. post your PMS.conf, pmsencoder.log and debug.log (as a zipped attachment)
44
169a62d @chocolateboy fmt
authored
45 ## Support <a name="Support"></a>
2cb5041 @chocolateboy flesh out README
authored
46
47 For more details, discussion and troubleshooting tips, see the [wiki](http://wiki.github.com/chocolateboy/pmsencoder/) and [this thread](http://ps3mediaserver.org/forum/viewtopic.php?f=6&t=5002).
48
49 # Version <a name="Version"></a>
50
32888c1 @chocolateboy version 1.0.1
authored
51 1.0.1
2cb5041 @chocolateboy flesh out README
authored
52
53 # License <a name="License"></a>
54
55 Copyright 2009-2010 [chocolateboy](mailto:chocolate@cpan.org).
56
57 PMSEncoder is free software; you can redistribute it and/or modify it under the terms of the [Artistic License 2.0](http://www.opensource.org/licenses/artistic-license-2.0.php).
Something went wrong with that request. Please try again.