edward/flickr-mail
1
0
Fork 0
Code Issues 1 Pull requests Projects Releases Packages Wiki Activity
Find photos on flickr for Wikipedia articles and contact the photographer. https://edwardbetts.com/flickr_mail/
34 commits 1 branch 0 tags 264 KiB
Find a file
Edward Betts e072279566 Stop fetching all pages when downloading sent mail
2026-02-07 13:24:09 +00:00
flickr_mail Extract flickr_mail package with Mapped models and shared utilities 2026-02-07 13:10:49 +00:00
static/css Show errors, even in production. 2023-09-09 17:06:01 +03:00
templates Add category search, license handling, and message page improvements 2026-02-07 10:22:19 +00:00
.gitignore Extract flickr_mail package with Mapped models and shared utilities 2026-02-07 13:10:49 +00:00
AGENTS.md Update README and AGENTS with category search and license features 2026-02-07 10:26:56 +00:00
download_commons_contributions.py Stop fetching all pages when downloading sent mail 2026-02-07 13:24:09 +00:00
download_sent_mail.py Stop fetching all pages when downloading sent mail 2026-02-07 13:24:09 +00:00
extract_flickr_uploads.py Extract flickr_mail package with Mapped models and shared utilities 2026-02-07 13:10:49 +00:00
LICENSE Add README.md and LICENSE 2023-09-29 12:31:15 +01:00
main.py Extract flickr_mail package with Mapped models and shared utilities 2026-02-07 13:10:49 +00:00
migrate_json_to_db.py Extract flickr_mail package with Mapped models and shared utilities 2026-02-07 13:10:49 +00:00
README.md Update README and AGENTS with category search and license features 2026-02-07 10:26:56 +00:00
update_flickr_uploads.py Extract flickr_mail package with Mapped models and shared utilities 2026-02-07 13:10:49 +00:00

README.md

Flickr Photo Finder for Wikipedia Articles

Tool lives here: https://edwardbetts.com/flickr_mail/

This tool is designed to help you find photos on Flickr for Wikipedia articles and contact the photographer. It's a Python application that leverages the Flask framework for web development.

Table of Contents

Introduction

This tool is developed and maintained by Edward Betts (edward@4angle.com). Its primary purpose is to simplify the process of discovering and contacting photographers on Flickr whose photos can be used to enhance Wikipedia articles.

Key Features

  • Integrated Flickr search: Enter a Wikipedia article title and see Flickr photos directly in the interface - no need to visit Flickr's search page.
  • Photo grid with metadata: Search results display as a grid of thumbnails showing the user's name and license for each photo.
  • License handling: Photos with Wikipedia-compatible licenses (CC BY, CC BY-SA, CC0, Public Domain) are highlighted with a green badge and link directly to the Commons UploadWizard. Non-free CC licenses (NC/ND) show a tailored message explaining Wikipedia's requirements. Supports both CC 2.0 and CC 4.0 license codes.
  • One-click message composition: Click any photo to compose a permission request message with the photo displayed alongside, showing the user's Flickr profile and current license.
  • Previous message detection: The message page checks sent mail history and warns if you have previously contacted the user.
  • Category search: Find Wikipedia articles without images in a given category, with links to search Flickr for each article.
  • Pagination: Browse through thousands of search results with page navigation.
  • Recent uploads showcase: The home page displays recent Wikimedia Commons uploads that were obtained via Flickr mail requests, with links to the Wikipedia article and user's Flickr profile.
  • Handle exceptions gracefully and provide detailed error information.

Usage

To use the tool, follow these steps:

  1. Start the tool by running the script.
  2. Access the tool through a web browser.
  3. Enter a Wikipedia article title or URL, or use "Find articles by category" to discover articles that need images.
  4. Browse the Flickr search results displayed in the interface.
  5. Click on a photo to select it. If the license is Wikipedia-compatible, you'll be linked to the Commons UploadWizard. Otherwise, a message is composed to request a license change.
  6. Copy the subject and message, then click "Send message on Flickr" to contact the user.

Error Handling

The application includes error handling to ensure a smooth user experience. If an error occurs, it will display a detailed error message with traceback information. The error handling is designed to provide valuable insights into any issues that may arise during use.

Running the Application

To run the application, ensure you have Python 3 installed on your system. You will also need to install the required Python modules mentioned in the script, including Flask, requests, and others.

  1. Clone this repository to your local machine.
  2. Navigate to the project directory.
  3. Run the following command to start the application:
python3 main.py
  1. Access the application by opening a web browser and visiting the provided URL (usually http://localhost:5000/).

That's it! You can now use the Flickr Photo Finder tool to streamline the process of finding and contacting photographers for Wikipedia articles.

If you encounter any issues or have questions, feel free to contact Edward Betts (edward@4angle.com).

Happy photo hunting!