Skip to main content

copy translations between booru-style imageboards

Project description


Copy translation notes between booru-style imageboards

Build Status Codecov


note_copy is a program that copies translation notes from one booru post to another, either on the same site or across sites.


The recommended way to install the booru-note-copy module is to simply use pipenv:

$ pipenv install booru-note-copy

Or, if you prefer plain, old pip:

$ pip install --user booru-note-copy

Once installed, the program is accessible as note_copy.


To copy notes between posts, simply supply two post IDs:

$ note_copy --source d1671559 --destination g2244172

This will copy the notes from the source and change the tags on the destination post as necessary. On first usage, you will be prompted for your login information for each site used so that the notes can be created with your account. If you choose to store this data, the files are created in the .note_copy directory inside your home directory. For sites that require passwords, only the hash of the password is stored.

The script can also read from a file to copy notes between multiple pairs at once. The file should have a pair of post IDs per line, with the IDs separated by whitespace.

$ cat ids
d1671559 g2244172
d1701853 g2283415
$ note_copy --file ids

The lower-case prefixes are called short codes and can be used to identify the site on which the post is located. Alternatively, the full domain of the site can be used instead of the short code, e.g. gelbooru.com2244172.

note_copy is also able to be run as a module:

$ python -m note_copy -s d1102540 -d g1433185


  • Python 3.5+


usage: note_copy [-h] [-s SOURCE] [-d DESTINATION] [-f FILE]

optional arguments:
  -h, --help            show this help message and exit
  -s SOURCE, --source SOURCE
                        The post from which notes will be copied
                        The post to which notes will be copied
  -f FILE, --file FILE  File containing post pairs, separated by whitespace,
                        one per line

You need to provide either a source/destination combo or a file; you cannot use both sets of arguments simultaneously.

Supported sites

Site Name Short Code Domain Login Information
Danbooru d Username, API key
Gelbooru g Username, password, API key

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

booru-note-copy-1.1.0.tar.gz (8.4 kB view hashes)

Uploaded source

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