{"id":17888110,"url":"https://github.com/fireflycons/aws-s3-photoviewer-sample","last_synced_at":"2025-07-16T11:15:27.126Z","repository":{"id":96974342,"uuid":"190936971","full_name":"fireflycons/aws-s3-photoviewer-sample","owner":"fireflycons","description":"Viewing Photos in an Amazon S3 Bucket from a Browser","archived":false,"fork":false,"pushed_at":"2019-06-08T21:38:37.000Z","size":624,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-04-03T02:42:22.178Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fireflycons.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-06-08T21:30:09.000Z","updated_at":"2023-09-15T14:09:41.000Z","dependencies_parsed_at":"2024-03-06T18:02:21.296Z","dependency_job_id":null,"html_url":"https://github.com/fireflycons/aws-s3-photoviewer-sample","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/fireflycons/aws-s3-photoviewer-sample","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fireflycons%2Faws-s3-photoviewer-sample","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fireflycons%2Faws-s3-photoviewer-sample/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fireflycons%2Faws-s3-photoviewer-sample/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fireflycons%2Faws-s3-photoviewer-sample/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fireflycons","download_url":"https://codeload.github.com/fireflycons/aws-s3-photoviewer-sample/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fireflycons%2Faws-s3-photoviewer-sample/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265505548,"owners_count":23778535,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-28T13:36:34.657Z","updated_at":"2025-07-16T11:15:27.086Z","avatar_url":"https://github.com/fireflycons.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Viewing Photos in an Amazon S3 Bucket from a Browser\n\nThis litte project builds on the [AWS JavaScript example of the same name](https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/s3-example-photos-view.html). The major difference is that by the use of CloudFormation, you can get the sample up and running in a few minutes.\n\n## Disclaimer\n\nThis sample is not intended for use as-is. If you deploy it -\n\n* It is insecure - HTTP only access.\n* It is public - Anyone with the URL can view all images you place in the photo bucket.\n\n## Minor changes to Amazon's Sample\n\nBy and large, it is the same as the Amazon sample; note the naming convetion for image files on their page, however\n\n* The photo bucket is non-public. The JavaScript generates a pre-signed URL to access the content.\n\n## Cloudformation Template\n\nThe provided template deploys all the resources described in the AWS example. Two optional input parameters may be used\n\n1. `PhotoBucketPrefix` - Prefixes the name of the S3 bucket created to contain photo albums. It defaults to `photo-albums`\n1. `WebsiteBucketPrefix` - Prefixes the name of the S3 bucket created to host the web site files. It defaults to `photo-website`\n\n## Deploying the Sample\n\nYou will need to install and configure the [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-install.html) for your platform.\n\n1. Deploy the CloudFormation Template using either the AWS console or your favourite CloudFormation deployment mechanism (plug: [PSCloudFormation](https://github.com/fireflycons/PSCloudFormation))\n1. In the CloudFormation console, find the stack you deployed and go to the output tab. You'll need all the values here.\n1. Edit `web/PhotoViewer.js`, find the lines commented `**DO THIS**` and follow instructions in the comment.\n1. Optionally edit `web/index.html`, find the line commented `**DO THIS**` and update the JavaScript API version.\n1. Open a command shell and use AWS CLI to upload the web and album artifacts. Paste in the appropriate stack outputs in the script below first.\n```\ncd web\naws s3 sync . PhotoBucketS3Url_from_stack_outputs\ncd ../album\naws s3 sync . WebsiteBucketS3Url_from_stack_outputs\n```\n6. Browse your new site by visiting the URL in the stack output `WebsiteURL`.\n\n## Sample Images\n\nThe sample images included in this repo were obtained from [Free-Images.com](https://free-images.com/)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffireflycons%2Faws-s3-photoviewer-sample","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffireflycons%2Faws-s3-photoviewer-sample","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffireflycons%2Faws-s3-photoviewer-sample/lists"}