User Manual

CSV import

Starting from version 1.4.0, the filter rules can be restored from a CSV file.

Android 11 scoped storage

Starting from Android 11, the scoped storage limits the app to read file from app-specific directory. The user can find out the directory in the file selector dialog.

Uninstalling the app will get the app-specific directory removed. The CSV files will also be removed with the directory! Make a backup by USB!

How to import CSV?

Click on the 'Import CSV' item in Operation menu.
Please grant the file access runtime permission in Marshmallow and newer.
A file selector dialog will pop up.
Select the file path to read the CSV file.
Select the CSV file to import.
Click OK to start CSV import.

The app determines the number of filter rules changed by the CSV import.

A dialog box is shown to confirm the import.

Click OK to confirm CSV import.

Wait for the app to update the filter rules.

After CSV is imported, the app shows a result dialog box.

Known issues

When the app imports CSV file, it may lock the screen orientation.

The app does not follow the latest Android API to handle screen rotation. The portrait and landscape orientations work well. Nevertheless, the 'reverse' landscape is shown upside down.

In version 1.7.0, the screen orientation is not locked by default. Screen rotation cancels the CSV import.

When importing CSV, it is advised to keep the screen in portrait orientation.

When importing CSV, exiting the app will cause a crash. This issue is solved in version 1.6.0.

Some words on file size

It is advised not to import a big CSV file. When a fairly fast phone carries 50,000 filter rules, it can take several seconds to start this app.

The app UI parts should comfortably process 1,000 rules or less.

CSV file format

The CSV format is documented in this page.

Google Sites

Report abuse