Self-hosted, super simple photo stream
This project is no longer being maintained by me. Please go to https://github.com/waschinski/photo-stream/ a version maintained by someone who actually knows what they're doing :)
Photo stream is a simpler home for your photos by @maxvoltar and friends. Easy to use, self hosted, no tracking, just photos.
We like to take photos and share them. Problem is it's hard to really own your photos and how they're represented across social media these days, so we set out to make a place for them. You host it yourself, wherever you want (Netlify, Github Pages...), you're in control.
photos/original
directoryjekyll build
and "Publish directory" to _site/
.Check to see if you have Ruby installed (ruby -v
). If you don't, you can follow the installation instructions provided here.
Next you'll have to install Jekyll (a simple gem install bundler jekyll
should suffice).
bundle install
You'll also need some additional dependencies:
# Make sure xcode CLT is installed first:
xcode-select --install
# This takes a while. Plug your laptop in and go grab a coffee, a book, or just
# like, take a sec away from the computer and breathe for a bit.
brew install glib vips
Put your photos (not resized) in the photos/originals
directory. Optionally you can give them a name, which will appear as the title of the photo page and in the RSS feed.
This command will serve the static page on your local machine. http://localhost:4000
bundle exec jekyll serve
You can also statically build your site to be uploaded to a regular webhost.
bundle exec jekyll build
Now upload the contents of the _site/ directory to your webserver.
Copy the bash script 'build-n-rsync.sh' from the _script directory to the root of your photo-stream folder. Fill in the required credentials & run the script. It will build & upload your site.
First thing you want to do is edit a couple of things in /_config.yml
:
title
: The title of your photo streamemail
: Your email address (this line is optional, you can remove it)author
name
: Your nameemail
: Your email address (optional)website
: Your website (could be the address of this photo stream)description
: Description of your photo streambaseurl
: Should be ""
⚠️ Do not change unless you know what you're doing
url
: Where will this photo stream live (example: https://maxvoltar.photo
)twitter_username
: Your Twitter usernamegithub_username
: Your Github usernameinstagram_username
: Your Instagram usernameDon't include the @
-part of your social handles. By default links to your Github and Instagram profiles are hidden. You can uncomment these by going into /index.html
. There, you can also add links to wherever you want. Just add more <li>
's with class="link"
to the <ul class="links">
list.
Before publishing your website, Jekyll will resize your photos into 3 different buckets:
/photos/large
: These are only shown when a user navigates to a photo page. By default these are resized to a maximum of 2048 wide and 2048 tall. If you wish, you can change these by changing the values in /_config.yml
(by default they look something like this: resize_to_limit: [2048, 2048]
)./photos/thumbnail
: These are used in the grid. Photo Stream will load all thumbnails above the fold, then more as you scroll down; all to save bandwidth. Standard size for these is 640 by 640 (max), but you can also change this if needed./photos/tint
: What you see while the page loads its first batch of thumbnails, also used as the background for photo pages. ⚠️ Do not make changes to the tint versions in your config file.
VIPS-WARNING
message while running jekyll serve
. This is a bug in libvips that's being tracked, but it's harmless.