filter improvements and readme