Skip to main content

Keep downloaded booru searches up-to-date, similar to Danbooru subscriptions.

Project description


PyPI downloads PyPI version PyPI pyversions

Use lunafind to download and keep in sync tag searches from Danbooru-based sites, similar to Danbooru tag subscriptions/saved searches.

Searches are listed in a simple commented CSV file (see --print-config-path).
Can be easily used with cron for automatic scheduling.


  • Full and incremental syncs; incremental stops downloading after reaching the last post that was downloaded in a previous run
  • Fast multithreaded downloads with lunafind; 8 downloads in parallel by default
  • Can sync all or only searches with a specific labels
  • Return the total number of downloaded posts

Command line usage

After adding some searches to the config file, simply doing lunasync will synchronize all searches in the current directory.
A full sync will be taken for a search if this is the first time, else incremental will be used. See lunasync --help for all options.

Python usage

    import lunasync

See help(lunasync.sync) for parameters.


Requires Python 3.6+ and pip (for automatic easy install).
Tested on GNU/Linux and Windows 7, probably works on OSX and other POSIX systems.
As root:

    pip3 install -U lunasync

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

lunasync-0.1.4.tar.gz (5.6 kB view hashes)

Uploaded source

Built Distribution

lunasync-0.1.4-py3-none-any.whl (8.2 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page