{"id":21455725,"url":"https://github.com/fastily/simple-commons-uploader","last_synced_at":"2025-07-15T00:30:45.490Z","repository":{"id":35089146,"uuid":"135213080","full_name":"fastily/simple-commons-uploader","owner":"fastily","description":"🚀 Batch uploading to the Wikimedia Commons has never been so easy","archived":false,"fork":false,"pushed_at":"2024-04-22T07:06:34.000Z","size":58,"stargazers_count":3,"open_issues_count":3,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-11-16T08:17:02.823Z","etag":null,"topics":["batch-upload","python","wikimedia-commons"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fastily.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2018-05-28T22:01:08.000Z","updated_at":"2024-04-22T07:05:43.000Z","dependencies_parsed_at":"2024-04-22T08:26:33.842Z","dependency_job_id":"18b694ed-c6d2-4e59-b0df-418410a535b9","html_url":"https://github.com/fastily/simple-commons-uploader","commit_stats":{"total_commits":56,"total_committers":1,"mean_commits":56.0,"dds":0.0,"last_synced_commit":"ef294195f50e7dc4205bc689595ea46a3a8018af"},"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fastily%2Fsimple-commons-uploader","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fastily%2Fsimple-commons-uploader/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fastily%2Fsimple-commons-uploader/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fastily%2Fsimple-commons-uploader/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fastily","download_url":"https://codeload.github.com/fastily/simple-commons-uploader/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":226002995,"owners_count":17558157,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["batch-upload","python","wikimedia-commons"],"created_at":"2024-11-23T05:13:13.575Z","updated_at":"2024-11-23T05:13:14.096Z","avatar_url":"https://github.com/fastily.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Simple Commons Uploader\n[![Python 3.9+](https://upload.wikimedia.org/wikipedia/commons/4/4f/Blue_Python_3.9%2B_Shield_Badge.svg)](https://www.python.org)\n[![MediaWiki 1.35+](https://upload.wikimedia.org/wikipedia/commons/b/b3/Blue_MediaWiki_1.35%2B_Shield_Badge.svg)](https://www.mediawiki.org/wiki/MediaWiki)\n[![License: GPL v3](https://upload.wikimedia.org/wikipedia/commons/8/86/GPL_v3_Blue_Badge.svg)](https://www.gnu.org/licenses/gpl-3.0.en.html)\n\nThe Simple Commons Uploader makes it easy to batch upload your self-made photos and videos to the [Wikimedia Commons](https://commons.wikimedia.org/wiki/Main_Page).\n\n⚠️ You must have an account on Wikimedia Commons to use this program.  Create an account by [going here](https://commons.wikimedia.org/wiki/Special:CreateAccount).\n\n## Download\n```bash\npip install simple-commons-uploader\n```\n\n## Usage\n```\nusage: __main__.py [-h] [-u username] [folders ...]\n\nSimple Commons Uploader\n\npositional arguments:\n  folders      folders with files to upload\n\noptions:\n  -h, --help   show this help message and exit\n  -u username  username to use\n```\n\n## Authentication/Login\nThe Simple Commons Uploader works with your normal password and [BotPasswords](https://commons.wikimedia.org/wiki/Special:BotPasswords).  \n\n👉 Password is set via env variable `\u003cUSERNAME\u003e_PW`, such that `\u003cUSERNAME\u003e` is the username of the bot in all caps.\n\n## Behavior Details\nThe Simple Commons Uploader only uploads files in [these file formats](https://commons.wikimedia.org/wiki/Commons:File_types).  Any other file types will be skippied.\n\nUploaded 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.\n\nUploaded 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`.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffastily%2Fsimple-commons-uploader","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffastily%2Fsimple-commons-uploader","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffastily%2Fsimple-commons-uploader/lists"}