Commons:ComeOn!

ComeOn! is a free tool for importing jpeg-pictures or sound clips to Wikimedia Commons. It is able to extract pieces of metadata from picture files to insert them into the file description in Commons. It is also able to fetch metadata from an external file.

You may use ComeOn! when :

• You have a lot of pictures to upload and you don’t want to lose time on the Upload Wizard.
• You want to add rich descriptions and categories to your files without editing them one by one in Commons.
• You already described your pictures in your editing software (Lightroom, etc.)
• You want to fetch information about your files from an external catalog, like a museum’s catalog extract.

User guide

Prerequisites

ComeOn! may be launched on a computer (Windows, Linux ou macOS) where Java 8 or more for 64 bit architecture is installed. It relies on Java Web Start (fr,de) which is installed with Java.

ComeOn! only supports format JPEG format for pictures. Picture metadata are extracted by the Metadata Extractor library by Drew Noakes, in the limits that this library supports by itself.

External metadata may be read from a CSV file with fine format tweaks.

ComeOn! uses templates to generate the file description pages. You will have to prepare at least one template before you begin uploading files. You may find a set of basic templates on Github that you may download and extract to your computer.

You may have to approve security warnings about code signing. Before first launch, it is required to add ComeOn!'s site to Java's exceptions list. Follow the procedure on Oracle's site to add this URL: "https://edouardhue.github.io/".

Launching

Follow this link to launch ComeOn!.

At this point, you have no other choice than configuring or leaving the program. To configure, open the Edit ▸ Options menu or click the Options button in the toolbar.

Options

The options windows is used to set the models for the generation of the description pages of the pictures (Options ▸ Templates tab) and the accounts used to connect to the wikis (Options ▸ Wikis tab). To use ComeOn!, you need to configure at least one template and a wiki.

Changes made in the options window are only saved when you click the OK button. The Cancel button cancels all changes made this the window was opened.

Templates

A template is a file, in a specific templating language, used by ComeOn! to generate the description page of each uploaded media file. As of today, ComeOn! supports only one templating language: Velocity.

== {{int:filedesc}} ==

{{Information
 | Description = {{mld
    | en = $Iptc.CaptionAbstract
   }}
 | Source = {{own}}
 | Date = $date
 | Author = $user.displayName ([[User:$user.login]])
 | Permission = {{cc-by-sa-4.0|$user.displayName}}
}}
#if ($GPS.GPSVersionID == "2.200")
#parse ("includes/gps.vm")
#end

A Velocity template fragment to generate a description page with the Commons template {{Information}}.

Before adding templates to ComeOn!, these one must be put on your computer, at the location you like. ComeOn! is delivered without any template but you may download a few ones from Github and use them as an inspiration.

To add a template to ComeOn!, click on the Options ▸ Templates ▸ Add button.

ComeOn! displays the template configuration window. On this screen capture, the form is already filled with example values.

Settings relating to a template

Field	Usage
Name	Name of the template for ComeOn! to display
Description	Helper information to describe the content of the template.
Location	Select the location of the template file on your computer.
Charset	Character encoding to be used by ComeOn! to read the template file.
Kind	The templating engine to use with this model. Only Velocity is supported at the moment.

If you move the template file after adding it to ComeOn!, you must change its location in ComeOn! too.

If you don’t know which charset to use, UTF-8 is a common choice. If you choose a bad value, soome invalid characters may appear in the generated pages.

Templates ▸ Edit and Templates ▸ Remove buttons are used to change the settings for a template or to remove it from the list.

Removing a template does not delete it from your computer.

Wikis

You may configure ComeOn! to upload files to several wikis. Commons is mostly used amongst the Wikimedia projects but ComeOn! supports any recent Mediawiki instance. To make things easier, Wikimedia Commons is pre-configured in ComeOn!, you only have to set your credentials.

To set your Commons credentials, open the Options ▸ Wikis window, select the Commons entry from the list and click the Edit button. On first launch, only the two first fields are set, you need to set the remaining three.

Settings relating to a wiki.

Field	Usage
Name	The name of the wiki, used by ComeOn! for display
Description	Reminder to describe the wiki.
Display name	The full text name you want to use in this wiki, in attributions for example.
Login	The login you use to connect to this wiki.
Password	The password of your wiki account.

