# upload_to_commons_with_categories_from_iptc

> gThumb script to upload to Wikimedia Commons

**Wikidata**: [Q134532442](https://www.wikidata.org/wiki/Q134532442)  
**Source**: https://4ort.xyz/entity/upload-to-commons-with-categories-from-iptc

## Summary
`upload_to_commons_with_categories_from_iptc` is a gThumb script designed to facilitate uploading images to Wikimedia Commons. It automates the process by extracting categories directly from the image's IPTC metadata. This tool is distributed as free software and is written in Python.

## Key Facts
*   **Purpose**: A gThumb script to upload media to Wikimedia Commons.
*   **Author**: Vitaly Zdanevich.
*   **Programming Language**: Python.
*   **License**: MIT License.
*   **Type**: Free software and a Wikimedia Commons tool.
*   **Dependencies**: Requires gThumb and Pywikibot; optionally depends on `iptcinfo3`, Q1047199, and Q137190252.
*   **Source Code**: Hosted on GitLab at `https://gitlab.com/vitaly-zdanevich/upload_to_commons_with_categories_from_iptc`.
*   **Copyright Status**: Copyrighted.
*   **Wikimedia Commons Categorization**: Uploads are associated with the `Uploaded with gThumb script` category.

## FAQs
### Q: What is `upload_to_commons_with_categories_from_iptc`?
A: It is a gThumb script that enables users to upload media files to Wikimedia Commons. A key feature is its ability to automatically extract and apply categories from the image's IPTC metadata during the upload process.

### Q: Who created this script?
A: The script was created by Vitaly Zdanevich, a Belarusian software engineer and Wikimedian. He is also known as a programmer.

### Q: What programming language is `upload_to_commons_with_categories_from_iptc` written in?
A: The script is written in Python, a general-purpose programming language first released in 1991.

### Q: What software does this script depend on to function?
A: It depends on gThumb and Pywikibot. Additionally, it can optionally utilize `iptcinfo3`, Q1047199, and Q137190252 for enhanced functionality.

### Q: What is the license for `upload_to_commons_with_categories_from_iptc`?
A: The script is distributed under the MIT License, classifying it as free software. This allows users to freely run, study, change, and distribute it and its modified versions.

## Why It Matters
`upload_to_commons_with_categories_from_iptc` addresses a common challenge for contributors to Wikimedia Commons: the efficient and accurate categorization of uploaded media. By integrating directly with gThumb, a popular image viewer and organizer, it streamlines the workflow for users who manage their photos within this environment. Its ability to automatically extract categories from IPTC metadata significantly reduces manual effort and potential errors, ensuring that uploaded files are correctly classified from the outset. This automation is particularly valuable for photographers and content creators who embed rich metadata in their images. As free software, it embodies the principles of open collaboration and accessibility, allowing anyone to use, study, and improve the tool. This not only benefits individual users but also contributes to the broader Wikimedia ecosystem by simplifying contributions and enhancing the quality of metadata on Commons. Its existence supports the goal of making digital content more discoverable and usable for a global audience.

## Notable For
*   **Direct gThumb Integration**: Uniquely functions as a script specifically designed to extend gThumb's capabilities for Wikimedia Commons uploads.
*   **IPTC Category Extraction**: Automates the crucial step of assigning categories to uploads by reading them directly from image IPTC metadata.
*   **Free Software Status**: Distributed under the MIT License, promoting open access, modification, and distribution of the tool.
*   **Python Implementation**: Developed using Python, a widely adopted general-purpose programming language.

## Body

### Overview and Purpose
`upload_to_commons_with_categories_from_iptc` is a specialized script designed to facilitate the contribution of media to Wikimedia Commons. Its primary function is to enable users of the gThumb image viewer and organizer to directly upload their files to Wikimedia Commons. A key feature is its capability to automatically extract category information embedded within the image's IPTC (International Press Telecommunications Council) metadata, thereby streamlining the categorization process on Commons.

### Technical Specifications
The script is classified as both free software and a Wikimedia Commons tool.
*   **Programming Language**: It is developed using Python, a general-purpose programming language first released in 1991.
*   **License**: The script is distributed under the MIT License, which permits users to freely run, study, change, and distribute the software and its modified versions.
*   **Dependencies**:
    *   **Required**: gThumb (the image viewer and organizer) and Pywikibot (a Python library for interacting with MediaWiki sites, including Wikimedia Commons).
    *   **Optional**: `iptcinfo3` (a library for reading/writing IPTC metadata), Q1047199, and Q137190252.
*   **Copyright**: The software is copyrighted.

### Creator
The script was authored by Vitaly Zdanevich. He is identified as a Belarusian software engineer and Wikimedian, born on March 17, 1990. His occupation is listed as a programmer.

### Availability and Media
The source code for `upload_to_commons_with_categories_from_iptc` is publicly available.
*   **Source Code Repository**: `https://gitlab.com/vitaly-zdanevich/upload_to_commons_with_categories_from_iptc`. The repository is hosted on GitLab and is associated with the topics Q186055 and Q16639197.
*   **Associated Media**:
    *   **Image**: An image demonstrating the script in use is available at `https://commons.wikimedia.org/wiki/Special:FilePath/Gthumb-uploading-to-wikimedia-commons.webp`.
    *   **Video**: A video showcasing the upload process through the script is available at `https://commons.wikimedia.org/wiki/Special:FilePath/Wikimedia-commons--uploading-through-my-python-script-for-gthumb--and-a-little-about-dtmediawiki-plugin-for-darktable.webm`.

### Wikimedia Commons Integration
When media is uploaded using this script, it is automatically associated with the Wikimedia Commons category `Uploaded with gThumb script`. This helps track and identify content contributed via this specific tool.