How do I add hall of fame to my GitHub README?

Sign in to sourcerer.io with GitHub, go to Settings/Hall-of-fame, add your repository, and paste the generated code into your README.md file. It updates automatically every hour with no further maintenance needed.

Hall of fame vs shields.io contributor badges – which is better?

Hall of fame focuses on dynamic, categorized contributor recognition with avatars and badges that update hourly, while shields.io provides static badges for various metrics. Choose hall of fame for visual engagement, but it requires Sourcerer integration.

Why isn't my commit showing up in hall of fame?

Hall of fame updates hourly and prioritizes contributors based on commit count in the last 7 days. Wait for the next refresh or make more commits to improve your ranking. Also, ensure your repository is properly added in Sourcerer settings.

Can I customize the look of the hall of fame widget?

No, the widget uses predefined styling from Sourcerer. The README doesn't mention customization options, so you're limited to the default appearance and layout, which may not fit all branding needs.

Does hall of fame work with private repositories?

It likely requires public access to GitHub API data. The setup involves signing in with GitHub, but for private repos, you need to check Sourcerer's permissions and ensure the repo is accessible, as it depends on GitHub API visibility.

What happens if Sourcerer goes down?

The widget would stop updating or displaying, as it relies on Sourcerer's service for data processing and image hosting. This dependency means your README could be affected by third-party outages.

Open-Awesome

Hall-of-fame

MITPython0.1.4

A widget for GitHub repository READMEs that automatically highlights new, trending, and top contributors with avatars and badges.

GitHub

952 stars91 forks0 contributors

What is Hall-of-fame?

Hall-of-fame is a widget that automatically highlights contributors in a GitHub repository's README. It categorizes contributors as new, trending, or top based on commit activity and updates hourly. The tool helps maintainers visually recognize contributors to foster community engagement.

Target Audience

Open-source maintainers and project owners who want to showcase and appreciate contributors directly in their repository READMEs.

Value Proposition

It provides a fully automated, visually appealing way to recognize contributors without manual updates, encouraging ongoing participation by featuring recent activity prominently.

Overview

:trophy: Show some love to your contributors! A widget for your repo README. Visual and clean. Refreshes every hour.

Use Cases

Best For

Adding dynamic contributor recognition to open-source project READMEs
Automatically highlighting new contributors to encourage first-time participation
Showcasing trending contributors based on recent commit activity
Creating a visual leaderboard for top all-time contributors
Enhancing repository READMEs with engaging, auto-updating widgets
Integrating contributor avatars with profile links for increased visibility

Not Ideal For

Private repositories needing internal contributor tracking without public exposure
Projects requiring real-time updates or more frequent refreshes than hourly
Teams wanting full control over widget styling and branding without third-party dependencies
Repositories hitting GitHub API limits or with strict rate limiting policies

Pros & Cons

Pros

Automated Hourly Updates

Refreshes contributor data every hour using GitHub API, ensuring the README always reflects recent activity without manual intervention, as stated in the README.

Contributor Categorization

Highlights three categories: new (first commit in 7 days), trending (most commits in 7 days), and top (all-time), making recognition dynamic and encouraging ongoing participation, based on the README explanation.

Visual Appeal with Links

Displays up to 7 contributors with avatars and badges, each linking to their GitHub or Sourcerer profile, increasing visibility and engagement, as shown in live examples.

Easy Setup Process

Simply sign in to Sourcerer, add your repository, and paste the provided code into your README, with no maintenance required, per the 'Getting started' section.

Cons

Arbitrary Entry Limit

Only shows 7 contributors, which the FAQ admits is arbitrary and may exclude many active contributors in larger projects, limiting recognition scope.

Third-Party Dependency

Relies on Sourcerer for service and enhanced avatars, posing a risk if the service becomes unavailable or changes policies, creating vendor lock-in.

GitHub API Consumption

Makes hourly API requests that count towards GitHub's 5,000 limit, potentially affecting other integrations for active repositories, as noted in the README.

Frequently Asked Questions

Related Projects

GitHub Readme Stats

:zap: Dynamically generated stats for your github readmes

Stars79,227

Forks32,783

Last commit1 month ago

readme-md-generator

📄 CLI that generates beautiful README.md files

Stars11,109

Forks1,380

Last commit3 years ago

README Typing SVG

⚡ Dynamically generated, customizable SVG that gives the appearance of typing and deleting text for use on your profile page, repositories, or website.

Stars8,732

Forks1,523

Last commit2 months ago

Standard Readme

A standard style for README files

Stars6,298

Forks2,525

Last commit23 days ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub