Photo Stream is a simpler home for your photos initially created by @maxvoltar and now maintained by @waschinski and friends. Easy to use, self hosted, no tracking, just photos.
- floremotion.de
- maxvoltar.photo
- joeyabanks.photo
- photos.alexbaldwin.com
- jad.photos
- photo.silvandaehn.com
- chriszeta.it
- rafa.photo
- 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 @maxvoltar has 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.
Previously the recommended way to install Photo Stream was to fork the repository. In my opinion this was not really optimal and being a fan of Docker I began working on optimizations to run Photo Stream in a container. That's why configuration has been moved from _config.yml to .env so when switching from the initial repo you will have to set up the .env file accordingly.
There is an image over at Docker Hub which you can pull using:
docker pull waschinski/photo-stream:latestAlternatively download the docker-compose.yml file, change the configuration as needed and use the following command to get Photo Stream running:
docker-compose up -dThe photos folder can be mounted as a volume. Make sure to put your photos in a folder called original.
Prerequisites : docker and docker-compose are installed on RPI
In docker-compose.yml comment image section, uncomment build section, and setup BASE_REPO arg to arm32v6/ruby:3.0.1-alpine3.12.
Then docker-compose build
Then docker-compose up -d
Grab the latest version from the release page and extract it.
Make sure you meet the following requirements in order to run Photo Stream:
How to install these depends on your OS. Debian users will go with sudo apt-get install build-essential while on MacOS you should be fine with xcode-select --install.
Check to see if you already have Ruby installed (ruby -v). If you don't, you can follow the installation instructions provided here.
Instructions on how to install libvips can be found here.
Next you'll have to install Jekyll (a simple gem install bundler jekyll should suffice). Make sure you meet its requirements or install them as well before proceeding.
Once all these requirements are met you can finally install all the gems required by Photo Stream (you should be in the Photo Stream folder):
bundle installPut your photos (not resized) in the photos/original 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 serveYou can also statically build your site to be uploaded to a regular webhost.
bundle exec jekyll buildNow upload the contents of the _site/ directory to your webserver.
Just execute the script you need to run directly from the _scripts folder like that:
sh ./_script/build-n-lftp.shbuild.sh will build your site while rsync.sh and lftp.sh will sync it accordingly. build-n-rsync.sh and build-n-lftp.sh are simply doing both steps in one. Don't forget to add your sync configuration in the .env file.
First thing you want to do is edit a couple of things in /.env:
TITLE: The title of your photo streamEMAIL: Your email address (this line is optional, you can remove it)AUTHOR_NAME: Your nameAUTHOR_EMAIL: Your email address (optional)AUTHOR_WEBSITE: Your website (could be the address of this photo stream)DESCRIPTION: Description of your photo streamBASEURL: Should be left empty or removed⚠️ Do not change unless you know what you're doingURL: Where will this photo stream live (example:https://maxvoltar.photo)SHOW_OFFICIAL_GITHUB: Set to either1or0to enable or disable showing the link to the official github repositoryALLOW_ORDER_SORT_CHANGE: Set to either1or0to enable or disable the 'reverse sort order' featureTWITTER_USERNAME: Your Twitter username or remove/comment this lineGITHUB_USERNAME: Your Github username or remove/comment this lineINSTAGRAM_USERNAME: Your Instagram username or remove/comment this lineSYNCUSER: Your username being used by lftp/rsync in the shell scripts to sync your site to your webserverSYNCPASS: Your password being used by lftp/rsync in the shell scripts to sync your site to your webserverSYNCSERVER: The URL of your webserver being used by lftp/rsync in the shell scripts where your site will be synced toSYNCFOLDER: The folder on your webserver being used by lftp/rsync in the shell scripts where your site will be synced to
Don't include the @-part of your social handles. Links to your Github, Twitter and Instagram profiles are only shown when set.
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.