Commons:Tools/Commonist - Wikimedia Commons

Commons:Tools/Commonist

From Wikimedia Commons, the free media repository

Jump to: navigation, search
Commonist program icon showing Hammer and sickle

Commonist is a free Java program for easy uploads of large numbers of images to Wikimedia Commons and other Mediawiki installations.

Contents

[edit] Installation

In order to install Commonist you need Sun-Java 1.5.0 or newer:

  • Go to Sun-Java download page and download the version for your operating system in case you haven't installed Java.
  • Follow the steps of the Java installer.

After you have installed Java:

  • You can start Commonist directly.
  • Download Commonist from http://djini.de/software/commonist/ and unpack it in C:\ . It will create a new folder commonist-x.x.x (x replaced by version number).
  • On Unix/Linux/Mac-OSX start commonist with bin/commonist
  • On Windows start commonist with bin\commonist.bat, typing this in at Start >> Run


If you would like a desktop icon for Commonist on your desktop, you should follow your system's recommendation for adding an icon. In the field defining the executable file enter the full path to the right executable of the two given choices above.

[edit] Usage

Main screen of Commonist with filled in forms and images ready for upload

After you have installed and started the program a small splash screen with a hammer and sickle icon will pop up first. On Windows you will additionally see a terminal window which you can't close while the program is running. The second shortcoming on Windows only is a requester popping up. Click it away with "continue". Shortly after that the interface of Commonist will appear.

