https://github.com/abertschi/ad-free

A modularized audio ad blocker for Android
https://github.com/abertschi/ad-free

android kotlin

Last synced: 23 days ago
JSON representation

A modularized audio ad blocker for Android

• Host: GitHub
• URL: https://github.com/abertschi/ad-free
• Owner: abertschi
• License: apache-2.0
• Created: 2017-04-15T15:44:19.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2023-12-08T21:55:02.000Z (about 1 year ago)
• Last Synced: 2024-11-05T03:37:07.176Z (about 2 months ago)
• Topics: android, kotlin
• Language: Kotlin
• Homepage: https://abertschi.ch/blog/2022/building-adfree/
• Size: 10.4 MB
• Stars: 275
• Watchers: 11
• Forks: 19
• Open Issues: 30
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE
  • Authors: AUTHORS

Awesome Lists containing this project

README

        
# ad-free 

[![CI](https://github.com/abertschi/ad-free/actions/workflows/build.yml/badge.svg?branch=develop)](https://github.com/abertschi/ad-free/actions/workflows/build.yml)

[![Kotlin App](https://img.shields.io/badge/Android-Kotlin-green.svg?style=flat)]()

[![codebeat badge](https://codebeat.co/badges/1fc357d9-4c2e-46f6-b847-d295e4de78eb)](https://codebeat.co/projects/github-com-abertschi-ad-free-master)

ad-free is a research project attempting to show flaws in the way how audio

 advertisement is shown on Android. It is a proof-of-concept of a modularized

 audio ad blocker written in Kotlin with a modern and simplistic user interface.

Landing Page: https://adfree.abertschi.ch  

Blog Post: https://abertschi.ch/blog/2022/building-adfree/ 



## Features

- Lower phone volume when advertisement is playing

- Play other audio when advertisement is playing

- Support for Spotify, Spotify Lite, Soundcloud, Deezer, Accuradio

- Mute Google Chromecast (experimental)

- Plugin based design

- No root required

## Download

[Download the latest release](https://f-droid.org/packages/ch.abertschi.adfree/) from the F-Droid store.  



## Troubleshooting

See [Troubleshooting](./troubleshooting/readme.org) section for help to get

ad-free up and running.

## Changelog

See [Changelog](./CHANGELOG.md) for a list of implemented features

in new releases.

  

## Credits

- Many thanks to Janis Bitta design(at)jbitta.de for creating the logo

- The bird and website icons used in this app are made by Freepik from www.flaticon.com and are

  licensed by CC 3.0 BY.

## Legality

This app is free and open-source and does not seek a commercial interest. It

does not collect user data. It is a proof-of-concept for research purposes to show flaws in the way

how audio advertisement is often implemented on Android. It does not alter or

"hack" protection measures of music players, and only gathers context

information provided by the Android runtime. It simply turns down phone volume when it detects advertisements. Nonetheless, ad-free may be against

terms of services of music players. Muting commercials may not be supported and

may result in a temporary ban. Use at your own risk.

## Licence

This project is lisenced by the Apache Lisence 2.0

THIS 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. IT IS A PROOF OF CONCEPT AND INTENDED TO BE A RESEARCH PROJECT. IN

NO EVENT SHALL THE COPYRIGHT OWNER 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.