Website for my mum's fashion business
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Milan d322b1ab07 check in default.nix from nixfiles 8 months ago
_includes remove inline js 10 months ago
_layouts Initial commit 1 year ago
_plugins renaming the file 11 months ago
_script Add files via upload 11 months ago
css Added RSS button 11 months ago
img Added RSS button 11 months ago
js remove inline js 10 months ago
photos/original add pictures 10 months ago
.gitattributes Initial commit 1 year ago
.gitignore Made .DS_Store .gitignore rule affect all directories 11 months ago
404.html Fixes 11 months ago
Dockerfile Add Dockerfile to allow serving photo-stream from a container 11 months ago
Gemfile 404 1 year ago
Gemfile.lock Cache processed images. 11 months ago
LICENSE Added license 11 months ago Update 11 months ago
_config.yml config 10 months ago
about.markdown A working, unoptimized photo stream 1 year ago
default.nix check in default.nix from nixfiles 8 months ago
favicon.png Buttons are now visible on white background, theme-aware favicon 1 year ago
favicon.svg Closes 11 months ago
feed.xml Improved RSS timestamps 11 months ago
gemset.nix check in default.nix from nixfiles 8 months ago
index.html remove inline js 10 months ago
social-preview.png remove big files 10 months ago
touch-icon-iphone.png Matching corners 11 months ago

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.



  • 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.

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 '' 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 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:
  • 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.


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.


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.