Exposed replacement to command line and added 'random' option

Also updated read me.