TVH Client

Your rating: None Average: 5 (7 votes)

TVH Client is a native Sailfish OS client app for TVHeadend server. This app uses the RESTful API of TVHeadend.

Implemented Features

Here is a list of all implemented features so far. Not all features listed below are finished or error free and are still in active development.


  • Setup wizard for first start
  • Channel List
  • EPG (current playing / view per channel)
  • Video Stream Player for channels and recordings (depends on the installed codecs of gstreamer)
  • Manage recordings (schedule / stop / cancel / delete)
  • Data cache for offline mode
  • User authentication

Planned Features

  • Schedule recordings in offline mode (transfer when server is available again)
  • Administrative controls
  • all other feature requests


  • English
  • German

Your language is not available? You are welcome to support this project by translating it on my self hosted Weblate server:

Intention of this project

This app is part of my plan to replace all android apps I use with native ones. If they don't exist, I will try to create one.

Source code is available on Github:


If you like my work you can buy me a beer.


Donate using Liberapay

Application versions: 
File harbour-tvhclient-0.1.0-2.armv7hl.rpm144.41 KB17/01/2021 - 00:29
File harbour-tvhclient-0.1.0-2.i486.rpm159.77 KB24/01/2021 - 16:39
File harbour-tvhclient-0.1.1-1.armv7hl.rpm143.53 KB30/01/2021 - 15:38
File harbour-tvhclient-0.1.1-1.i486.rpm159.02 KB30/01/2021 - 15:38
File harbour-tvhclient-0.1.3-1.armv7hl.rpm144.9 KB30/01/2021 - 17:00
File harbour-tvhclient-0.1.3-1.i486.rpm160.72 KB30/01/2021 - 17:00
File harbour-tvhclient-0.1.4-1.armv7hl.rpm147.38 KB30/01/2021 - 22:50
File harbour-tvhclient-0.1.4-1.i486.rpm164 KB30/01/2021 - 22:50
File harbour-tvhclient-0.1.5-1.armv7hl.rpm150.88 KB03/03/2021 - 13:24
File harbour-tvhclient-0.1.5-1.i486.rpm167.06 KB03/03/2021 - 13:24
File harbour-tvhclient-0.1.6-1.aarch64.rpm159.84 KB15/05/2021 - 19:16
File harbour-tvhclient-0.1.6-1.armv7hl.rpm151.12 KB15/05/2021 - 19:16
File harbour-tvhclient-0.1.6-1.i486.rpm167.32 KB15/05/2021 - 19:16
File harbour-tvhclient-0.1.7-1.i486.rpm168.9 KB22/11/2021 - 22:18
File harbour-tvhclient-0.1.7-1.armv7hl.rpm152.79 KB22/11/2021 - 22:18
File harbour-tvhclient-0.1.7-1.aarch64.rpm161 KB22/11/2021 - 22:18
File harbour-tvhclient-0.2.0-1.aarch64.rpm162.29 KB23/12/2021 - 08:00
File harbour-tvhclient-0.2.0-1.armv7hl.rpm154.03 KB23/12/2021 - 08:00
File harbour-tvhclient-0.2.0-1.i486.rpm170.15 KB23/12/2021 - 08:00
File harbour-tvhclient-0.2.1-1.aarch64.rpm161.4 KB23/12/2021 - 18:35
File harbour-tvhclient-0.2.1-1.armv7hl.rpm153.15 KB23/12/2021 - 18:35
File harbour-tvhclient-0.2.1-1.i486.rpm169.09 KB23/12/2021 - 18:35
File harbour-tvhclient-0.2.2-1.i486.rpm169.46 KB09/01/2022 - 09:29
File harbour-tvhclient-0.2.2-1.armv7hl.rpm153.53 KB09/01/2022 - 09:29
File harbour-tvhclient-0.2.2-1.aarch64.rpm161.38 KB09/01/2022 - 09:29
* Sun Jan 09 2022 Black Sheep <> 0.2.2-1
- Prevent display blanking when watching channel
- Fixed Sailjail settings

* Thu Dec 23 2021 Black Sheep <> 0.2.1-1
- Replaced Sailfish Secrets with own simple crypto imlementation
- UI Fixes
- Bugfixes

* Thu Dec 23 2021 Black Sheep <> 0.2.0-1
- Sailjail support
- App layout changed
- UI improvements
- Bugfixes

* Mon Nov 22 2021 Black Sheep <> 0.1.7-1
- Add translations for Swedish / Polish / Sinhalese / French / Slovak
- Migration of settings to new Jolla requirements
- Code improvements

* Sat May 15 2021 Black Sheep <> 0.1.5-1
- Bugfixes
- aarch64 release

* Wed Mar 03 2021 Black Sheep <> 0.1.5-1
- Add translation information with self hosted Weblate server

* Sat Jan 30 2021 Black Sheep <> 0.1.4-1
- Use Sailfish Secrets to store credentials

* Sat Jan 30 2021 Black Sheep <> 0.1.3-1
- Add user authentication

* Sat Jan 30 2021 Black Sheep <> 0.1.1-1
- Bugfixes and code improvements

* Sat Jan 16 2021 Black Sheep <> 0.1.0-2
- Initial release


3vixan's picture

Hi! I cannot stream my tv channels...:-(
Wich are the settings/codec usefull?

Termitebug's picture

Is this a bug preventing playback?
[W] unknown:215 - file:///usr/share/harbour-tvhclient/qml/pages/EventsListPage.qml:215: TypeError: Type error
[D] expression for script:251 - Warning: Slider.maximumValue needs to be higher than Slider.minimumValue

black_sheep_dev's picture

The "bug" is only at the loading of the page, when current  position and duration are still have value 0.

Termitebug's picture

Thank you for working EPG software at this stage of app! Are there any "superuser" guides of how-to-build codecs from sources? Git's? I would like this app evolve as my daily Live TV driver.

black_sheep_dev's picture

Thanks for your feedback!

At the moment there is no package for mpeg-ts available as far as i know.
It was on my ToDo list to build that myself, but I never made it.
Maybe in the future, if my daily work leaves me enough time ;-)

mathieujallois's picture

hope 64bit will come soon

mathieujallois's picture

Oh!!! thanks

3vixan's picture

Hi black sheep!
What codecs are needed for streaming?

black_sheep_dev's picture

This depends. What you need e.g. for SD channels is MPEG-TS.

Ahti30708's picture

Very nice! Setting up an unauthenticated user on the server turned out to be quite easy: create user * with password * and limit access to the local network (in my case
However, authentication could work in the server string (Kodi and VLC can access the tuners this way) if the syntax check was disabled:

black_sheep_dev's picture

Thanks for the tip. It seams to work. I will include this in the next release.