Skip to content
This repository has been archived by the owner on Jan 31, 2023. It is now read-only.

wouterdebie/locast2tuner

Repository files navigation

locast2tuner

DEPRECATION WARNING! Unfortunately locast.org is no longer. This means that this project has been deprecated..

Join the chat at https://gitter.im/wouterdebie/locast2tuner GitHub release License Sponsor

This application provides an interface between locast.org and Media Servers like Plex Media Server (PMS) and Emby by acting like an HDHomerun or an m3u tuner and an XMLTV provider.

locast2tuner can imitate one or more digital tuners and provides geo cloaking across regions.

❗ Since locast.org uses Amazon Cloudfront to stream, region restrictions imposed by Cloudfront can not be circumvented. This means that locast2tuner might not work outside of the United States.

Features

Documentation

Documentation can be found at https://wouterdebie.github.io/locast2tuner/

Sponsoring

If you use locast2tuner and want to contribute by sponsoring, please leave a donation at my Sponsor Page. All of the money donated will go towards organizations that support women and underprivileged children in STEM education like BUILT BY GIRLS, Electric Girls, Project Exploration and others.

Todo

This project isn't complete yet. It works, but there are a few things I'd like to get done. These can be found on the Issues page

Submitting bugs or feature requests

Bugs

❗ Make sure to check https://github.com/wouterdebie/locast2tuner/releases for breaking configuration changes in the latest release before submitting a bug! Also, please read the documentation and FAQ before submitting a bug request!

When you encounter a bug, please use Github Issues:

  • PLEASE USE THE ISSUE TEMPLATES! Issues that are lacking log excerpts and other information might be closed. In other words don't file issues that are simple "It doesn't work" ones.
  • Add a detailed description of the issue you're experiencing.
  • Explain what steps can be taken to reproduce the issue.
  • If possible, add an excerpt of the log file that shows the error.
  • Add a copy of your config. You can get a copy of your running config by opening /config in a browser (e.g http://localhost:6077/config). This will not expose your locast password. If you can't access /config, please add your config file without your password.
  • Before submitting, mark the issue as a "Bug".

Feature requests

When you have a features you'd like to see added, please use Github Issues and mark the issue as an "Enhancement".

Pull requests

If you're so awesome that you want to fix bugs or add features yourself, please fork this repository, code, and create a Pull Request. Please squash your commits into a single commit before sending the pull request.