{"id":13464955,"url":"https://github.com/AdguardTeam/AdguardForiOS","last_synced_at":"2025-03-25T13:32:53.281Z","repository":{"id":37405830,"uuid":"43807802","full_name":"AdguardTeam/AdguardForiOS","owner":"AdguardTeam","description":"The most advanced ad blocker for iOS","archived":false,"fork":false,"pushed_at":"2025-03-14T12:00:31.000Z","size":659775,"stargazers_count":1499,"open_issues_count":210,"forks_count":210,"subscribers_count":92,"default_branch":"version/v4.5","last_synced_at":"2025-03-22T00:01:45.660Z","etag":null,"topics":["adblock","adguard","content-blocker","ios","open-source","safari"],"latest_commit_sha":null,"homepage":"https://adguard.com/","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AdguardTeam.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":"SupportingScripts/get_providers.sh","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2015-10-07T10:04:16.000Z","updated_at":"2025-03-21T12:08:42.000Z","dependencies_parsed_at":"2024-01-22T19:33:11.898Z","dependency_job_id":"57f7e71c-cecf-4050-9a72-cb7daebe7903","html_url":"https://github.com/AdguardTeam/AdguardForiOS","commit_stats":{"total_commits":4560,"total_committers":34,"mean_commits":"134.11764705882354","dds":0.6826754385964913,"last_synced_commit":"25f8f104b1f775f3a2abc2f160db3eb40adffa07"},"previous_names":[],"tags_count":455,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AdguardTeam%2FAdguardForiOS","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AdguardTeam%2FAdguardForiOS/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AdguardTeam%2FAdguardForiOS/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AdguardTeam%2FAdguardForiOS/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AdguardTeam","download_url":"https://codeload.github.com/AdguardTeam/AdguardForiOS/tar.gz/refs/heads/version/v4.5","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245471229,"owners_count":20620903,"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":["adblock","adguard","content-blocker","ios","open-source","safari"],"created_at":"2024-07-31T14:00:53.450Z","updated_at":"2025-03-25T13:32:53.271Z","avatar_url":"https://github.com/AdguardTeam.png","language":"Swift","readme":"\u0026nbsp;\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://cdn.adguard.com/public/Adguard/Common/Logos/ios.svg\" width=\"300px\" alt=\"AdGuard for iOS\"\n /\u003e\n  \u003c/p\u003e\n\u003ch3 align=\"center\"\u003eThe most advanced Safari content blocker and privacy keeper for iOS\u003c/h3\u003e\n\u003cp align=\"center\"\u003e\n  Top-notch ad blocking in Safari, anti-tracking protection and DNS privacy.\n\u003c/p\u003e\n\n  \u003cp align=\"center\"\u003e\n    \u003ca href=\"https://adguard.com/\"\u003eWebsite\u003c/a\u003e |\n    \u003ca href=\"https://reddit.com/r/Adguard\"\u003eReddit\u003c/a\u003e |\n    \u003ca href=\"https://twitter.com/AdGuard\"\u003eTwitter\u003c/a\u003e |\n    \u003ca href=\"https://t.me/adguard_en\"\u003eTelegram\u003c/a\u003e\n    \u003cbr/\u003e\u003cbr/\u003e\n    \u003ca href=\"https://github.com/AdguardTeam/AdguardForiOS/issues?q=sort%3Acreated-desc%20label%3ABug%20is%3Aopen%20-label%3A%22Status%3A%20Closed%22%2C%22Status%3A%20Resolved%22%20\"\u003e\n        \u003cimg src=\"https://img.shields.io/github/issues-search/AdguardTeam/AdguardForiOS?color=orangered\u0026label=%F0%9F%90%9B%20Open%20bugs\u0026query=sort%3Acreated-desc%20label%3ABug%20is%3Aopen%20-label%3A%22Status%3A%20Closed%22%2C%22Status%3A%20Resolved%22%20\" /\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://github.com/AdguardTeam/AdguardForiOS/issues?q=sort%3Acreated-desc%20label%3ABug%20label%3A%22Status%3A%20Resolved%22%2C%22Status%3A%20Closed%22%20-label%3A%22Resolution%3A%20Won%27t%20Do%22%2C%22Resolution%3A%20Won%27t%20Fix%22%2C%22Resolution%3A%20Duplicate%22%2C%22Resolution%3A%20Incomplete%22%2C%22Resolution%3A%20Cannot%20Reproduce%22%20\"\u003e\n        \u003cimg src=\"https://img.shields.io/github/issues-search/AdguardTeam/AdguardForiOS?color=goldenrod\u0026label=Resolved\u0026query=sort%3Acreated-desc%20label%3ABug%20label%3A%22Status%3A%20Resolved%22%2C%22Status%3A%20Closed%22%20-label%3A%22Resolution%3A%20Won%27t%20Do%22%2C%22Resolution%3A%20Won%27t%20Fix%22%2C%22Resolution%3A%20Duplicate%22%2C%22Resolution%3A%20Incomplete%22%2C%22Resolution%3A%20Cannot%20Reproduce%22%20\" /\u003e\n    \u003c/a\u003e\n    \u003cbr /\u003e\n    \u003ca href=\"https://github.com/AdguardTeam/AdguardForiOS/issues?q=label%3A%22Feature%20request%22%2CEnhancement%20state%3Aopen%20sort%3Areactions-%2B1-desc%20-label%3A%22Status%3A%20Closed%22%2C%22Status%3A%20Resolved%22%2Cautomatic%20\"\u003e\n        \u003cimg src=\"https://img.shields.io/github/issues-search/AdguardTeam/AdguardForiOS?color=seagreen\u0026label=%F0%9F%9A%80%20Open%20feature%20requests\u0026query=label%3A%22Feature%20request%22%2CEnhancement%20state%3Aopen%20sort%3Areactions-%2B1-desc%20-label%3A%22Status%3A%20Closed%22%2C%22Status%3A%20Resolved%22%2Cautomatic%20\" /\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://github.com/AdguardTeam/AdguardForiOS/issues?q=sort%3Areactions-%2B1-desc%20label%3A%22Feature%20request%22%2CEnhancement%20label%3A%22Status%3A%20Resolved%22%2C%22Status%3A%20Closed%22%20-label%3A%22Resolution%3A%20Won%27t%20Do%22%2C%22Resolution%3A%20Won%27t%20Fix%22%2C%22Resolution%3A%20Duplicate%22%2C%22Resolution%3A%20Incomplete%22%2C%22Resolution%3A%20Cannot%20Reproduce%22%2Cautomatic%20\"\u003e\n        \u003cimg src=\"https://img.shields.io/github/issues-search/AdguardTeam/AdguardForiOS?color=%2358A459\u0026label=Implemented\u0026query=sort%3Areactions-%2B1-desc%20label%3A%22Feature%20request%22%2CEnhancement%20label%3A%22Status%3A%20Resolved%22%2C%22Status%3A%20Closed%22%20-label%3A%22Resolution%3A%20Won%27t%20Do%22%2C%22Resolution%3A%20Won%27t%20Fix%22%2C%22Resolution%3A%20Duplicate%22%2C%22Resolution%3A%20Incomplete%22%2C%22Resolution%3A%20Cannot%20Reproduce%22%2Cautomatic%20\" /\u003e\n    \u003c/a\u003e\n    \u003cbr /\u003e\n    \u003ca href=\"https://github.com/AdguardTeam/AdguardForiOS/releases\"\u003e\n      \u003cimg src=\"https://img.shields.io/github/release/AdguardTeam/AdguardForiOS/all.svg\" alt=\"Latest release\" /\u003e\n    \u003c/a\u003e\n  \u003c/p\u003e\n\n  \u003cp align=\"center\"\u003e\n    \u003ca href=\"https://agrd.io/github_ios_adblocker\"\u003e\n      \u003cimg src=\"https://toolbox.marketingtools.apple.com/api/v2/badges/download-on-the-app-store/black/en-us\" alt=\"Download on the App Store\" height=\"48\" /\u003e\n    \u003c/a\u003e\n  \u003c/p\u003e\n\n\u0026nbsp;\n- [Contribution](#contribution)\n  - [How to report an issue](#issue)\n  - [Translating AdGuard](#contribution-translating)\n  - [Other options](#contribution-other)\n  - [How to become a Beta tester](#beta-tester)\n- [Our plans](#our-plans)\n- [How to build](#how-to-build)\n\nAdGuard for iOS is an app that blocks ads in Safari browser at exceptional level, and also provides additional Premium features like configurable DNS settings, encrypted DNS support (DOH, DOT, DNSCrypt), and custom ad blocking subscriptions. To get more information and to download AdGuard for iOS, [visit our website](https://adguard.com/adguard-ios/overview.html).\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"https://user-images.githubusercontent.com/17472907/105178597-4b542000-5b39-11eb-86ed-136f0697bcec.png\" width=\"250\"\u003e \u003cimg src=\"https://user-images.githubusercontent.com/17472907/105178604-4f803d80-5b39-11eb-9381-24682e06b8d8.png\" width=\"250\"\u003e \u003cimg src=\"https://user-images.githubusercontent.com/17472907/105339304-93347f00-5bed-11eb-99b6-ab438b34eb34.png\" width=\"250\"\u003e \u003cimg src=\"https://user-images.githubusercontent.com/17472907/105178609-50b16a80-5b39-11eb-9723-5179fb811b65.png\" width=\"250\"\u003e \u003cimg src=\"https://user-images.githubusercontent.com/17472907/105339299-92035200-5bed-11eb-87ef-a7171432fe5d.png\" width=\"250\"\u003e \u003cimg src=\"https://user-images.githubusercontent.com/17472907/105178607-5018d400-5b39-11eb-97d6-9dc792b28654.png\" width=\"250\"\u003e\n\u003c/p\u003e\n\n\u003ca id=\"contribution\"\u003e\u003c/a\u003e\n\n## Contribution\n\n\u003ca id=\"issue\"\u003e\u003c/a\u003e\n\n### How to report an issue?\n\nGitHub can be used to report a bug or to submit a feature request. To do so, go to [this page](https://github.com/AdguardTeam/AdGuardforiOS/issues) and click the _New issue_ button.\n\n\u003e **Note:** for the filter-related issues (missed ads, false positives etc.) use our [reporting tool](https://reports.adguard.com/new_issue.html).\n\n\u003ca id=\"contribution-translating\"\u003e\u003c/a\u003e\n\n### Translating AdGuard\n\nIf you want to help with AdGuard translations, please learn more about translating our products here: https://kb.adguard.com/en/general/adguard-translations\n\n\u003ca id=\"contribution-other\"\u003e\u003c/a\u003e\n\n### Other options\n\nHere is a [dedicated page](https://adguard.com/contribute.html) for those who are willing to contribute.\n\n\u003ca id=\"beta-tester\"\u003e\u003c/a\u003e\n\n### How to become a beta tester?\n\nYou can submit an application to participate in AdGuard for beta-testing program. All necessary information on this topic can be found on the [dedicated page](https://adguard.com/beta.html).\n\n\u003ca id=\"our-plans\"\u003e\u003c/a\u003e\n\n## Our plans\n\nTo see the 'big picture', to watch current progress and to get an idea of approximate dates for upcoming AdGuard for iOS releases, see this page: https://github.com/AdguardTeam/AdguardForIos/milestones\n\n\u003ca id=\"how-to-build\"\u003e\u003c/a\u003e\n\n## How to build\n\n### (optional) Install a newer ruby version:\n\n```\nbrew install ruby\n```\n\nAdd to your `~/.bash_profile`\n\n```\nexport PATH=\"/usr/local/opt/ruby/bin:$PATH\"\nexport PATH=\"/usr/local/lib/ruby/gems/2.7.0/bin:$PATH\"\n```\n\n### Prepare\n\nPrepare and install Ruby bundler:\n\n- `sudo gem install bundler`\n\nConfigure bundler to use local directory for storing dependencies:\n\n- `bundle config set --local path '.bundle/vendor'`\n\nThen run bundle install:\n\n- `bundle install`\n\n**IMPORTANT:** before running Fastlane, you need to place the [App Store Connect API key](https://docs.fastlane.tools/app-store-connect-api/#using-an-app-store-connect-api-key) to `fastlane/AuthKey.p8`.\n\nThen you can run Fastlane using a command like this:\n\n- `bundle exec fastlane [lane]`\n\nRegister your device:\n\n- `bundle exec fastlane run register_device udid:\"UUID\" name:\"Device name\"`\n\n### Codesigning\n\nNote, that by default these commands will only work for AdGuard, not AdGuard Pro.\nFor AdGuard Pro you need to run them with `--env pro`.\n\nRun this command to get proper codesigning certificates:\n\n- `bundle exec fastlane prepare`\n\n### Actions\n\n- `bundle exec fastlane tests` -- run tests\n- `bundle exec fastlane build` -- build version for App Store\n\nActions below are supposed to be used from CI only:\n\n- `bundle exec fastlane adhoc` -- build adhoc version (for inner testing)\n- `bundle exec fastlane increment` -- increments build number, commits it to git\n- `bundle exec fastlane testflight_beta` -- upload previously built version to testflight\n\nIn the case when certificate expires, you may need to nuke the old certs and generate them again:\n\n```\nbundle exec fastlane match nuke development\nbundle exec fastlane match nuke distribution\nbundle exec fastlane generate\n```\n\nIn order for fastlane to work properly in CI environment, we use [spaceauth](https://docs.fastlane.tools/best-practices/continuous-integration/#use-of-application-specific-passwords-and-spaceauth).\n\nRun this command to generate `FASTLANE_SESSION` which you'll then need to use on the CI server:\n\n```\nbundle exec fastlane auth\n```\n\n### Acknowledgments\n\nPlease visit the acknowledgements [page](https://kb.adguard.com/en/miscellaneous/acknowledgments#ios)\n","funding_links":[],"categories":["Swift","Extension"],"sub_categories":["Content Blocking"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAdguardTeam%2FAdguardForiOS","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FAdguardTeam%2FAdguardForiOS","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAdguardTeam%2FAdguardForiOS/lists"}