YTPlayer [archived]

Your rating: None Average: 4.8 (50 votes)

YTPlayer is no longer developed. If you wish to continue development, please leave me a comment!

Unofficial YouTube client for Sailfish OS!

Two very important notices!

1) You must provide youtube-client-id.json and youtube-data-api-v3.key files in your Downloads folder in order to use the application. You will have to generate them yourself, and sadly It is a thing and a half to do, but you can follow this guide to generate and download the files. This may have implications to your Google account, so do this at your own risk. Once YTPlayer has started without complaining about the missing keys or files, you can delete the files from the Download folder.

2) Google restricts YouTube Data API v3 usage. I was greeted with the following message in the YTPlayer log: "We're sorry, but your computer or network may ben sending automated queries. To protect our users, we can't process your request right now." That happened to my keys during developement, I'll have to wait and see it they work after a few days of waiting.

This all means that I will soon halt developing YTPlayer, and will only provide builds of the application for new SFOS versions. Old SFOS versions are no longer supported after 0.6.18 release.

Known limitations:

  • Google restricts YouTube Data API v3 usage
  • Only 360p and 720p videos are supported
  • Some vides are available only at 360p
  • Fetching newest videos from all subscribed channels doesn't work
  • Recommened videos may not show relevant results

This version is a fork of YTPlayer by osetr, which is a fork of YTPlayer by tworaz.

Source code is available at GitHub. Pull requests and translations are welcome! Especially tweaks regarding YouTube API v3 and coping with its limitations are highly appreciated!

If you like this app and would like to support me maintaining it, you can buy my a cup of coffee!

Application versions: 
File harbour-ytplayer-0.6.9-1.armv7hl.rpm273.92 KB15/09/2019 - 14:19
File harbour-ytplayer-0.6.9-1.i486.rpm295.42 KB15/09/2019 - 14:19
File harbour-ytplayer-0.6.15-1.armv7hl.rpm696.52 KB01/06/2020 - 18:38
File harbour-ytplayer-0.6.15-1.i486.rpm729.67 KB01/06/2020 - 18:38
File harbour-ytplayer-0.6.16-1.armv7hl.rpm699.91 KB11/06/2020 - 09:23
File harbour-ytplayer-0.6.16-1.i486.rpm732.38 KB11/06/2020 - 09:23
File harbour-ytplayer-0.6.17-1.aarch64.rpm1.29 MB31/01/2021 - 04:07
File harbour-ytplayer-0.6.17-1.armv7hl.rpm1.28 MB31/01/2021 - 04:07
File harbour-ytplayer-0.6.17-1.i486.rpm1.31 MB31/01/2021 - 04:07
File harbour-ytplayer-0.6.18-1.aarch64.rpm302.73 KB27/07/2021 - 21:43
File harbour-ytplayer-0.6.18-1.armv7hl.rpm293.71 KB27/07/2021 - 21:43
File harbour-ytplayer-0.6.18-1.i486.rpm327.82 KB27/07/2021 - 21:43


  • Added (restore) youtube-dl update functionality in Settings
  • Read youtube-client-id.json and youtube-data-api-v3.key from Downloads
  • Improve error reporting a bit

Full change log can be found in GitHub.


richarpad's picture

Hi Guys - am a new sfos user.

I can confirm ytplayer not usable.

Running it in CLI indeed does confirm API key limit exceeded.

I tried compiling using SDK, but could not get it to compile (hoping i could put in my own API key etc)

Keenly awaiting an update to this project. :)



TMavica's picture

Not working anymore, no subscription, catalog found, search function no working too

dumol's picture

Hey, thanks for this, donated... Looking forward to support for own API keys at runtime!

direc85's picture

Thanks! I think I have some time for it in a week or two..!

lxmx's picture

I was getting random search failures with no results. Checked the logs and saw 403: quotaExceeded errors. Wonder if you've encountered these.

direc85's picture

Once you hit the quota, the only way out is to wait until until the daily limit resets. This also witnesses the popularity of the app, yay!

I will implement a way to let the user know without log digging that the quota has been met.

I will also implement a method to use different API credentials instead of the internal ones. That relieves the pressure of the default account quota by letting people use their own quota instead. But that's not going to happen this week at least.

lxmx's picture

Another option could be rotating through API keys. I mean, lowering the API limit from 1 mln hits to 10k hits on the YouTube site is really prohibitive. And asking each user to register as a developer isn't great UX and a privacy concern.

direc85's picture

