Commons Browser - Your gateway for media of Wikimedia Commons

A Streamlit application that provides detailed statistics and analytics for Wikimedia Commons contributors. This tool helps users understand their contribution patterns, media usage, and file distributions.

📋 Features

• 1. User Statistics
• Total number of files uploaded
• Total media requests
• Total size of uploads
• Number of active upload days
• Days since first and last uploads
• Upload frequency metrics
• Activity rate analysis

• 1. File Analysis
• File type distribution with visualizations
• License distribution statistics
• Detailed data table with thumbnails
• Daily request trends for each file

• 1. Time Range Options
• Custom date range
• Preset ranges (Last 7 days, Last 30 days, etc.)
• All-time statistics

🚀 Installation

1. Clone this repository:

git clone <repository-url>
cd <repository-directory>

2. Create and activate a virtual environment (optional but recommended):

python -m venv .venv
source .venv/bin/activate  # On Windows, use `.venv\Scripts\activate`

3. Install required packages:

pip install streamlit aiohttp pandas plotly

💻 Usage

1. Run the Streamlit application:

streamlit run commons-browser.py

2. Open your web browser and navigate to the provided URL (typically http://localhost:8501)

3. Enter a Wikimedia Commons username and select a date range

4. View the generated statistics and visualizations

📊 Available Statistics

• File Metrics: Total count, size, and media requests
• Time-based Analytics: Upload patterns and activity rates
• Content Analysis:
  • File type distribution
  • License distribution
  • Daily request trends
• Detailed Data Table: Comprehensive view of all uploads with thumbnails

🛠️ Technical Details

• Built with Streamlit for the user interface
• Uses async/await for efficient API requests
• Integrates with Wikimedia Commons API
• Visualizations powered by Plotly
• Responsive design with mobile support

📝 Requirements

• Python 3.9+
• streamlit
• aiohttp
• pandas
• plotly

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

🙏 Acknowledgments

• Wikimedia Commons for providing the API
• Streamlit for the excellent web framework
• The open-source community for various dependencies

📧 Contact

For questions and feedback, please open an issue in this GitLab repository.