1.0.2 Support modern wget2

Installation instructions

README.md - Installation

Quickstart

• Download (either .zip or tar.gz)
• extract the archive
• run the file ./install.sh as root to install Adsorber
• run adsorber enable

Note for updaters from v1.0.1:

No configuration changes have been made, existing configs are still valid.
Installing via ./install.sh will not overwrite existing config files.

Changes

• Support wget2 (required for Fedora 40+)
• Install and remove scripts renamed to install.sh and remove.sh
• Install script install.sh will not replace existing config files
• Added ADSORBER_DEBUG environmental variable (if set, enables debug mode)

1.0.1 Commands aligned to Systemd service usage

Installation instructions

README.md - Installation

Quickstart

• Download (either .zip or tar.gz)
• extract the archive
• run the file ./place_files_onto_system.sh as root to install Adsorber
• run adsorber enable

Note for updaters from v1.0.0:

All your Adsorber config files will be overwritten by place_files_onto_system.sh.
If you want to keep them, take a copy and restore them afterwards.

Changes

• New aliases for operations, similar to Systemd's service usage.
  Makes the commands hopefully less confusing. Old operations will continue to work.

  • setup = enable
  • update = start
  • restore = stop

  Thanks to @eksperimental for #22

• Update Systemd unit file to not use obsolete logging target
  Thanks to @tongtanhieu for #21

• Fix Systemd Service Log not displaying run date correctly

• Some other minor improvements

1.0.0 Improved compatibility

Installation instructions

README.md - Installation

Quickstart

• Download (either .zip or tar.gz)
• extract the archive
• run the file ./place_files_onto_system.sh as root to install Adsorber
• run adsorber setup

Note for updaters:

• Due to changes how we handle the hosts file you'll need to remove/disable Adsorber prior upgrading to this version.
  This can be done with either running adsorber disable or ./remove_files_from_system.sh
• All your config files will be overwritten by ./place_files_onto_system.sh.
  If you want to keep them, take a copy and restore them afterwards.
  In most cases the config can be found at /usr/local/etc/adsorber/

Changes

• Adsorber will now manipulate the hosts file inline for increased compatibility, instead of completely overwriting it (see #14 for the discussion). Thanks to @eksperimental
  Therefore you can now directly edit your /etc/hosts without the need to worry that they will be wiped when Adsorber runs.
• /etc/hosts.original will not be read by Adsorber anymore, write your changes directly to the /etc/hosts
• Some minor internal improvements (e.g syntax, etc)

0.5.1 Adsorber.log

Quickstart

• Download (either .zip or .tar.gz)
• extract the archive
• run the file place_files_onto_system.sh as root to install Adsorber
• run adsorber setup

Note for updaters:

All your config files will be overwritten by place_files_onto_system.sh.
If you want to keep them, take a copy and restore them afterwards.

Changes

• Schedulers now write their output to /var/log/adsorber.log and to syslog
• Fixed ignore_download_error option broken when blacklist was set (see #11). Thanks to @rhtenhove

0.5.0 Scheduler frequency

Quickstart

Download (either .zip or .tar.gz), extract and run place_files_onto_system.sh as root user to install Adsorber to the system or run portable_adsorber.sh to keep it 'portable'.

After installing Adsorber to the system you may want to run adsorber setup to finish the setup, e.g. backing the original hosts file up, fetching ad-domains etc.

Changes

• Added interactive selection of frequency to use with a scheduler
• Added scheduler functionality that writes to syslog,
  you can examine it with grep Adsorber /var/log/syslog
• Many bug fixes and more improvments

0.4.0 Install to system

Quickstart

Download (either .zip or .tar.gz), extract and run install_to_system.sh as root user to install Adsorber to the system or run portable_adsorber.sh to keep it 'portable'.

Note: After installing Adsorber to the system you may want to run adsorber install to finish the setup, e.g. backing the original hosts file up, fetching ad-domains etc.

Changes

• Installation to system
• Improved error handling
• Improved clean up after specific operation
• Many bug fixes and more improvments

0.3.0 Finally POSIX Compliant!

Quickstart

To update run git pull (only if repository was cloned).
Or download (either .zip or .tar.gz), extract and run adsorber.sh as root user:
sudo ./adsorber.sh

Changes

• POSIX compliant - Adsorber can now run on most shells! (bash, sh, ksh, fish ...)
• Revert to the last applied hosts file with adsorber.sh revert
• and many more improvements

0.2.3 Proxy ability

Quickstart

To update run git pull.
Download (either .zip or .tar.gz), extract and run adsorber.sh as root user:
sudo ./adsorber.sh

Changes

• Added proxy setting ( in adsorber.conf)
• Fixed IGNORE_DOWNLOAD_ERROR was opposite to the defined setting
• Some other minor improvements

0.2.2 Colourful update

Quickstart

To update run git pull.

Download (either .zip or .tar.gz), extract and run adsorber.sh as root user.

Changes:

• Added colourful output to the terminal 🎨
• Added option to exit if at-least one hosts source couldn't be reached
• Added warning for duplicate option
• Improved error messages
• Improved speed of script by removing unnecessary actions
• Fixed a few issues

Second update, more is planned and more will come.

0.2.1 Initial Release

Quickstart

Download (either .zip or .tar.gz), extract and run adsorber.sh as root user.

Changes:

• Added whitelist functionality
• Added blacklist functionality
• Added install/remove functionality
• Added cronjob support for automatic update
• Added systemd support for automatic update
• Added configuration file (adsorber.conf)

This is the first release, more to come.