Rotating API keys is not allowed by terms of usage. Also you have to login again when the key changes. What's more, 1M quota points divided to 10k hits per user results in 100 users, and I think YTPlayer has more daily users than that. So, I think a "hard" limit of 10k/user is very acceptable - even more so because it would be voluntary.

TMavica's picture

Now click every page, it show a blank page except watch recently page

TMavica's picture

Yes. It loaded, but clicked recommendation, it came out with lastest video

TMavica's picture

Now recommendation shows 'latest video'

direc85's picture

Does the content load? Because I did the change to fix the empty view in my device... If there's content, ther must be something wrong with my device...

Edit: Something's funny in my XA2 I did this testing with. I'll revert the change.

kevencopeland's picture

Recommendations do not load

Bsingleto's picture

Yeah, your right. The recommendations do not load. I prefer the Utube player because it plays my youtube subscriptions from recently uploaded.

I think this app/program does a real disservice when you click SUBSCRIPTIONS, it loads all of your subbed to channels. But when you do a 'pull down' under your subscriptions to 'Latest' , it has the nerve to show you trending videos instead of the LATEST of Your Own Subscriptions Feed.!. i dont want to watch youtube trending. i want to watch what i am subscribed too.

Lastest/trending is so useless. I want to watch what im subscribed to which is a carefully currated list of over one thousand subbed channels.

Please update My Subscriptions to Latest of Only My Subscriptions. Please,....

direc85's picture

Thanks for the feedback.

You are correct; fetching latest subscribed videos feature is embarrassingly broken, but this is because of changes in YouTube API. This is to make third party apps (like YTPlayer) less usable. It's in Googles intrest to have users only use the official app, since it shows ads - YTPlayer does not.

AFAIK there is no simple method to just fetch the latest videos from your subscribed channels. There is little I can do to fix it (without exeeding quota by performing massive amounts of searches, so at this point I consider it unfixable). I think I'll disable the menu entry in the next release to lessen confusion - but as always, suggestions, workarounds and PRs for fixing the issue are welcome.

daniloplay's picture

eu não consigo instalar nada no meu nokia n9

direc85's picture

Esta aplicação móvel é para Sailfish. N9 é coisa diferente. (Google Translate, yay!)

TMavica's picture

It still very slow to find the source and buffering

direc85's picture

Thanks for feedback!

Finding the source is slow because of both the script startup and YouTube, so there's nothing more I can really do. Buffering (and media streaming) are done using Qt assets, and that is only slow because of YouTube.

How about seeking within the video once the playback starts? That should work the same way at least - to me, seeking is very fast (and was before this version, too).

direc85's picture

I just released a beta version which comes bundled with a minimal version of youtube-dl, which executes a lot faster. If you ever wondered why testing the local version of youtube-dl was taking so long - this fixes exactly that. Just running `youtube-dl --version` took 12 seconds on my original Jolla Phone - now it takes about 1.1 seconds.

If you are curious and like testing new stuff, please install this update and let me know what you think. Thanks!

JacekJagosz's picture

Subscribed videos to me show just random recommended ones. Could you try to fix it? It has been reported on the original project

direc85's picture

You mean the topmost "Subscriptions" item? To me it displays the channels I've subscribed to.

Listing new videos from all the subscribed channels like this isn't possible anymore using YouTube APIv3. That's a feature I would like to have in the app, but it's a serious pain to implement, now that I actually think about it. Plus it would take ages to refresh the page and drain the API key quota fast, so at this point I'm not even going to look at it. Sorry, looks like it's a wontfix until the API changes...

rossholmes's picture

Thank you for the effort, this is a great and very functional app! Cheers

tabasko's picture

Great work man!

akikk88's picture

Thanks now works very well :)

Pohli's picture

Thanks for maintaining this app! I've found one issue: in Download Settings my choices of the Preferred video quality option are: 360p, 360p,1080p. I have a Jolla Phone with SFOS and YTPlayer 0.6.8.

direc85's picture

Thanks for noticing that. That was a leftover from my failed attempt to implement 1080p support. As YouTube provides 1080p (and up) quality videos as separate audio and video streams now, I have no idea how to accomplish that using Sailfish/Qt/QML.

Version 0.6.9 published accordingly.

Pohli's picture

Thanks for quick fix! About page still says 0.6.8-1. ;-)

direc85's picture

Dang it! :D

Edit: That should have updated actually... Gotta look into it.

direc85's picture

As of writing this, the current youtube-dl version is 2019.09.12.1 which caused my version check sanity checks to fail. I updated the rules and released version 0.6.8 accordingly.