Skip to content
Self-hosted, super simple photo stream
HTML Ruby CSS Shell Dockerfile JavaScript
Branch: master
Clone or download

README.md

Photo Stream Social Preview

Photo Stream

Photo stream is a simpler home for your photos by @maxvoltar and friends. Easy to use, self hosted, no tracking, just photos.

Examples

Features

  • Lazy loading
  • Only load larger resolutions when needed (to save on bandwidth)
  • Photo tints
  • Keyboard shortcuts
  • Unique URL's for photos
  • RSS feed (Which you can plug into IFTTT and set up auto-posting to most social networks, like I've done here. Make sure you select "Post a tweet with image" when setting it up to embed the photo.)
  • Drag, drop, commit workflow (learn more about how to add photos to your stream)
  • Optimized light and dark themes (auto-enabled depending on your OS preferences)
  • Optional: Links to your social networks

Why?

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.

How to install

The easy way

  1. Fork this repo
  2. Clear the photos/original directory
  3. Add your own photos
  4. Deploy your forked copy to Netlify (free by default, you can add your own domain and analytics for a reasonable price)
  5. In your build & deploy settings, set "Build command" to jekyll build and "Publish directory" to _site/.
  6. Enjoy your very own photo stream!

The slightly-less-easy-but-still-totally-doable way

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

How to use

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.

Automating the build & upload with rsync

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.

Customize

Basics

First thing you want to do is edit a couple of things in /_config.yml:

  • title: The title of your photo stream
  • email: Your email address (this line is optional, you can remove it)
  • author
    • name: Your name
    • email: Your email address (optional)
    • website: Your website (could be the address of this photo stream)
  • description: Description of your photo stream
  • baseurl: 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 username
  • github_username: Your Github username
  • instagram_username: Your Instagram username

Don'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.

Advanced

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.

Credits

Known issues

  • You might see a VIPS-WARNING message while running jekyll serve. This is a bug in libvips that's being tracked, but it's harmless.
You can’t perform that action at this time.