-
Notifications
You must be signed in to change notification settings - Fork 43
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #66 from jfarseneau/lucasreiners_optional_streamin…
…g_url Lucasreiners optional streaming url
- Loading branch information
Showing
8 changed files
with
60 additions
and
28 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,10 +1,10 @@ | ||
FROM node:9-alpine | ||
LABEL maintainer "[email protected]" | ||
FROM node:16-alpine | ||
LABEL maintainer="[email protected]" | ||
|
||
COPY . /antennas | ||
WORKDIR "/antennas" | ||
|
||
RUN yarn install | ||
RUN npm install | ||
|
||
EXPOSE 5004 | ||
CMD ["node", "index.js"] | ||
CMD ["npx", "."] |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,4 +1,4 @@ | ||
![Antennas](https://raw.githubusercontent.com/TheJF/antennas/master/docs/images/antennas-logo.png) | ||
![Antennas](https://raw.githubusercontent.com/jfarseneau/antennas/master/docs/images/antennas-logo.png) | ||
|
||
A JavaScript port of [tvhProxy](https://github.com/jkaberg/tvhProxy) which is a program that translates the Tvheadend API to emulate a HDHomeRun API. This is particularly useful to connect [Plex's DVR feature](https://www.plex.tv/features/live-tv-dvr/) to Tvheadend. | ||
|
||
|
@@ -7,18 +7,18 @@ A JavaScript port of [tvhProxy](https://github.com/jkaberg/tvhProxy) which is a | |
### Tvheadend Configuration | ||
To be able to stream from Tvheadend through Plex, you need to set up an anonymous user in Tvheadend that has streaming rights. You can do this in the users section, by creating a user `*`: | ||
|
||
![Example configuration](https://raw.githubusercontent.com/TheJF/antennas/master/docs/images/tvheadend-config.png) | ||
![Example configuration](https://raw.githubusercontent.com/jfarseneau/antennas/master/docs/images/tvheadend-config.png) | ||
|
||
### Using binaries | ||
|
||
Head over to the [release](https://github.com/TheJF/antennas/releases) section and download the binary for your platform. It will come with a `config/config.yml` that you can edit to reflect your setup, and you can simply run `antennas` in the console and the server will start up and start proxying Tvheadend over to Plex! | ||
Head over to the [release](https://github.com/jfarseneau/antennas/releases) section and download the binary for your platform. It will come with a `config/config.yml` that you can edit to reflect your setup, and you can simply run `antennas` in the console and the server will start up and start proxying Tvheadend over to Plex! | ||
|
||
### Run locally using Node | ||
|
||
Right now, due to Docker networking issues, the best way to get this working is by running it directly through node. | ||
|
||
* [Set up Node locally](https://nodejs.org/en/download/) | ||
* Clone this repo: `git clone https://github.com/TheJF/antennas.git` or [download the source code directly from releases](https://github.com/TheJF/antennas/releases) and extract it | ||
* Clone this repo: `git clone https://github.com/jfarseneau/antennas.git` or [download the source code directly from releases](https://github.com/jfarseneau/antennas/releases) and extract it | ||
* Run `yarn install` or `npm install` to install dependencies | ||
* In the directory where it was extracted, run `node index.js` (Note, Node version must be above 7) | ||
|
||
|
@@ -27,22 +27,33 @@ To run it as a daemon: | |
|
||
## Run locally using NPX | ||
|
||
`npx antennas --config foo/bar.yml` OR | ||
`TVHEADEND_URL=http://admin:[email protected]:9981 ANTENNAS_URL=http://127.0.0.1:5004 TUNER_COUNT=6 DEVICE_UUID=2f70c0d7-90a3-4429-8275-cbeeee9cd605 npx antennas` | ||
``` shell | ||
npx antennas --config foo/bar.yml | ||
``` | ||
|
||
OR | ||
|
||
``` shell | ||
TVHEADEND_URL=http://admin:[email protected]:9981 ANTENNAS_URL=http://127.0.0.1:5004 TUNER_COUNT=6 DEVICE_UUID=2f70c0d7-90a3-4429-8275-cbeeee9cd605 npx antennas | ||
```` | ||
|
||
### Docker | ||
|
||
Another way to get it running is to run it using Docker. Note that some functionality is currently not quite working when hosting this as a Docker container, namely, discovery from Plex. But with that warning, if you so choose to continue using Docker, the instructions are below. | ||
|
||
To start a Docker container running Antennas, run the command below. Note you must replace the `ANTENNAS_URL` and `TVHEADEND_URL` value to match your setup: | ||
`docker run -p 5004:5004 -e ANTENNAS_URL=http://x.x.x.x:5004 -e TVHEADEND_URL=http://replace:[email protected]:9981 thejf/antennas` | ||
|
||
``` shell | ||
docker run -p 5004:5004 -e ANTENNAS_URL=http://x.x.x.x:5004 -e TVHEADEND_URL=http://replace:[email protected]:9981 thejf/antennas | ||
``` | ||
|
||
To view if the configurations have been passed correctly, you can point your browser to where you are hosting Antennas (in the above example, it would be `http://x.x.x.x:5004` but this is a placeholder address that __needs__ to be changed) and you should see a summary of your configurations on the page: | ||
|
||
![Example landing page](https://raw.githubusercontent.com/TheJF/antennas/master/docs/images/example-index.png) | ||
![Example landing page](https://raw.githubusercontent.com/jfarseneau/antennas/master/docs/images/example-index.png) | ||
|
||
Alternatively, you can set it with all the available environment variables: | ||
``` | ||
|
||
``` shell | ||
docker create --name=antennas | ||
-e ANTENNAS_URL=http://x.x.x.x:5004 | ||
-e TVHEADEND_URL=http://replace:[email protected]:9981 | ||
|
@@ -53,15 +64,16 @@ Alternatively, you can set it with all the available environment variables: | |
|
||
And then `docker start antennas` | ||
|
||
Or, you can try by mounting a volume, set by yourself in path/to/config, that will need a config.yml to work. Example of a config.yml is [available here](https://github.com/TheJF/antennas/blob/master/config/config.yml), or below: | ||
``` | ||
Or, you can try by mounting a volume, set by yourself in path/to/config, that will need a config.yml to work. Example of a config.yml is [available here](https://github.com/jfarseneau/antennas/blob/master/config/config.yml), or below: | ||
|
||
``` yml | ||
tvheadend_url: http://replace:[email protected]:9981 | ||
antennas_url: http://x.x.x.x:5004 | ||
tuner_count: 6 | ||
``` | ||
|
||
* `docker create --name=antennas -v <path/to/config>:/antennas/config -p 5004:5004 thejf/antennas` | ||
* Set up `config.yml` (see configuration instructions [here](https://github.com/TheJF/antennas#configuration)) where you pointed the config volume (what you replaced `<path/to/config>` with | ||
* Set up `config.yml` (see configuration instructions [here](https://github.com/jfarseneau/antennas#configuration)) where you pointed the config volume (what you replaced `<path/to/config>` with | ||
* Finally, `docker start antennas` | ||
|
||
## Configuration | ||
|
@@ -74,11 +86,14 @@ Antennas will look for three values inside a `config/config.yml` file. They are: | |
|
||
* `tvheadend_url`: This is the path to your Tvheadend setup, with username, password, and port. Plex doesn't like `localhost` so it's best to find your own local IP and put this in if Tvheadend and Plex are running on the same network. For example: `http://user:[email protected]:9981` | ||
* `tuner_count`: This is for the number of tuners in Tvheadend. | ||
* `stream_url`: Optional field to set a stream URL that is different from the Tvheadend URL, for private Docker networks | ||
|
||
#### Environment variables | ||
|
||
If you want to set environment variables instead of modifying the config.yml, you can do so. The environment variable names are the same than the config.yml, except capitalized. So, `TVHEADEND_URL` and `TUNER_COUNT`. | ||
|
||
Optionally, for private Docker networks that need to expose a different URL for the streams, you can specify a public stream URL using `TVHEADEND_STREAM_URL` | ||
|
||
#### CLI parameters | ||
|
||
- `--config` followed by the config path, i.e. `--config foo/bar.yml` will allow you to set a custom path for the config file | ||
|
Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters