revskill/pinry

Pinry is a private, self-hosted, Pinterest inspired by Wookmark and built on top of Django.

Why?

Mostly because I don't like sharing, I use pinup boards for personal inspiration boards. Also if I use a public platform like Pinterest or Wookmark then my pins run the risk of getting a DMCA take down notice. I might not even be able to pin something at all with websites now blocking tools like this. I rather bypass all these risks and just host it myself.

Getting Started

Pinry has three different customizable configurations:

Development

Have virtualenv and pip installed. You may also need to have the build dependencies for PIL installed.

$ git clone git://github.com/overshard/pinry.git
$ cd pinry
$ virtualenv .
$ bin/pip install -r requirements/development.txt
$ bin/python manage.py syncdb
$ bin/python manage.py migrate
$ bin/python manage.py runserver

Note: If you are on Ubuntu 12.04 there is a bug in PIL that causes it to not build in JPG and PNG support. You'll need to follow all the steps above except before virtualenv . run sudo apt-get install python-imaging and instead of virtualenv . run virtualenv --system-site-packages .. On older versions of Ubuntu and older Linux distributions you'll need to install PIL dependencies. On Ubuntu this can be done with sudo apt-get build-dep python-imaging.

Jenkins

If you want to use Pinry with your own Jenkins server I've already setup all of the settings on Pinry, just follow the instructions starting at section 3 on the official Django Jenkins Tutorial.

A quick tip, when you get to the Add build step -> Execute shell step instead of using his example use:

virtualenv --system-site-packages .
bin/pip install -r requirements/jenkins.txt
bin/python manage.py jenkins --settings=pinry.settings.jenkins

As noted in development be sure you have PIL installed or it's build dependencies.

Production

If you want a production server Google around for more information on running Django in a production environment and create a pinry/settings/production.py file. I don't cover this because there are hundreds of different ways to deploy a Django project and everyone has their own preference.

Build Status

For build information on the latest commit head over to my Jenkins server. You'll get useful information on if all my tests are passing, my test coverage, and if I'm conforming with pylint and pep8 standards.

Roadmap

Non-image URL pinning
Bookmarklet
Tagging, groups, multiple and/or user boards
Statistics/analytics with pretty graphs

As Seen On

License (Simplified BSD)

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

revskill / pinry