{"id":13604204,"url":"https://github.com/amitshekhariitbhu/PRDownloader","last_synced_at":"2025-04-11T23:31:57.381Z","repository":{"id":37493322,"uuid":"110373758","full_name":"amitshekhariitbhu/PRDownloader","owner":"amitshekhariitbhu","description":"PRDownloader - A file downloader library for Android with pause and resume support","archived":false,"fork":false,"pushed_at":"2025-03-05T15:06:55.000Z","size":477,"stargazers_count":3314,"open_issues_count":123,"forks_count":540,"subscribers_count":75,"default_branch":"master","last_synced_at":"2025-04-11T06:18:14.724Z","etag":null,"topics":["android","breakpoint","download-manager","downloader","filedownloader","http","https","large-files","library","pause","resume"],"latest_commit_sha":null,"homepage":"https://outcomeschool.com","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/amitshekhariitbhu.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","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":"2017-11-11T19:29:38.000Z","updated_at":"2025-04-09T03:45:08.000Z","dependencies_parsed_at":"2024-11-07T08:34:12.121Z","dependency_job_id":"8babaa7b-84cc-42d5-a10b-96144110a838","html_url":"https://github.com/amitshekhariitbhu/PRDownloader","commit_stats":null,"previous_names":["mindorksopensource/prdownloader"],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amitshekhariitbhu%2FPRDownloader","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amitshekhariitbhu%2FPRDownloader/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amitshekhariitbhu%2FPRDownloader/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amitshekhariitbhu%2FPRDownloader/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/amitshekhariitbhu","download_url":"https://codeload.github.com/amitshekhariitbhu/PRDownloader/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248351423,"owners_count":21089281,"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":["android","breakpoint","download-manager","downloader","filedownloader","http","https","large-files","library","pause","resume"],"created_at":"2024-08-01T19:00:41.561Z","updated_at":"2025-04-11T23:31:57.370Z","avatar_url":"https://github.com/amitshekhariitbhu.png","language":"Java","funding_links":[],"categories":["Java"],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n\u003cimg alt=\"PRDownloader\" src=https://raw.githubusercontent.com/amitshekhariitbhu/PRDownloader/master/assets/prdownloader.png /\u003e\n\u003c/p\u003e\n\n# PRDownloader - A file downloader library for Android with pause and resume support\n\n## Sample Download\n\u003cimg src=https://raw.githubusercontent.com/amitshekhariitbhu/PRDownloader/master/assets/sample_download.png width=360 height=640 /\u003e\n\n### Overview of PRDownloader library\n* PRDownloader can be used to download any type of files like image, video, pdf, apk and etc.\n* This file downloader library supports pause and resume while downloading a file.\n* Supports large file download.\n* This downloader library has a simple interface to make download request.\n* We can check if the status of downloading with the given download Id.\n* PRDownloader gives callbacks for everything like onProgress, onCancel, onStart, onError and etc while downloading a file.\n* Supports proper request canceling.\n* Many requests can be made in parallel.\n* All types of customization are possible.\n\n## About me\n\nHi, I am Amit Shekhar, Co-Founder @ [Outcome School](https://outcomeschool.com) • IIT 2010-14 • I have taught and mentored many developers, and their efforts landed them high-paying tech jobs, helped many tech companies in solving their unique problems, and created many open-source libraries being used by top companies. I am passionate about sharing knowledge through open-source, blogs, and videos.\n\nYou can connect with me on:\n\n- [Twitter](https://twitter.com/amitiitbhu)\n- [YouTube](https://www.youtube.com/@amitshekhar)\n- [LinkedIn](https://www.linkedin.com/in/amit-shekhar-iitbhu)\n- [GitHub](https://github.com/amitshekhariitbhu)\n\n## Using PRDownloader Library in your Android application\n\nAdd this in your `settings.gradle`:\n```groovy\nmaven { url 'https://jitpack.io' }\n```\n\nIf you are using `settings.gradle.kts`, add the following:\n```kotlin\nmaven { setUrl(\"https://jitpack.io\") }\n```\n\nAdd this in your `build.gradle`\n```groovy\nimplementation 'com.github.amitshekhariitbhu:PRDownloader:1.0.2'\n```\n\nIf you are using `build.gradle.kts`, add the following:\n```kotlin\nimplementation(\"com.github.amitshekhariitbhu:PRDownloader:1.0.2\")\n```\n\nDo not forget to add internet permission in manifest if already not present\n```xml\n\u003cuses-permission android:name=\"android.permission.INTERNET\" /\u003e\n```\nThen initialize it in onCreate() Method of application class :\n```java\nPRDownloader.initialize(getApplicationContext());\n```\nInitializing it with some customization\n```java\n// Enabling database for resume support even after the application is killed:\nPRDownloaderConfig config = PRDownloaderConfig.newBuilder()\n                .setDatabaseEnabled(true)\n                .build();\nPRDownloader.initialize(getApplicationContext(), config);\n\n// Setting timeout globally for the download network requests:\nPRDownloaderConfig config = PRDownloaderConfig.newBuilder()\n                .setReadTimeout(30_000)\n                .setConnectTimeout(30_000)\n                .build();\nPRDownloader.initialize(getApplicationContext(), config); \n```\n\n### Make a download request\n```java\nint downloadId = PRDownloader.download(url, dirPath, fileName)\n                        .build()\n                        .setOnStartOrResumeListener(new OnStartOrResumeListener() {\n                            @Override\n                            public void onStartOrResume() {\n                               \n                            }\n                        })\n                        .setOnPauseListener(new OnPauseListener() {\n                            @Override\n                            public void onPause() {\n                               \n                            }\n                        })\n                        .setOnCancelListener(new OnCancelListener() {\n                            @Override\n                            public void onCancel() {\n                                \n                            }\n                        })\n                        .setOnProgressListener(new OnProgressListener() {\n                            @Override\n                            public void onProgress(Progress progress) {\n                               \n                            }\n                        })\n                        .start(new OnDownloadListener() {\n                            @Override\n                            public void onDownloadComplete() {\n                               \n                            }\n\n                            @Override\n                            public void onError(Error error) {\n                               \n                            }\n                        });            \n```\n\n### Pause a download request\n```java\nPRDownloader.pause(downloadId);\n```\n\n### Resume a download request\n```java\nPRDownloader.resume(downloadId);\n```\n\n### Cancel a download request\n```java\n// Cancel with the download id\nPRDownloader.cancel(downloadId);\n// The tag can be set to any request and then can be used to cancel the request\nPRDownloader.cancel(TAG);\n// Cancel all the requests\nPRDownloader.cancelAll();\n```\n\n### Status of a download request\n```java\nStatus status = PRDownloader.getStatus(downloadId);\n```\n\n### Clean up resumed files if database enabled\n```java\n// Method to clean up temporary resumed files which is older than the given day\nPRDownloader.cleanUp(days);\n```\n### TODO\n* Integration with other libraries like OkHttp, RxJava\n* Test Cases\n* And of course many many features and bug fixes\n\n## [Outcome School Blog](https://outcomeschool.com/blog) - High-quality content to learn Android concepts.\n\n## If this library helps you in anyway, show your love :heart: by putting a :star: on this project :v:\n\n### License\n```\n   Copyright (C) 2024 Amit Shekhar\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```\n\n### Contributing to PRDownloader\nAll pull requests are welcome, make sure to follow the [contribution guidelines](CONTRIBUTING.md)\nwhen you submit pull request.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famitshekhariitbhu%2FPRDownloader","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Famitshekhariitbhu%2FPRDownloader","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famitshekhariitbhu%2FPRDownloader/lists"}