fastily / simple-commons-uploader

🚀 Batch uploading to the Wikimedia Commons has never been so easy

Simple Commons Uploader

The Simple Commons Uploader makes it easy to batch upload your self-made photos and videos to the Wikimedia Commons.

⚠️ You must have an account on Wikimedia Commons to use this program. Create an account by going here.

Download

pip install simple-commons-uploader

Usage

usage: __main__.py [-h] [-u username] [folders ...]

Simple Commons Uploader

positional arguments:
  folders      folders with files to upload

options:
  -h, --help   show this help message and exit
  -u username  username to use

Authentication/Login

The Simple Commons Uploader works with your normal password and BotPasswords.

👉 Password is set via env variable <USERNAME>_PW, such that <USERNAME> is the username of the bot in all caps.

Behavior Details

The Simple Commons Uploader only uploads files in these file formats. Any other file types will be skippied.

Uploaded files will be named based on local folder name. For example, if your folder is called Fancy pigeons, contains jpgs of fancy pigeons, and today's date is 2018-01-01, then the resulting files will be named File:Fancy pigeons 1 2018-01-01.jpg, File:Fancy pigeons 2 2018-01-01.jpg, File:Fancy pigeons 3 2018-01-01.jpg, etc.

Uploaded files will be categorized using the same name as the containing folder on your computer. To use a different category, add an _ character to the end of the folder name, followed by the category (without the Category prefix) you would like to add. For example, a folder with name Fancy pigeons _ Gray birds will cause scu to upload the files with a base name of Fancy pigeons and categorize them in Category:Gray birds.