README
¶
SocialVibes (App Engine Project)
[
] (https://plus.google.com/118015654972563976379/)
What is Social Vibes?
Social Vibes visualizes any public Google+ event. During an event, you can start the Social Vibes slideshow to show the latest event pictures combined with music of your choice.
How to use it?
You can select one of the public events you've created with your Google+ account or any public event by pasting the URL. For the music, you can select one of our suggestions or paste any YouTube playlist URL. After selecting an event and a playlist, you can start the slideshow.
How to set it up?
- You need Google Go (http://golang.org/doc/install) with all environment variables set
- You need the Go App Engine SDK (https://developers.google.com/appengine/docs/go/gettingstarted/devenvironment)
- Checkout the repository
- You need an app.yaml file, something similar to this:
application: <<Your Google Cloud Project ID>>
version: 1
runtime: go
api_version: go1
handlers:
- url: /css
static_dir: static/css
- url: /js
static_dir: static/js
- url: /images
static_dir: static/images
- url: /fonts
static_dir: static/fonts
- url: /swfobject
static_dir: static/swfobject
- url: /.*
script: _go_app
inbound_services:
- channel_presence
- You need a queue.yaml file, something similar to this:
queue:
- name: picture
mode: pull
acl:
- user_email: <<Compute Engine email Address>>
- user_email: <<Client ID email Address>>
- writer_email: <<Compute Engine email Address>>
- writer_email: <<Client ID email Address>>
- name: picturerequest
mode: pull
acl:
- user_email: <<Compute Engine email Address>>
- user_email: <<Client ID email Address>>
- writer_email: <<Compute Engine email Address>>
- writer_email: <<Client ID email Address>>
You can find these email addresses in the Google Cloud Console (APIs & auth > Credentials): https://cloud.google.com/console More information on queue configuration: https://developers.google.com/appengine/docs/go/config/queue
- You need a socialvibes.toml file under socialvibes/config/socialvibes.toml, e.g.:
computeEngineAddress = "<<IP>>:<<Port>>"
[google]
clientID = "<<Your Client ID for web application>>"
clientSecret = "<<Your Client secret for web application>>"
You can find the Client ID and secret in the Google Cloud Console (APIs & auth > Credentials): https://cloud.google.com/console
- You need to deploy the app with
goapp deploy
Used packages
Google App Engine
Gorilla Web Toolkit
- github.com/gorilla/mux
- github.com/gorilla/rpc/v2
- github.com/gorilla/rpc/v2/json
- github.com/gorilla/securecookie
Others
Directories
¶
| Path | Synopsis |
|---|---|
|
config
Package config allows to parse a TOML config file.
|
Package config allows to parse a TOML config file. |
|
db
Package db provides functions to insert, access and delete Channel clients in the App Engine Datastore.
|
Package db provides functions to insert, access and delete Channel clients in the App Engine Datastore. |
|
events
Package events provides the ability to retrieve Google+ events for a signed-user and a trigger to aggregate all event pictures by commmunicating with the Compute Engine.
|
Package events provides the ability to retrieve Google+ events for a signed-user and a trigger to aggregate all event pictures by commmunicating with the Compute Engine. |
|
handler
Package handler includes all handle functions for the HTTP server.
|
Package handler includes all handle functions for the HTTP server. |
|
model
Package model contains the struct for a Google+ event.
|
Package model contains the struct for a Google+ event. |
|
rpc
Package rpc includes the RPC service method for pulling tasks from the Google App Engine Task Queue.
|
Package rpc includes the RPC service method for pulling tasks from the Google App Engine Task Queue. |