From 1d5cbfdefc6348fc5b3dad6e3cb3ff54bd3544ca Mon Sep 17 00:00:00 2001 From: Eric Zhang Date: Wed, 25 Jul 2018 23:41:41 -0700 Subject: [PATCH] Readme formatting --- README.md | 13 +++++++------ 1 file changed, 7 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index ca78beb0..695c2e70 100644 --- a/README.md +++ b/README.md @@ -3,22 +3,22 @@ EZBlocker ========= -EZBlocker is a Spotify Ad Blocker written in C# for Windows 7/8/10. The goal for EZBlocker is to be the most reliable and stable ad blocker for Spotify. +EZBlocker is a Spotify Ad Blocker written in C# for Windows 7/8/10. The goal for EZBlocker is to be the most reliable ad blocker for Spotify. -When an advertisement is playing, EZBlocker will mute Spotify and automatically resume playing regular music when the ad is over. +When an advertisement is playing, EZBlocker will mute Spotify until it's over. -To download a pre-compiled binary of the latest version, click [here][1]. - -For more info, visit the [EZBlocker project page][2]. +To download a pre-compiled binary of the latest version, click [here][1]. For more info, visit the [EZBlocker project page][2]. ## Technical overview The current version of EZBlocker hooks Spotify in three ways: window titles, audio sessions, and a reverse listener. **Window title** + The window title is used to grab the name of the currently playing song/artist/advertisement. EZBlocker also uses the window title to grab the Spotify process handle. **Audio session** + Using lower level COM interfaces, EZBlocker is able to both find and extract information from Spotify's audio session. Firstly, if the Spotify window is hidden (in the tray), its window title cannot be used locate the correct Spotify process handle. In this case, EZBlocker falls back to searching through the audio sessions to find the correct process. @@ -26,6 +26,7 @@ Firstly, if the Spotify window is hidden (in the tray), its window title cannot Secondly, the audio session is a somewhat reliable way to detect whether or not a song/advertisement is playing regardless of whether or not the Spotify window is hidden. It can be inaccurate at times, eg. when a song has a 3 second gap of no sound, but can automatically recover. **Reverse Listener** + I've historically tried to avoid modifying the Spotify application, but since the shutdown of its unofficial local API (in mid July 2018), there was no reliable way to detect if an advertisement was playing. Spotify is built with the Chromium Embedded Framework, which means many of its components are written in HTML/JS. EZBlocker patches one of them to attach a web worker that sends a signal to a local listener when an advertisement is playing. @@ -33,7 +34,7 @@ Spotify is built with the Chromium Embedded Framework, which means many of its c More data could probably be extracted through the web worker, but I haven't had time to explore. -# Changelog (Major releases only): +## Changelog (Major releases only): - V 1.7 (July 22, 2018): - Almost a complete re-write of the application (lighter, more performant, cleaner code)