AdBlock Locus

K-Meleon is a privacy-focused web browser that comes with a built-in adblocker. However, it does not come with a graphical interface for that adblocker. AdBlock Locus provides a graphical interface to toggle the adblocker, create custom rules, manage subscriptions, and create exceptions.

Installation

To install AdBlock Locus:

1. Download the AdBlock Locus K-Meleon macro module (.kmm) above.
2. Move Adblockplugin.kmm to your K-Meleon/macros folder or your /profiles/your.profile/macros/ folder. The entire extension is stored in this single macro file.
3. Restart K-Meleon.

Links

• K-Meleon forum thread on AdBlock Locus. Go here for questions, support, and updates.
• GitHub page for the AdBlock Locus extension and subscriptions.
• K-Meleon forum thread discussing the built-in adblocker.
• View the source code in your browser..
• Download icon packs to use icons from previous versions.

FAQ

Q: How do I allow sites with AdBlock Locus?
A: You can allow all sites, by temporarily toggling the adblocker off. You can allow ads on the current site by right-clicking the AdBlock Locus icon and choosing "Allow Domain" in the menu. This will create a custom exception rule in adblock_user.txt in your profile. You will then need to Refresh Rules to load your custom rules. The adblock plugin may have issues with these exception rules on some setups. Any exceptions you create will take effect the next time you start K-Meleon.

Q: Will AdBlock Locus add support for features like element hiding?
A: AdBlock Locus only operates the built-in adblocker. If the BAB doesn't support a feature like element hiding or the $document exception, the feature will not be available.

Q: Can I use K-Meleon's built-in ad blocker without an extension?
A: Yes. If you set up the BAB with AdBlock Locus and then uninstall the extension, you will still have the built-in blocking abilities. You can manually toggle the adblocker from the "Kplugins" preferences panel. You will still have the AdBlock Locus subscriptions set up and can manually refresh them by deleting "adblock.txt" in your profile and restarting K-Meleon.

Q:Can I just use K-Meleon's Privacy Bar to toggle ad-blocking?
A:Yes, after you install AdBlock Locus. If you're using K-Meleon's Default theme or another new-style theme:

1. Select "Edit - Configuration - Toolbars" in the menu to open your configuration file. Save an exact copy of this file to your profile folder or your skin's folder. Don't save modification's here.
2. Press Ctrl+F in the text editor that pops up and type Privacy Bar to scroll down.
3. Copy and paste the code below, save toolbars.cfg, and restart K-Meleon:

	!Ads{
	macros(_Adblockplugin_toggle)|&Privacy
	Block ads with K-Meleon's built-in ad blocker.
	check.png[0,32,32]
	}
	

Q: How do I uninstall the extension?
A: You can completely uninstall AdBlock Locus by deleting the Adblockplugin.kmm file. You can disable it (or any other macro module) by in the browser by going to Edit - Configuration (F2) -- K-Meleon Plugins - Macro Extension and clicking the checkbox beside AdBlock Locus. You can disable AdBlock Locus (or any other macro module) from file manager by renaming the file to Adblockplugin.txt.