8 |
9 |
10 | 
11 | [](https://goreportcard.com/report/github.com/alexballas/Go2TV)
12 | [](https://github.com/alexballas/Go2TV/releases/latest)
13 | [](https://github.com/alexballas/go2tv/actions/workflows/go.yml)
14 |
15 | [](https://github.com/alexballas/go2tv/actions/workflows/build-arm.yml)
16 | [](https://github.com/alexballas/go2tv/actions/workflows/build-android.yml)
17 | [](https://github.com/alexballas/go2tv/actions/workflows/build-linux.yml)
18 | [](https://github.com/alexballas/go2tv/actions/workflows/build-mac.yml)
19 | [](https://github.com/alexballas/go2tv/actions/workflows/build-windows.yml)
20 |
21 | Cast your media files to UPnP/DLNA Media Renderers and Smart TVs.
22 |
23 |
24 | ---
25 | GUI mode
26 | -----
27 | 
28 | 
29 |
30 | CLI mode
31 | -----
32 | 
33 |
34 | Parameters
35 | -----
36 | ``` console
37 | $ go2tv -h
38 | Usage of go2tv:
39 | -l List all available UPnP/DLNA Media Renderer models and URLs.
40 | -s string
41 | Local path to the subtitles file.
42 | -t string
43 | Cast to a specific UPnP/DLNA Media Renderer URL.
44 | -tc
45 | Use ffmpeg to transcode input video file.
46 | -u string
47 | HTTP URL to the media file. URL streaming does not support seek operations. (Triggers the CLI mode)
48 | -v string
49 | Local path to the video/audio file. (Triggers the CLI mode)
50 | -version
51 | Print version.
52 | ```
53 |
54 | Allowed media files in the GUI
55 | -----
56 | - mp4, avi, mkv, mpeg, mov, webm, m4v, mpv, mp3, flac, wav, jpg, jpeg, png
57 |
58 | This is a GUI only limitation.
59 |
60 | Build requirements and dependencies
61 | -----
62 | - Go v1.16+
63 | - ffmpeg (optional)
64 |
65 | **Build using Docker**
66 |
67 | Since the repo provides a [Dockerfile](./Dockerfile), you can build a Go2TV Docker image and run it with just Docker installed (no build requirements and deps above needed). Also, no Git repo cloning is needed (Docker will do it behind the scenes). Just issue:
68 | ``` console
69 | $ docker build --force-rm [--pull] -t go2tv github.com/alexballas/go2tv#main
70 | ```
71 | Notice the branch name after the `#`, as the above will build `main`. You can also build `devel` if you want to build the latest code. Usage under Docker is outside this document's scope, check Docker docs for more information, specially volume mounts and networking. [x11docker](https://github.com/mviereck/x11docker) might come handy to run GUI mode, although it's not tested, since main Docker usage is CLI.
72 |
73 | Quick Start
74 | -----
75 | Download the app here https://github.com/alexballas/Go2TV/releases/latest. A single executable. No installation or external dependencies.
76 |
77 | **Transcoding**
78 |
79 | Go2TV supports live video transcoding, if ffmpeg is installed. When transcoding, SEEK operations are not available. Transcoding offers the maximum compatibility with the various file formats and devices. Only works with video files.
80 |
81 | **MacOS potential issue**
82 |
83 | If you get the "cannot be opened because the developer cannot be verified" error, you can apply the following workaround.
84 | - Control-click the app icon, then choose Open from the shortcut menu.
85 | - Click Open.
86 |
87 | Tested on
88 | -----
89 | - Samsung UE50JU6400
90 | - Samsung UE65KS7000
91 | - Android - BubbleUPnP app
92 |
93 | Author
94 | ------
95 |
96 | Alexandros Ballas