This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision Last revision Both sides next revision | ||
servio_plugins [2011/11/04 23:28] zip [Development] added mention of stream types |
servio_plugins [2016/03/19 07:10] aaru_bui [Development] running with java |
||
---|---|---|---|
Line 3: | Line 3: | ||
Serviio plugins provide access to online sources such as Youtube or Regional Catchup TV services (e.g. BBC Iplayer). | Serviio plugins provide access to online sources such as Youtube or Regional Catchup TV services (e.g. BBC Iplayer). | ||
- | This feature was made available as part of Serviio 0.6, the plugins [[http:// | + | This feature was made available as part of Serviio 0.6, the plugins [[http:// |
Serviio doesn' | Serviio doesn' | ||
Line 10: | Line 10: | ||
* read the [[http:// | * read the [[http:// | ||
- | Currently the plugins | + | From version 0.6.1 Serviio supports |
Plugins help Serviio locate the exact location of the media streams as the feed often links to html pages rather than the stream. | Plugins help Serviio locate the exact location of the media streams as the feed often links to html pages rather than the stream. | ||
====== Installation ====== | ====== Installation ====== | ||
- | | + | - |
- | 2. Copy the plugin to the plugins folder | + | |
- | 3. Configure Serviio with at least one url to an RSS feed. This is done using the serviio console. | + | - |
After up to 5 mins the streams should be available to view. On the DLNA client look for a new folder called " | After up to 5 mins the streams should be available to view. On the DLNA client look for a new folder called " | ||
Line 27: | Line 27: | ||
Online content is usually served via **http** or **rtmp** protocol. The former is very easy to consume. The latter is mostly used by Adobe Flash servers and used in many online video services and FFmpeg compiled with [[http:// | Online content is usually served via **http** or **rtmp** protocol. The former is very easy to consume. The latter is mostly used by Adobe Flash servers and used in many online video services and FFmpeg compiled with [[http:// | ||
- | Feed item URLs can expire with time, if that is the case you will have to provide the expiry date so that Serviio can re-run the URL extraction when that happens and get a valid URL when necessary. | ||
- | Tips: | + | Feed item URLs can expire with time, if that is the case you will have to provide the expiry date so that Serviio can re-run the URL extraction when that happens and get a valid URL when necessary. You can also define whether the content is a live stream or static content. |
+ | |||
+ | <note tip> | ||
* Look at existing plugins, there may be a plugins that can be adapted with only minor changes | * Look at existing plugins, there may be a plugins that can be adapted with only minor changes | ||
* The plugins can be largely tested outside of serviio (to speed up development). | * The plugins can be largely tested outside of serviio (to speed up development). | ||
Line 36: | Line 37: | ||
* test2: when given a link from an rss item, does the plugin correctly determine the media? | * test2: when given a link from an rss item, does the plugin correctly determine the media? | ||
* Once the tests above pass it's time to install the plugin and do some final testing | * Once the tests above pass it's time to install the plugin and do some final testing | ||
+ | </ | ||
A plugin can be tested outside of groovy by running: | A plugin can be tested outside of groovy by running: | ||
__On Windows:__ | __On Windows:__ | ||
- | groovy -cp " | + | groovy -cp " |
- | ram Files (x86)\Serviio\lib\slf4j-api.jar; | + | |
- | 4j-log4j12.jar; | + | I suggest to create a MS-DOS batch file (ex: "{{ : |
- | x86)\Serviio\plugins\CNN.groovy" | + | < |
+ | @echo off | ||
+ | @ set ServiioPath=" | ||
+ | @echo " | ||
+ | %GROOVY_HOME%\bin\groovy.exe -cp " | ||
+ | @pause | ||
+ | </ | ||
+ | |||
__On Linux:__ | __On Linux:__ | ||
- | groovy -cp lib/serviio.jar:lib/slf4j-api.jar: | + | From your serviio |
- | And of course you can use the [[http://forum.serviio.org/viewforum.php? | + | < |
+ | groovy -cp lib/ | ||
+ | </ | ||
+ | Or with Java and groovy-all.jar: | ||
+ | |||
+ | < | ||
+ | java -cp lib/ | ||
+ | </ | ||
+ | |||
+ | And of course you can use the [[http:// | ||
====== Logging ====== | ====== Logging ====== | ||
Logging is configured through conf/ | Logging is configured through conf/ | ||
Line 69: | Line 88: | ||
< | < | ||
< | < | ||
- | </ | + | </ |