In the lower left you will see a tree view of your file system. Choose the folder which contains the images you want to upload. After you have selected this folder you will notice a small status message at bottom that Commonist is reading the content of the folder and will display on the right side a preview of each file.

  1. REDIRECT [[#REDIRECT Insert text#REDIRECT [[Media:Insert text[[Category:]]]]]]=== General upload settings ===

In the upper left you see several fields of a mask below the label "general upload settings", on top of which you will find the fields necessary for the account you want to use for upload:

user
In the "user" field type in your user name of wiki where you want to upload your images. Note that you enter it without the User: prefix.
password
Type in your password for this account there. It will be made invisible to the reader with asterisks (but will be transferred unencrypted over the wire as always when you login to a Wikimedia wiki).
wiki
At the "wiki" drop down menu you can select the wiki where you want to upload the file. In case of Wikimedia Commons choose "commons". Note that within that wiki you need to own the very account you specified above.

Further down you can enter general information that will be embedded in the image descriptions of all images you upload. Template:Information is being used for the structured image description (See Commons:First steps for details about the template; in other wikis beside Commons a free form description without the use of a template is being used by Commonist).

description
There you can enter the global description in normal wiki syntax which will be displayed at all image pages of images you upload within that session.
source
Use a statement such as “Own work.” or similar, if you created that file yourself. Otherwise please supply a
  • Link to a website
  • Name of an institution
  • Book source
  • etc.
Note that you can only enter one source for all images you upload at once.
date
Date of creation of the images you want to upload (or date of release if not available), preferably in ISO 8601 format, such as “taken on 2006-01-08” for an image taken on 8 January 2006.
author
Author(s) of the files. If you don’t know any individual, use the name of the institution(s) which released it. In case of self-made work, put your real name and your linked user name in parentheses, such as “Gabor Eszes ([[User:UED77|UED77]])”. This will read as “Gabor Eszes (UED77)”. You might as well directly link your real name to the user name such as “[[User:UED77|Gabor Eszes]]”.
categories
Enter one specific category there that fits to all of your images you want to upload without the namespace prefix or leave it blank in case you want to add the images afterwards to a gallery page. Several categories get separated by a vertical bar: “|”. That way you can enter categories containing commas. Be as specific as possible. Don’t add an image to an overcrowded root category like "Astronomy". In order to find a right category for your images the category tree will help you a lot.
license
In Wikimedia Commons it is essential that every file is correctly licensed. So choose out of the "license" the license you want to use for your images. For correct licensing please see Commons:Licensing. In case you did not find the right license leave it blank and have a look at Commons:Copyright tags but don't forget to add the correct license tag afterwards, otherwise your files will be deleted without further notice.

[edit] Image forms

Image viewer of Commonist above the main screen

On the top right you see two buttons labeled "deselect all" and "select all". Click these buttons to check/uncheck the upload status of all images in the current collection. The upload status is shown in the upload check box, next to each file thumbnail. You can manually check/uncheck single files, by clicking on the individual check boxes.

Click (single click) on the image thumbnail and the full size image will appear in a separate window. (See the screenshot.)

Next to each thumbnail, you will also find the following form fields:

name
In the "name" field, you type the 'destination file name' of the image. On starting, the local file name will automatically be displayed here and this will be used by default. You are strongly advised to change the local file name into something meaningful. This edit is non destructive. The file name will not be changed on your hard disk, just the destination file name.
Take special note of this, you cannot rename your file once it has been uploaded.
Non-descriptive file names - e. g. names like “DSC123456.jpg”, render them a lot harder to find and use. Also it is very likely that another user will try to upload a file with the very same name but with different content, and that file will be suggested for deletion.
description
In the "description" field, you enter the description of that file. Use normal wiki syntax. This will be displayed on the image page; it will be appended to the general description. Please give a good description of the content of each file. What do you see, hear, or otherwise perceive? If it's an item of artwork, please provide a brief historical background. In case of scientific data, a brief scientific abstract of the file. Descriptions can be in any language, but it is always a good idea to include an English description as well. If you speak multiple languages, consider adding the description in each of them. (Please use the language templates as described on Commons:Multilinguality, like in this code example for English: "{{en|Example description}}").
categories
In the "categories" field, you specify additional categories (without the category namespace prefix) separated by a vertical bar. Please also try to be as specific as possible. Try to avoid using more than two topic categories per image, they can be added later.

[edit] Proxy

If you are behind a proxy, then either edit etc/startup.bsh and uncomment the proxy settings, or make a new startup.bsh in the etc folder and insert the following code, replacing "proxy.test.de" with the host name of your proxy.

mw.configureProxy(
	"proxy.test.de",		// host
	8080,					// port
	null,					// proxy user (string)
	null,					// proxy password (string)
	"localhost|127.0.0.1"	// bypass proxy for some hosts. * wildcard and | for alternatives
);

[edit] Upload

After you have finished your preparations for the upload click on the "upload" button in the lower right corner of the main window. Now you will see a status bar at the bottom line explaining what Commonist doing. You can cancel the upload at any time by clicking on "abort" next to the "upload" button. If everything works well, it will display first the login procedure and then the upload status of the single files there. If something went wrong please check if you typed in the correct user name, password and wiki.

Every uploaded file will be added automatically to your watchlist, so that you can always track the changes by others to your files. Every uploaded file also will be added to a personal user gallery located at User:YOUR_USERNAME/gallery, grouped by upload jobs and upload date, with the image description as description of the thumbnail, so that you will automatically have a pleasant overview of all of your uploads.

[edit] Bugs and feedback

  • On Windows there is a terminal window which may not be closed without closing the Commonist program as well.
  • On Windows a requester pops up at startup.

For feedback to the program author please stop by at http://djini.de/software/commonist/ or email the dot gray at gmx dot net (in english or german).

[edit] Commonist on Other Wikis

See Commons:Tools/Commonist/Other Wikis for instructions on using Commonist on other wikis.

[edit] Commonist and Geocoding

There is a trend to Geocode images; which adds significantly to the effort of uploading. An elegant way to save time is adding a special bookmark to the browser, and locating the point of camera on a maps.google.com map. When the special bookmark is used, the browser generates geocode tag.

  • Firstly, as a one off task, create a bookmark (on Firefox: Bookmarks>Organise Bookmarks>New Bookmark) with the location as:
    • javascript:void(prompt('',"{{location dec|" + gApplication.getMap().getCenter().lat().toFixed(4) + "|" + gApplication.getMap().getCenter().lng().toFixed(4) + "}}"));

For each image:

  • Open Commonist, and select the target image.
  • Load http://maps.google.com/ in the browser.
  • Search for the correct location.
  • Click on "Satellite" if it helps to find the location more easily, and zoom in.
  • Double Click on the exact location the media was recorded to zoom and center the map.
  • Click on your bookmark and you'll get a prompt with the geocode tag to add to the image.
  • Click Ctrl-C to copy this tag.
  • Switch to Commonist, click on the description field of the target image, click Ctrl-V to paste the tag.

[edit] Downloading current and older versions

[edit] License

Commonist is licensed under the GNU General Public License (Wikipedia article)

[edit] See also