{"id":19252951,"url":"https://github.com/frc/frantic-s3-browser","last_synced_at":"2025-04-21T13:31:24.465Z","repository":{"id":5698238,"uuid":"6908799","full_name":"frc/Frantic-S3-Browser","owner":"frc","description":"File browser and uploader for Amazon S3. Fully HTML5 based, no server needed.","archived":false,"fork":false,"pushed_at":"2015-11-09T05:57:55.000Z","size":1624,"stargazers_count":95,"open_issues_count":4,"forks_count":36,"subscribers_count":49,"default_branch":"master","last_synced_at":"2025-03-27T15:02:41.318Z","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":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/frc.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2012-11-28T20:00:06.000Z","updated_at":"2025-01-02T03:34:35.000Z","dependencies_parsed_at":"2022-08-24T21:30:32.261Z","dependency_job_id":null,"html_url":"https://github.com/frc/Frantic-S3-Browser","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frc%2FFrantic-S3-Browser","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frc%2FFrantic-S3-Browser/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frc%2FFrantic-S3-Browser/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frc%2FFrantic-S3-Browser/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/frc","download_url":"https://codeload.github.com/frc/Frantic-S3-Browser/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250064643,"owners_count":21368944,"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-11-09T18:29:00.676Z","updated_at":"2025-04-21T13:31:23.976Z","avatar_url":"https://github.com/frc.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"Frantic-S3-Browser\n==================\n\nFrantic-S3-Browser is a file browser and uploader for Amazon S3. Fully HTML5 based,\nno server needed.\n\nYou can serve Frantic-S3-Browser from a single bucket and then create a bucket for each\ncustomer/project you want to serve. Frantic-S3-Browser is simply a browser-based client\nto S3 enabling you and your users to download and upload files in buckets.\n\nSetup: The website bucket for Frantic-S3-Browser\n================================================\n( If you want to quickly try out Frantic-S3-Browser you can skip this step and just use\nhttp://frc.github.com/Frantic-S3-Browser/ and create your bucket in the EU (Ireland) Region )\n\n - Add a new bucket using https://console.aws.amazon.com/s3/home - pay attention\n   that you place the bucket in the region you want it to be in. This bucket\n   is used to serve the login website to your users. You can customize it to match\n   your brand.\n\n - Add Bucket Policy for Website Access\n   Select the bucket, press \"Properties\". In the Permissions tab press\n   \"Add Bucket Policy\". Paste this in, replacing \"YOURBUCKETNAME\" with the name\n   of your bucket, and save the policy:\n\n```\n   {\n    \"Version\": \"2008-10-17\",\n    \"Statement\": [\n             {\n                \"Sid\": \"PublicReadGetObject\",\n                \"Effect\": \"Allow\",\n                \"Principal\": {\n                    \"AWS\": \"*\"\n                },\n                \"Action\": \"s3:GetObject\",\n                \"Resource\": \"arn:aws:s3:::YOURBUCKETNAME/*\"\n             }\n    ]\n   }\n```\n - Enable Website Access\n   Select the \"Website Access\" tab in Properties. Check Enabled [X], specify\n   \"index.html\" as the Index Document and \"error.html\" as the Error Document.\n   Note the endpoint Amazon gives to you and write it down. Press Save.\n\n - Customize the s3_endpoint at the end of the index.html file. It is set to EU (Ireland) Region\n   endpoint by default. See http://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region\n   for a listing of proper endpoints.\n\n - Upload all files of Frantic-S3-Browser to the root of the website bucket you just created.\n\nSetup: The bucket for a single customer's/project's data\n========================================================\n - Add the bucket\n   Add a new bucket using https://console.aws.amazon.com/s3/home - pay attention\n   that you place the bucket in the region you want it to be in.\n\n - If you want the connection to be secure (HTTPS) do not use dots in the bucket name.\n   Using dots in the bucket name will drop the connection to insecure HTTP.\n\n - Add a CORS policy to enable API requests\n   Go back to Permissions tab and press \"Add a CORS policy\". Paste this in:\n\n```\n   \u003cxml version=\"1.0\" encoding=\"UTF-8\"?\u003e\n   \u003cCORSConfiguration xmlns=\"http://s3.amazonaws.com/doc/2006-03-01/\"\u003e\n       \u003cCORSRule\u003e\n           \u003cAllowedOrigin\u003e*\u003c/AllowedOrigin\u003e\n           \u003cAllowedMethod\u003ePOST\u003c/AllowedMethod\u003e\n           \u003cAllowedMethod\u003eGET\u003c/AllowedMethod\u003e\n           \u003cAllowedHeader\u003e*\u003c/AllowedHeader\u003e\n       \u003c/CORSRule\u003e\n   \u003c/CORSConfiguration\u003e\n```\n\n - Add the user to access the bucket. Go to IAM, add a new user.\n   Save the Security Credentials, you will need them later in the setup.\n   Select the user's Permissions tab and add a Policy as follows.\n\n```\n   {\n    \"Statement\": [\n    {\n      \"Sid\": \"Stmnt1\",\n      \"Action\": [\n        \"s3:*\"\n      ],\n      \"Effect\": \"Allow\",\n      \"Resource\": [\n        \"arn:aws:s3:::YOURBUCKETNAME\",\"arn:aws:s3:::YOURBUCKETNAME/*\"\n      ]\n    }\n    ]\n   }\n```\n\n - Repeat this procedure for each customer/project bucket you need.\n\nSetup: Customizing Frantic-S3-Browser look and feel\n===================================================\nEdit css/branding.css.\n\n\nThank you\n=========\nRaymond Yee for publishing snippet\nhttp://blog.mashupguide.net/2008/11/25/amazon-s3-signature-calculation-in-javascript/\n\n\nCopyright\n=========\nCopyright (c) 2012-2015, Oskari Ojala, Lauri Kallioniemi, Miika Puputti, Frantic Oy\nAll rights reserved.\n\nRedistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:\n\nRedistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.\nRedistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.\nTHIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS \"AS IS\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n\nsha1.js\n Version 2.2 Copyright Paul Johnston 2000 - 2009.\n Other contributors: Greg Holt, Andrew Kepert, Ydnar, Lostinet\n Distributed under the BSD License\n See http://pajhome.org.uk/crypt/md5 for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffrc%2Ffrantic-s3-browser","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffrc%2Ffrantic-s3-browser","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffrc%2Ffrantic-s3-browser/lists"}