robbiet480 / stirr-for-channels

M3U generator for Stirr, optimized for Channels' custom channels.

Stirr for Channels

This simple Docker image will generate an M3U playlist and EPG optimized for use in Channels and expose them over HTTP.

Channels supports custom channels by utilizing streaming sources via M3U playlists.

Channels allows for additional extended metadata tags in M3U playlists that allow you to give it extra information and art to make the experience better. This project adds those extra tags to make things look great in Channels.

Set Up

Running the container is easy. Fire up the container as usual. You can set which port it runs on.

docker run -d --restart unless-stopped --name stirr-for-channels -p 8181:80 robbiet480/stirr-for-channels

By default, the service listens on port 80, but you can override it with the PORT environment variable.

Upon startup, the service will ask Stirr for your local station ID and use it for all future requests. You can manually set a station ID by setting the STIRR_STATION_ID environment variable to something like san-francisco. Find valid station IDs here.

You can retrieve the playlist and EPG via the status page.

http://127.0.0.1:8181

Add Source to Channels

Once you have your Stirr M3U and EPG XML available, you can use it to custom channels channels in the Channels app.

Add a new source in Channels DVR Server and choose M3U Playlist. Fill out the form using your new playlist and EPG URLs.

Thanks

@maddox for building Channels and Pluto For Channels which inspired this work.

License

MIT

stirr-for-channels's Issues

Images are the wrong aspect and are too large

The images being used are 16x9 and they are too large in data size. It's causing lag while scrolling in On Now.

Additionally you can see them constantly reloading in the Channels UI, which is odd. It's either because the image cache is topping off (unlikely) or maybe it's because the images have query strings on their URLs. I don't see why that would be the the reason, as they're still not changing, but maybe it's freaking out the lib that's doing the image loading in Channels.

Rewriting the URLs would get the correct aspect size and lower data sizes for the required images and create a much better experience inside Channels. Below are examples on what needs to be adjusted.

Image URLs

The network logos and art logos can be re-written to support Channels better.

Network Logos

Note: Network logo looks like it doesn't show up due to the logo being white.

Current: https://komonews.com/resources/media2/16x9/full/180/center/90/44e3adac-d9ed-4f62-b8e7-3bc5d09d94cc-medium16x9_STIRR_LOGO_0220_STIRRCity_1920x1080_EPG.png?cb=cfcd208495d565ef66e7dff9f98764da

Updated: https://komonews.com/resources/media2/4x3/full/340/center/90/44e3adac-d9ed-4f62-b8e7-3bc5d09d94cc-medium16x9_STIRR_LOGO_0220_STIRRCity_1920x1080_EPG.png

• 4x3 aspect
• larger size
• no query param

Channel Art

Current: https://komonews.com/resources/media2/16x9/full/1920/center/90/fd79fcb6-8dd7-4f29-9f3e-2fbc18640b84-full16x9_STIRR_HellsKitchen_3.png?cb=cfcd208495d565ef66e7dff9f98764da

Updated: https://komonews.com/resources/media2/4x3/full/800/center/90/fd79fcb6-8dd7-4f29-9f3e-2fbc18640b84-full16x9_STIRR_HellsKitchen_3.png?cb=cfcd208495d565ef66e7dff9f98764da

• 4x3 aspect
• larger size
• no query param

Can't get stirr-for-channels to display extended EPG information.

Good morning,

I've been using stirr-for-channels for a few months now and I really like it. There are a few features that I just can't get working.

Firstly, I'm using Cabernet to discern the m3u's/EPG's I'm using; I'm using links from the mjh.nz site for some of my m3u/xml files and they(and other sources) all display extended info, pics, descriptions, season #, and etc, it's just stirr-for-channels doesn't do this, the displayed EPG that stirr shows is just simply the channel name within each time slot. Is there a setting somewhere that needs changing?

I'm running Kubuntu 23.04

On a side note, I use Portainer for my docker instances, would you be able to help me create a docker-compose.yaml file?

Thank you very much for your time and help.

Have a nice day.