Package: simple-photo-gallery
Simple Photo GalleryImportant: I'm currently very busy in my job, so I don't have much time to support this project. It seems there is some interest in it on a regular basis, so I'd be happy to give admin access to another developer that wants to maintain/develop the project further. Please get in touch with me if you are interested.Check out the newProject Page!With Simple Photo Gallery you can create beautiful and simple photo galleries that help you tell your story. Check out theexample gallery.OverviewInstallationUsageHostingConfigurationAboutSimple Photo Gallery is a simple command line tool written in Python that helps you create static HTML photo and video galleries that tell a story. Thumbnails, HTML, CSS and JavaScript files are generated automatically and can be uploaded to any static hosting, like for exampleAWS S3orNetlify. The most important features:Responsive layout suitable for any device (including touch gestures support).Image captions extracted from the image metadata (EXIF tags).Fully customizable layout with sensible defaults to get started quickly.Create a gallery from an existing OneDrive or Google Photos album, without downloading the photos.Automatic upload of the gallery toAWS S3orNetlify.Based on thePhotoSwipeJavaScript library.InstallationSimple Photo Gallery can be easily installed withpip. If you don't havepip, please install thelatest Python release.pip install simple-photo-galleryIt might be a really good idea to use aPython virtual environment to install
simple-photo-gallery.Example UsageYou can quickly create a gallery with the default settings. For more detailed information seeUsage.Collect all the photos and videos you want to have in the gallery into a folder.Open a terminal and go to the folder with your photos. Use the following command to initialize the gallery. The script will ask you a few questions, like gallery name or background image. You can always just press Enter for the default settings and change them later.gallery-initTo generate the photos' thumbnails and to create the gallery HTML, CSS and JS files use the following command:gallery-buildThe gallery is ready! You can view it by opening theindex.htmlfile in thepublicfolder. Thepublicfolder contains all the files you need for your gallery and you can host it on any static hosting provider.NoteYour photos and videos are copied inpublic/images/photos.Optionally, you can directly publish the gallery onNetlify, which offers a free plan.SeeGallery Configurationfor more details how you can customize your gallery. You can also find two example galleries in theexamplesfolder.HostingYou can automatically upload the gallery toAWS S3orNetlify.For Netlify you just need a free account and then you can run the following command to upload to a new website.gallery-upload netlifyFor AWS S3 you need to haveAmazon Command Line Interfaceinstalled and configured and a bucket that can be accessed publicly (see theAWS tutorialfor hosting a static website).gallery-upload aws s3://<your_bucket>/<path>/You can upload your gallery manually on any static hosting provider, like for exampleAWS S3,GitHub Pages,Netlifyor others. Some scripts for automatic upload of the gallery are under work.AboutSimple Photo Gallery is developed byVladimir Haltakov. I wanted an easy way to share photos with friends, but wasn't happy with the limited customization options that existing sharing solutions like Amazon Photos or iCloud offer.Please contact me onTwitterif you have any questions, ideas for improvement or feature requests.