{"id":20008901,"url":"https://github.com/jgilfelt/android-simpl3r","last_synced_at":"2025-10-07T23:14:29.215Z","repository":{"id":5729540,"uuid":"6941372","full_name":"jgilfelt/android-simpl3r","owner":"jgilfelt","description":"Amazon S3 multipart file upload for Android, made simple","archived":false,"fork":false,"pushed_at":"2013-04-08T12:40:25.000Z","size":2284,"stargazers_count":184,"open_issues_count":7,"forks_count":59,"subscribers_count":20,"default_branch":"master","last_synced_at":"2025-04-08T11:38:00.220Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Java","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/jgilfelt.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}},"created_at":"2012-11-30T15:44:00.000Z","updated_at":"2024-11-13T20:06:04.000Z","dependencies_parsed_at":"2022-08-24T21:40:49.038Z","dependency_job_id":null,"html_url":"https://github.com/jgilfelt/android-simpl3r","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jgilfelt%2Fandroid-simpl3r","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jgilfelt%2Fandroid-simpl3r/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jgilfelt%2Fandroid-simpl3r/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jgilfelt%2Fandroid-simpl3r/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jgilfelt","download_url":"https://codeload.github.com/jgilfelt/android-simpl3r/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252390532,"owners_count":21740339,"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-13T07:13:02.100Z","updated_at":"2025-10-07T23:14:24.141Z","avatar_url":"https://github.com/jgilfelt.png","language":"Java","funding_links":[],"categories":["Libs"],"sub_categories":["\u003cA NAME=\"SDK\"\u003e\u003c/A\u003eSDK"],"readme":"Simpl3r\n=======\n\nAmazon S3 multipart file upload for Android, made simple\n\n![screenshot](https://raw.github.com/jgilfelt/android-simpl3r/master/simpl3r.png \"screenshot\")\n\nThis library provides a simple high level Android API for robust and resumable multipart file uploads using the Amazon S3 service. All the complexity of file chunking, resuming, entity tag caching and interaction with Amazon's S3 API is abstracted from the developer. \n\nThis library manages synchronous file part uploads only. Part uploads performed in parallel are generally not suitable for mobile bandwidths.\n\nUsage\n-----\n\nUploads can be initiated as follows:\n\n```java\nAmazonS3Client s3Client = new AmazonS3Client(\n    new BasicAWSCredentials(YOUR_S3_ACCESS_KEY, YOUR_S3_SECRET));\n\nFile file = new File(\"path/to/some.file\");\nString s3Key = file.getPath();\n\n// create a new uploader for this file\nUploader uploader = new Uploader(this, s3Client, YOUR_S3_BUCKETNAME, s3Key, file);\n    \n// register listener for upload progress updates \nuploader.setProgressListener(new UploadProgressListener() {  \t\t\n    @Override\n    public void progressChanged(ProgressEvent progressEvent, \n            long bytesUploaded, int percentUploaded) {\n        // broadcast/notify ...\n    }\n});\n\n// initiate the upload\nString urlLocation = uploader.start();\n```\n\nSubsequent `Uploader` instances or calls to `start()` using the same `s3key` will attempt to resume the upload from the beginning of the last part that was uploaded successfully. A `SharedPreferences` instance for the supplied `Context` is used to cache the part ETags, or you can supply your own. You can also supply your own part size to the `Uploader`, but note that the minimum for the S3 API is 5 megabytes.\n\nThis project contains a working example project which more fully demonstrates its usage.\n\nDependencies\n------------\n\nThis library depends upon the [AWS SDK for Android](http://aws.amazon.com/sdkforandroid/), specifically the following components:\n\n* `aws-android-sdk-\u003cVERSION\u003e-core.jar`\n* `aws-android-sdk-\u003cVERSION\u003e-s3.jar`\n\nBuilding\n--------\n\nRun `ant jar` from the project directory or simply download a pre-built version from the `builds` directory of this GitHub repository.\n\nCredits\n-------\n\nAuthor: [Jeff Gilfelt](https://github.com/jgilfelt)\n\nLicense\n-------\n\n    Copyright 2012 readyState Software Limited\n\n    Licensed under the Apache License, Version 2.0 (the \"License\");\n    you may not use this file except in compliance with the License.\n    You may obtain a copy of the License at\n\n       http://www.apache.org/licenses/LICENSE-2.0\n\n    Unless required by applicable law or agreed to in writing, software\n    distributed under the License is distributed on an \"AS IS\" BASIS,\n    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n    See the License for the specific language governing permissions and\n    limitations under the License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjgilfelt%2Fandroid-simpl3r","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjgilfelt%2Fandroid-simpl3r","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjgilfelt%2Fandroid-simpl3r/lists"}