Depending on your operating system, your password might be stored in clear text on the hard drive. Be careful if you share your computer.

If you set a wrong password, ComeOn! could have your account locked down when attempting to connect too many times. Don’t forget to change your password in ComeOn!

Adding a wiki works the same way, only add a name and description.

You may remove the wikis you don’t need anymore from the list.

A star identifies the active wiki. Only one wiki may be active at a time. The active wiki settings are used when generating description pages and uploading. Don’t use the wrong wiki!

ComeOn! remembers the active wiki between launches.

Once you have set your templates and credentials, click OK to save your options.

Uploading pictures

As soon as templates and wikis are set up, a button becomes active in the toolbar of the main window. The button is used to upload images. The same operation may be reached with the File ▸ Open media menu or by dragging and dropping files in the main window.

ComeOn! displays the media selection window below:

If you drag and drop files, they are directly listed in the window. Else, click the Pick… button to open a file chooser and select the media to upload. Then choose a template in the dropdown list and click OK to open the selected files.

ComeOn! is regularly used to upload a few dozens of files. We are interested in feedback for batches of hundreds or thousands of files.

Using external metadata

ComeOn! can read information from an external CSV file, match it with selected and insert it into the description page. This chapter is about the way ComeOn! matches external file data with media; see next chapter about the way to insert this information into the description pages.

This feature may be useful when you have a discrete metadata catalog of a set of media, like when preparing a GLAM mass-upload. You may then insert directly information from the catalog into each media's description page.

This features activates with a click of the Use external metadata checkbox in the media selection dialog.

Choose the metadata file with a click of the Pick… button. The next dialog sets tweaks the precise file format.

CSV file format configuration fields

Field	Usage
Separator	Character used to separate fields – usually a comma or a semicolon.
Quote	An optional character used to quote fields – usually a straight double quotation mark.
Escape	Character preceding other special characters to avoid them being interpreted as such – usually a backslash.
Lines to skip	Number of lines to be ignored at the beginning of the file, if these are plain text comments as an example.
Strict quoting	When this checkbox is ticked, ComeOn! ignores all text outside of quotes.
Ignore leading white space	ComeOn! ignores all blank characters at the beginning of fields.
Charset	Select the charset that what used to save the file.

ComeOn! always assumes that the first line of content lists the name of the columns.

Supported charsets are those of the java.io API of the Java platform installed into your computer. For information, one may read the list of charsets supported by Java.

One need to specify how to match each line of the metadata file with a media, using the Match fields. For each media, ComeOn! extracts information from the file, using the expression from the right field, and searches for a match in the column chosen in the left field.

The expression to select information from the media applies to any metadata extracted from EXIF or audio headers, or the special keyword file.name. One indicates the name of the EXIF block followed by a period and the name of the field to select a piece of metadata. As an example, for the field ObjectName of the Iptc block, one writes Iptc.ObjectName.

Il n’est pas simple de mémoriser les noms des champs et des blocs EXIF. Vous verrez un peu plus loin que ComeOn! peut lister toutes les métadonnées d’une image, ce qui vous permettra de déduire le nom du champ et du bloc qui contient l’information qui vous intéresse.

Par défaut, ComeOn! recherche une correspondance exacte, mais l’information extraite de l’image peut être modifiée en utilisant les champs Expression régulière et Substitution. Au moment de l’ouverture des images, ComeOn! réalise les opérations suivantes, dans cet ordre :

1. Extraction de la métadonnée indiquée par l’expression de droite saisie dans Correspondance.
2. Application de l’expression régulière sur cette valeur.
3. Construction d’une nouvelle valeur en insérant les groupes collectés à l’étape précédente dans la chaîne de caractères saisie dans Substitution.
4. Recherche exacte de cette nouvelle valeur dans la colonne sélectionnée dans Correspondance.

Les expression régulières sont celles de la plateforme Java installée sur votre système, dans toute leur puissance et leur complexité.

Exemples de correspondances.

