a social tv project
##FAQ
###Videos are not playing / videos are missing
Playem extracts the videos shared by your Facebook friends. Only Youtube videos are supported in the current version. So, please make sure that the videos you are missing in Playem are indeed hosted on Youtube.
If you're feeling adventurous, you can try the development version that supports more sources: https://adrienjoly.com/playem/#player=all
If you're willing to help me improve Playem (e.g. fixing bugs and adding missing videos), I developed a version that lists all the links that are returned by Facebook, so that you can identify which ones are supposed to be supported: https://adrienjoly.com/playem/#player=debug
In the latter case, here is how to proceed:
- open that link,
- click on the fb connect button,
- wait for a few dozens of links to be listed on the right of the screen,
- click on the "select text" button (top-right corner)
- copy and paste this text into a new email,
- please keep only the lines that you're sure should be supported by playem (because they're videos or audio tracks)
- send that email to contact at playem dot org, so that I can do my best to support these links
###How does it work behind the scenes?
This sequence diagram says it all.
###The UI/design sucks... Can I contribute?
Yes, you can! Here is how:
####Prerequisites
- create a github account
- install
git
(command line tool) - set it up so that it's linked to your github account
####Setup
-
from a terminal, download the source code of that fork to a directory of your computer:
git clone https://github.com/<YOUR GITHUB USERNAME>/playem.git
-
go to the "playem" directory, then run the HTTP server locally:
./run_local
-
open this page in your web browser: http://localhost:8000
-
back in the terminal, press Ctrl-C to stop the server
-
create your own development branch
git branch mybranch
-
duplicate ui-default to your own ui-XXX directory
####Development iterations
-
restart the server:
./run_local
-
open
http://localhost:8000/#design=XXX
(this loads style.css and ui.js from your own ui- directory) -
make any change you want in your own ui- directory (.css, .js, images...)
-
refresh the page in your web browser in order to test your changes, then iterate again from step 1
####Commiting and pushing an interation
- check which files were updated locally
git status
- select the updated files that you want to commit, example:
git add ui-XXX/*
- commit these updated files with a concise description, exemple:
git commit -m "changed the background image"
- upload those changes back to your github project
git push
- then you can "pull request" from your project's page on github, if you want your changes to be pushed to adrienjoly.com/playem