youtube-app

App for search through youtube, play videos and send the videos to your yetu tv homescreen.

Warning:

**This is work in progress and as of right now only allows you to send a message into our messaging system, but not receive/display it yet. **

Project structure

This project is divided into the following two parts

• client-applications, where the sources are placed in the folder clients
  • youtube_producer:
    • App, which produces videoplaylists as notifications for yetu tv and mobile homescreen
    • Technologies: AngularJS, styl
    • Build-Process: gulp
  • youtube_viewer_level2_TV:
    • App, which plays the videos of a youtube playlist
    • path to app is /level2TV
    • parameters, which should be append to the url, are the following:
      • playlistId: id of the youtube playlist
      • itemIndex: number of playlist item which should be shown
      • lang: "en/de" - the language, which should be used in the viewer
    • Technologies: AngularJS, styl
    • Build-Process: gulp
• server-application which host the clients, provides authentication and configuration to communicate with other services
  • Technology: Scala
  • Build-Process: sbt
  • after building the clients the destination folders are the following:
    • main pages of clients are placed in app/clients/[scala-page-name]
    • sources of the main pages are in public/[clientName]
• appMetaData, which contains static data, which is used by the yetu platform
  • this data is placed in public/appMetaData
  • the store folder holds information for the yetu appstore
  • the assets and the manifest.json define the tile which you can see in the yetu homescreen (across devices)
  • furthermore in the manifest.json the urls to the different levels apps will be defined

Set up

Please open two different consoles for working with the app. In one you see the server build process and in the other one the client build process. Go to the root folder of this project in both consoles.

server setup

You need a java jdk and you need sbt. If you have sbt installed, you can use the usual sbt run or sbt test for local development. If you don't have sbt installed, you can just execute activator (if on a UNIX-system) or activator.bat (if on Windows).

sbt run or ./activator run will by default start a server on port 9000.

client setup

For working with the clients you need to install nodeJS, npm and bower globally on your machine.

Check if you have them all with:

which bower
which node
which npm

It should show you the path, where there are installed on your machine.

The bower components are committed. So if you want to add a bower dependency for one client, you have to add it in the bower.json on the public folder and then run bower install. Please commit this bower component.

To build the clients and watch it during development, there is a script defined, which you can run like this.

./buildClient_local.sh

In this script you can find commands, which watch both clients. We recommend to only use the lines for the client, you will work on.

Furthermore there is one line in the script, which runs npm install. You can remove this line, if you do not want to have it in the this flow every time.

You have to reload currently in your browser every time you make changes (TODO: include browser sync in gulp process).

Local configuration

In order to get the application to function, you need to provide:

• an OAuth2 clientId and clientSecret, and redirectURI. Please see conf/reference.conf for the configuration keys.
• a youtube developer token. Please see conf/reference.conf for the configuration keys.

These configuration values are best overridden in a new file under conf/application.conf

If you are an internal yetu employee:

You can get these configuration values from this private repository:

git clone git@bitbucket.org:yetu/apphome-youtube-html-app-deployment.git
cp apphome-youtube-html-app-deployment/application-local.conf conf/application.conf

If you are not internal yetu employee:

Currently please contact dev-support@yetu.com to obtain OAuth2 credentials.

For more information on how to develop yetu apps, please see this page

You also have to obtain a youtube developer token, please refer to the official youtube documentation for this.