Skip to content

Commit

Permalink
Update Admonitions
Browse files Browse the repository at this point in the history
  • Loading branch information
Isaaker authored Jul 4, 2024
1 parent d36eb87 commit f02e59d
Show file tree
Hide file tree
Showing 5 changed files with 16 additions and 13 deletions.
9 changes: 6 additions & 3 deletions docs/docs_faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,14 +4,17 @@ Here you can find some frequently asked questions and answers about our blocklis

## Why do black spaces continue to appear where the advertisements were before?

Although our blockoblocklist blocks banner and image ads, Spotify's apps continue to reserve a space to place these ads, and since Spotify can't get those ads and banners, they will continue to appear in black.
!!! question inline end "Answer"
Although our blockoblocklist blocks banner and image ads, Spotify's apps continue to reserve a space to place these ads, and since Spotify can't get those ads and banners, they will continue to appear in black.

![Space Example](./images/ads_space.png)

## Why do I sometimes get a message "This content cannot be played at this time?

When Spotify tries to display an ad, it changes the name of the song to Advertisement, and attempts to load the audio and images from the ad. However, since it is unable to get this content through the blocklist, Spotify will resume playing music as normal.
!!! question inline end "Answer"
When Spotify tries to display an ad, it changes the name of the song to Advertisement, and attempts to load the audio and images from the ad. However, since it is unable to get this content through the blocklist, Spotify will resume playing music as normal.

## Why does Spotify sometimes take longer to load or behave strangely?

Although this list is safe and cannot damage your Spotify or your computer in any way. Sometimes Spotify may take a little bit longer to load or have some weird behavior, because the application is actually trying to continuously contact some ad domains, tracking, which are usually constantly changing to find unblocked domains. And this can sometimes change the behavior of the application a little bit.
!!! question inline end "Answer"
Although this list is safe and cannot damage your Spotify or your computer in any way. Sometimes Spotify may take a little bit longer to load or have some weird behavior, because the application is actually trying to continuously contact some ad domains, tracking, which are usually constantly changing to find unblocked domains. And this can sometimes change the behavior of the application a little bit.
12 changes: 6 additions & 6 deletions docs/docs_installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ The currently supported adblockers are:
- [Adguard](https://adguard.com/es/welcome.html)
- [uBlock Origin](https://ublockorigin.com)

!!! tip:
!!! tip
Being a simple and very backward compatible list, if your adblocker is not included above, you can ask us to include it and if necessary to generate a custom list layout for it.

## 2. Find the right list format
Expand All @@ -34,7 +34,7 @@ Here is a table to find the right format for your adblcoker:
| uBlock Origin | Adguard |
| Standard (with hosts file or adblockers that supports 0.0.0.0 entry) | Standard |

!!! tip:
!!! tip
Being a simple and very backward compatible list, if your adblocker is not included above, you can ask us to include it and if necessary to generate a custom list layout for it.

## 3. (Optional) Setup your adblocker & Spotify
Expand Down Expand Up @@ -73,7 +73,7 @@ To add Spotify Ads List to your adblocker you will need to make use of a raw fil
| Dnsmasq | https://raw.githubusercontent.com/Isaaker/Spotify-AdsList/main/Lists/dnsmasq.txt |
| Adguard | https://raw.githubusercontent.com/Isaaker/Spotify-AdsList/main/Lists/adguard.txt |

!!! question inline end "How can I do this?":
!!! question inline end "How can I do this?"
You can find more help about how to add this on this links:

| Adblocker | Link |
Expand All @@ -92,14 +92,14 @@ To add Spotify Ads List to your adblocker you will need to make use of a raw fil
| Firefox | moz-extension://c396fed9-d8f8-4a6c-95a0-80773fa36d8a/asset-viewer.html?url=https%3A%2F%2Fraw.luolix.top%2Fisaaker%2FSpotify-AdsList%2Fmain%2FLists%2Fadguard.txt&title=Spotify-AdsList&subscribe=1 |
| Chrome / Chromium | chrome-extension://cjpalhdlnbpafiamejdnhcphjbkeiagm/asset-viewer.html?url=https%3A%2F%2Fraw.luolix.top%2Fisaaker%2FSpotify-AdsList%2Fmain%2FLists%2Fadguard.txt&title=Spotify-AdsList&subscribe=1 |

!!! tip:
!!! tip
[You can also make this manually with the adguard raw URL](https://github.com/gorhill/uBlock/wiki/Dashboard:-Filter-lists#3rd-party-filter-lists)

## 5. Add Spotify Ads List whitelist to your adblocker

To add the whitelist to your adblocker, you have to enter the whitelist domains manually in the whitelist area. You can found the whitelist on this [link](./docs_whitelist.md)

!!! question inline end "How can I do this?":
!!! question inline end "How can I do this?"
You can find more help about how to add this on this links:

| Adblocker | Link |
Expand All @@ -110,7 +110,7 @@ To add the whitelist to your adblocker, you have to enter the whitelist domains
| Adguard | [Read this](https://github.com/AdguardTeam/AdGuardHome/discussions/3771) |
| uBlock Origin | [Read this](https://github.com/gorhill/uBlock/wiki/How-to-whitelist-a-web-site/745c6f01e1f88db8184bb27f48bbdd8a21b48a90) |

!!! info:
!!! info
A whitelist is a list that lets your adblocker know which domains should not be blocked. Although usually these domains are not added to the list directly, many times some domains that are on the list (blocked) redirect legitimate requests to these domains (not blocked) via a CNAME and these requests are blocked before being redirected because it is a blocked domain. Therefore, the list will help you to ensure that legitimate requests can continue their course correctly.

## 6. What can I do now?
Expand Down
2 changes: 1 addition & 1 deletion docs/docs_testing.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,5 +15,5 @@ Here you can find all the tests made, their date and more details.
| App | Windows Laptop | Windows 11 (10.0.22631) | - | 26/6/24 | ![Static Badge](https://img.shields.io/badge/Status-ERROR-red?logo=spotify) | pihole | @MW-SAND |
| Web App | Windows Computer | Windows (22H2 19045.4170) | Chrome (126.0.6478.127 (64 bits)) | 29/6/24 | ![Static Badge](https://img.shields.io/badge/Status-ERROR-red?logo=spotify) | ublock origin | @AlkBek |

!!! info:
!!! info
If you have tested the list, please create a issue with type "Testing" to add more tested devices. [Add new tested device](https://github.com/Isaaker/Spotify-AdsList/issues/new?assignees=&labels=Testing&projects=&template=testing.yml&title=New+Testing+Device%3A+%5BDevice+Name%5D+%2F+%5BDevice+OS%26Version%5D)
4 changes: 2 additions & 2 deletions docs/docs_whitelist.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Spotify Ads Whitelist

!!! info:
!!! info
Created by: Isaaker

Revised: 4/7/23
Expand All @@ -10,7 +10,7 @@
Number of domains: 5


!!! warning:
!!! warning
This list is not formatted in any special way and therefore cannot be downloaded and used as an input file, please add the domains manually.

## Detailed list
Expand Down
2 changes: 1 addition & 1 deletion docs/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,5 +2,5 @@

![Spotify Ads List Logo](./images/spotify_ads_list_logo.png)

!!! tip:
!!! tip
🔼 Use the menu at the top to navigate 🔼

0 comments on commit f02e59d

Please sign in to comment.