Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Fredolx/open-tv
Very fast and simple cross-platform IPTV app
https://github.com/Fredolx/open-tv
Last synced: 3 months ago
JSON representation
Very fast and simple cross-platform IPTV app
- Host: GitHub
- URL: https://github.com/Fredolx/open-tv
- Owner: Fredolx
- License: gpl-2.0
- Created: 2022-03-13T15:24:37.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-08-04T03:34:15.000Z (3 months ago)
- Last Synced: 2024-08-04T03:51:30.778Z (3 months ago)
- Language: TypeScript
- Homepage:
- Size: 20.2 MB
- Stars: 271
- Watchers: 5
- Forks: 12
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- Funding: FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome - Fredolx/open-tv - Ultra-fast, simple and powerful cross-platform IPTV app (Rust)
README
# Open-TV
Simple & fast IPTV app made with Electron and Angular
## Features
- Super fast
- M3U file, M3U link support and partial Xtream support
- Easy to use
- Recording & favorites
- Fully customizable player through mpv conf
- Bad/slow/unstable stream mitigations
## Planned features
- ~~Xtream support~~ (Partially completed)
- ~~Providing better support for bad streams~~
- Add more stream caching options
- Add custom configurations for specific channels
- Publishing on Flathub
## Prerequisites
The app both depends on mpv and ffmpeg. ffmpeg is a depedency of mpv on all package managers. On Fedora you will need to add rpmfusion and on OpenSUSE you will need to
install codecs with opi beforehand.
The Windows build **comes with mpv included**, but you should still install mpv from a package manager of your choice to always have the latest version installed
```
sudo dnf install mpv #Fedora
sudo zypper install mpv #OpenSUSE
sudo pacman -Syu mpv #Arch
sudo apt install mpv #Debian/Ubuntu
scoop install mpv # Windows
choco install mpv # Windows alternative
```
The .deb package should include mpv as a dependency but [due to a bug in electron forge it's not working](https://github.com/electron/forge/issues/3127). So install it manually alongside ffmpeg if you want full functionality on Ubuntu/Debian.
## Feedback
Feel free to submit any kind of feedback by creating a new issue.
## Install
You can install the latest version from [Releases](https://github.com/Fredolx/open-tv/releases/)
If you use Arch Linux, you can also [install it from the AUR](https://aur.archlinux.org/packages/open-tv-bin)
## Hotkeys
* F1: Help
* Ctrl + a: Show all channels
* Ctrl + s: Show categories
* Ctrl + d: Show favorites
* Ctrl + f: Search
* Ctrl + q: Enable/Disable livestreams
* Ctrl + w: Enable/Disable movies
* Ctrl + e: Enable/Disable series
* Backspace/Esc: Go back
* Arrow keys/Tab/Shift+Tab: Navigation
If you have a tv remote or air mouse that has slightly different bindings for general nav (back, up, down, left, right),
please open an issue and I will add them if it's feasible. Otherwise, you can still use hwdb to make them match OpenTV's bindings.
## Settings explained
**Stream Caching**
Why enabling:
- If you have a slow internet connection/IPTV provider causing the stream to pause often
Why disabling:
- If the stream often drops completely. It will prevent the stream from jumping too far ahead/behind
- If you have a good internet/provider and want lower latency
- Can prevent some weird bugs/slowdowns
## Build
For building from source, you will need those packages
```
rpm dpkg fakeroot
```
For node and npm, I would strongly suggest to use NVM (node version manager) to get the latest LTS.
And then to build
```
cd ng-open-tv
npm run prod
cd ../electron-open-tv
npm run publish
```
You can add/edit targets in forge.config.js.
On Windows, to prepackage mpv, place it in /libs (you will need to also create the folder).
## Repackaging
I am fine if you repackage the app on open source platforms like the AUR or Snap. As long as proper credit is given and it's free. I do not authorize any repackaging on proprietary platforms like the Microsoft Store.