Chaîne en entrée	Expression	Substitution	Résultat	Explication
Mobeye-ÉtéDesVilles-Veyrines-de-Domme-210.jpg	.*	${0}	Mobeye-ÉtéDesVilles-Veyrines-de-Domme-210.jpg	Toute la chaîne en entrée est renvoyée telle quelle.
Mobeye-ÉtéDesVilles-Veyrines-de-Domme-210.jpg	(.*?)\.jpg	${1}	Mobeye-ÉtéDesVilles-Veyrines-de-Domme-210	L’expression sélectionne dans un groupe la partie avant l’extension du nom du fichier. La substitution ne conserve que ce groupe.
Mobeye-ÉtéDesVilles-Veyrines-de-Domme-210.jpg	Mobeye-ÉtéDesVilles-(.*?)-(\d+)\.jpg	${2}_${1}	210_Veyrines-de-Domme	L’expression ignore les deux premiers composants du nom et sélectionne les deux derniers dans deux groupes. La substitution conserve ces deux groupes en les inversant.

Preparing the description pages

Après l’ouverture des images, la fenêtre principale est découpée en trois zones. En bas, un bandeau affiche les miniatures des images, comme un rouleau de pellicule. En cliquant sur une vignette, on sélectionne cette image. Le panneau de gauche affiche une vignette plus grande de l’image sélectionnée et la liste des métadonnées contenues dans le fichier. Enfin, le panneau principal contient, dans deux onglets, le texte du modèle et le texte de la future page de description de l’image sélectionnée.

Vous pouvez apporter des ajustements aux modèles et aux pages de description avant de verser vos images. Lorsque vous faites un chamengent dans l’onglet Modèle, celui-ci est automatiquement pris en compte quand vous revenez sur l’onglet Contenu de la page.

Si vous faites un changement dans l’onglet Contenu de la page, puis un autre sur l’onglet Modèle, le changement de la page sera écrasé par le changement du modèle.

Inserting the image meta-data (EXIF) into the description pages

Vous pouvez utiliser toutes les métadonnées présentes dans une image pour construire sa page de description. Pour cela, il faut insérer cette information dans le modèle en utilisant la syntaxe propre au langage du modèle. Par exemple, avec un modèle Velocity, pour insérer la valeur du champ ObjectName du bloc EXIF Iptc, vous écririez $Iptc.ObjectName dans le modèle.

Dans le panneau de gauche, sous l’aperçu de l’image, ComeOn! liste les données lues dans chaque champ de chaque bloc EXIF.

Inserting meta-data stored in an external file

Si vous avez associé vos images à un fichier de données externes, vous pouvez insérer ces informations de la même manière que les métadonnées EXIF. Les informations externes sont regroupées dans le bloc $external, qui apparaît en bas du panneau de gauche. Par exemple, si votre fichier comprend une colonne nommée ville, vous pouvez insérer la valeur se trouvant sur la ligne associée à l’image courante avec l’expression $external.ville.

Uploading the images

Cliquez sur le bouton [[Upload icon (the Noun Project 7131).svg|16px|Bouton de téléversement des images.] ou sur le menu Fichier ▸ Téléverser les images pour démarrer le versement de toutes les images ouvertes sur le wiki actif. ComeOn! vous demande de confirmer votre action puis affiche la fenêtre de suivi du versement. Cette fenêtre affiche individuellement le pourcentage transféré de chaque fichier ainsi que l’avancement global du versement.

ComeOn! transfère deux fichiers à la fois pour optimiser l’utilisation de la bande passante. Les transferts démarrent les uns après les autres, jusqu'à épuisement de la liste. Si le transfert d'un fichier échoue, le logiciel signale l’erreur tout en passant au fichier suivant. Le bouton Arrêter interrompt le versement en cours.

Arrêter le versement ne défait pas les opérations déjà réalisées. Un fichier transféré avec succès avant l’arrêt restera donc publié sur le wiki.

Une fois le versement terminé, cliquez sur OK pour fermer la fenêtre de suivi. l’écran principal affiche une bordure colorée autour des images transférées, dans le bandeau inférieur :

Codes couleurs.

Couleur	Signification
Vert	Le transfert du fichier s'est déroulé avec succès.
Rouge	Le transfert a échoué et pourra être retenté.
Blanc	Le transfert n'a pas démarré et sera effectué au prochain déclenchement.

Tant que tous les fichiers ne sont pas au vert, vous pouvez déclencher un nouveau versement. ComeOn! transfèrera seulement les fichiers restants et ne renverra pas les fichiers déjà transférés avec succès.

External links

• Tutoriel et dépôt sur GitHub
• Category:Uploaded with ComeOn!