Photo stream is a simpler home for your photos by @maxvoltar and friends. Easy to use, self hosted, no tracking, just photos.
Feel free to send me your photo streams on Twitter, or open a PR.
- 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
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.
- Fork this repo
- Clear the
photos/originalsdirectory - Add your own photos
- Deploy your forked copy to Netlify (free by default, you can add your own domain and analytics for a reasonable price)
- In your build & deploy settings, set "Build command" to
jekyll buildand "Publish directory" to_site/. - Enjoy your very own photo stream!
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 installYou'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 vipsPut 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.
bundle exec jekyll serveFirst 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)authorname: 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 doingurl: Where will this photo stream live (example:https://maxvoltar.photo)twitter_username: Your Twitter usernamegithub_username: Your Github usernameinstagram_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.
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.
- You might see a
VIPS-WARNINGmessage while runningjekyll serve. This is a bug in libvips that's being tracked, but it's harmless.