VicuñaUploader is a free, open-source desktop application written in Java designed to batch-upload media files to Wikimedia Commons and other Wikimedia projects. It serves as a more powerful alternative to default browser tools by allowing users to prepare, edit, and organize file metadata completely offline before publishing. Core Features
Offline Metadata Preparation: Saves your progress locally in a session.xml file, letting you edit descriptions, tags, and titles without an active internet connection.
Conflict Pre-checking: Automatically checks for filename conflicts on Wikimedia Commons before starting the transfer to prevent failed uploads.
Integrated Geotagging: Features an interactive map window that allows you to embed geographic coordinates into your files with a single click.
Advanced Category Support: Mimics the official Wikimedia Commons Upload Wizard but optimizes the workflow by letting you separate multiple categories with semicolons.
Chunked Uploads: Breaks large files down into pieces to ensure stable, corruption-free uploads over unstable network connections. Initial Setup & Installation 1. System Requirements
Because the application is platform-independent, it runs on Windows, macOS, and Linux. However, you must have a Java Runtime Environment (JRE) installed on your machine. 2. Downloading the Tool
You can grab the compiled app files from the official VicuñaUploader Page on Wikimedia Commons or build it directly from the source repository hosted on GitHub. There is no formal installation process; you simply extract the ZIP folder and run the executable binary. 3. Securing a Bot Password
For security reasons, Wikimedia requires you to use a dedicated bot password rather than your main account credentials: Log into your account on the Wikimedia Commons Website. Navigate to the special page Special:BotPasswords.
Click Create, name the bot (e.g., “Vicuna”), and check the following permission blocks: Edit existing pages Create, edit, and move pages Upload new files Upload, replace, and move files
Click Create again to generate a long, automated string. Use your username formatted as Username@Vicuna along with this unique string to log into the software. Step-by-Step Upload Guide Step 1: Import Your Media
Launch the program and drag your images or videos into the main workspace window. Step 2: Set Bulk Descriptions (Optional)
If you are uploading a uniform batch of files that share the exact same background context, you can apply a single description file to all items simultaneously:
Create a basic .txt file on your computer containing your desired template summary.
In the top menu, go to Tools > Settings > Program > Advanced.
Select your text file to instantly copy its text structure into every file currently in your queue. Step 3: Populate Individual Metadata
Select files individually or in groups to fine-tune their titles, source details, and author information. Use the built-in map UI to click on a location and generate automated coordinate templates. Step 4: Validate and Upload
Click the upload button. The application will cross-reference your queue against the live server database to flag duplicate names, safely chunk the data, and publish your items directly to your target category. Alternative Batch Tools
If VicuñaUploader does not perfectly fit your workflow, the Wikimedia community frequently uses these alternative programs: Commons:VicuñaUploader
Contents. 1 VicuñaUploader (latest version: 1.3.3a) 2 Information. 3 Quick links. 4 Contribute. VicuñaUploader (latest version: 1. commons.wikimedia.org
Leave a Reply