Skip to content

PDXHub/Locker

 
 

Repository files navigation

Locker - the "me" platform

This is an open source project that helps me collect all of my personal data, from wherever it is, into one place, and then lets me do really awesome stuff with it.

What Is My Locker??

STATUS: eager-developer-friendly only at this point, we're working hard to make it usable for early adopters very soon, keep an eye on @lockerproject and @jeremie for progress, and come hang out with us on freenode IRC in #lockerproject.

Getting Started

The Take-No-Prisoners Way

If you just want to get a locker up and running, there are semi-regularly refreshed standalone tarballs available for OS X and Linux (in both 32-bit and 64-bit flavors). Unpack the tarball, cd into the lockerproject directory, and ./run!

The Fast Way

Lockerbox (by pib) is a straightforward way to get all the high-level dependencies installed at once. It will make a single directory called lockerbox and get everything set up inside of there.

curl https://raw.github.com/smurthas/lockerbox/master/lockerbox.sh > lockerbox.sh
chmod 0755 lockerbox.sh
./lockerbox.sh

When that successfully completes, add lockerbox/local/bin to your path:

echo 'export PATH=$PATH:'`pwd`/lockerbox/local/bin >> ~/.profile
source ~/.profile

Then:

cd lockerbox/Locker
#check to make sure everything worked
./checkEnv.sh
node lockerd.js

now open http://localhost:8042/ in your browser!

The Detailed Way

If you encounter errors in "the fast way", or if you want to go through the process of setting everything up manually, check out the detailed set up instructions.

What are these things?

  • Connectors - A service that knows how to connect to and sync data with a place where I have data about myself, such as an account on a site or service, or in some desktop app, on my phone, or even from a device.
  • Collections - My data from the many different sources gets organized into common collections, such as places, contacts, messages, statuses, links, etc.
  • Apps - Once my data is in my locker I need apps that do useful or fun things for me, with the ability to control where my data goes and not have to give up access to my online accounts.

Once I "install" them in my locker (giving them some working space, a local port, and some config), I can browse to them where they provide their own instructions/steps (for now, it's early yet and pretty manual). To learn a bit more about the innards, I can install and run the Dev Docs app. :)

We need TONS of help and it's welcomed across the board, particularly in adding and advancing more of the connectors, just don a hard-hat and dig in, all patches welcomed, personal data FTW!

I am the platform.