limber0117 / az

Downloads apks from androzoo repository https://androzoo.uni.lu/

Downloads specified number of randomly chosen apks satisfying specified criteria from androzoo repository.
Saves specified metadata to metadata.csv. dexdate, apksize and vtdetection require specifying lower and upper bounds in format lower:upper, both inclusive.
One of the bounds can be omitted (i.e. you can write :upper or lower:)
pkgname, markets, metadata, sha256, sha1, md5 can be either single values or comma separated lists.

PREREQUISITES

Python 3.6

INSTALLATION

1. pip install -e git+https://github.com/ArtemKushnerov/[email protected]#egg=az

2. create .az file in your home directory with the following contents:

key=%API_KEY%  
input_file=%PATH_TO_INPUT_FILE%

Request the api key from androzoo, download and uncompress the input file from here https://androzoo.uni.lu/lists

SAMPLE USAGE

az -n 10 -d 2015-12-11: -s :3000000 -m play.google.com,appchina

This means: download 10 apks with the dexdate starting from the 2015-12-11 (inclusive), size up to 3000000 bytes (inclusive) and present on either play.google.com or appchina

Options:

  -n, --number INTEGER     Number of apks to download.  
  -d, --dexdate TEXT       The date on a dex file, format %Y-%m-%d, e.g.  2015-10-03
  -s, --apksize TEXT       Apk size, in bytes  
  -vt, --vtdetection TEXT  Virus total rating, integer  
  -pn, --pkgname TEXT      Package names  
  -m, --markets TEXT       Markets, e.g. play.google.com. Possible values (can differ, since repository is updating): 1mobile,angeeks,anzhi,apk_bang,appchina,fdroid,freewarelovers,genome,hiapk,markets,mi.com,play.google.com,proandroid,slideme,torrents'
  --sha256 TEXT            SHA256 hashes
  --sha1 TEXT              SHA1 hashes of apks to download
  --md5 TEXT               MD5 hashes of apks to download
  -md, --metadata TEXT     Metadata. This is a subset of latest.csv column names to keep in metadata.csv. By default sha256,pkg_name,apk_size,dex_date,markets  
  -o, --out TEXT           Output folder name. By default current directory  
  -sd, --seed INTEGER      Seed for a random algorithm  
  --help                   Show this message and exit.