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/
30 commits 1 branch 0 tags 264 KiB
Find a file
Edward Betts d59e67b55d Display total count of photos obtained via Flickr mail 
Show the total number of successful Flickr mail requests on the home
page, not just the count of recent uploads displayed.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-06 18:17:33 +00:00
static/css Show errors, even in production. 2023-09-09 17:06:01 +03:00
templates Display total count of photos obtained via Flickr mail 2026-02-06 18:17:33 +00:00
.gitignore Show recent Commons uploads obtained via Flickr mail 2026-02-06 10:43:45 +00:00
AGENTS.md Show recent Commons uploads obtained via Flickr mail 2026-02-06 10:43:45 +00:00
LICENSE Add README.md and LICENSE 2023-09-29 12:31:15 +01:00
main.py Display total count of photos obtained via Flickr mail 2026-02-06 18:17:33 +00:00
README.md Show recent Commons uploads obtained via Flickr mail 2026-02-06 10:43:45 +00:00
update_flickr_uploads.py Show recent Commons uploads obtained via Flickr mail 2026-02-06 10:43:45 +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 photographer's name and license for each photo.
  • License highlighting: Photos with Wikipedia-compatible licenses (CC BY, CC BY-SA, CC0, Public Domain) are highlighted with a green badge.
  • One-click message composition: Click any photo to compose a permission request message with the photo displayed alongside.
  • 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 photographer's Flickr profile.
  • Generate messages to request permission to use photos on Wikipedia.
  • 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 the Wikipedia article title or URL.
  4. Browse the Flickr search results displayed in the interface.
  5. Click on a photo to select it and compose a permission request message.
  6. Copy the subject and message, then click "Send message on Flickr" to contact the photographer.

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!