Skip to content
Open {re}Source

    Articles · 2024-04-27

    contrib.rocks: Generate an Image of GitHub Repositories Top Contributors

    Julien DéramondUpdated 1 min readGitHub · Markdown · Readme · ToolsCC BY-SA 4.0

    Related chapterCommunity From Day OneBuilding a Strong Project Identity

    contrib.rocks is an online tool that generates an image of the top contributors of a GitHub repository. You can embed it in any website or Markdown file, including your README file.

    It’s completely free and maintained by Suguru Inatomi, a.k.a. lacolaco. The source code is available on GitHub:

    lacolaco/
    contributors-img

    This service gives a visual representation of the top contributors of any GitHub repository.

    Generating such an image of your GitHub repository top contributors is a great way to show the activity of your GitHub repository, encourage people to contribute and celebrate your top contributors.

    How to Use#

    Usage is pretty straightforward:

    1. Go to https://contrib.rocks/
    2. Enter a GitHub repository (e.g., open-reSource/openresource.dev)

    And that’s it! You’ll get the image representing the top contributors of the GitHub repository you entered.

    Then, you can click on the “Get Image URL!” button to get the Markdown code to embed the image in your README file for instance.

    <a href="https://github.com/open-reSource/openresource.dev/graphs/contributors">
  <img src="https://contrib.rocks/image?repo=open-reSource/openresource.dev" />
</a>

Made with [contrib.rocks](https://contrib.rocks).

    The first part of the generated Markdown code is actually HTML. You can use it to embed the image in any website or Markdown file.

    Rendering#

    Here’s what it looks like for our openresource.dev GitHub repository:

    Made with contrib.rocks.

    And here is the same rendering, but on a more active repository like godot:

    godotengine/
    godot    Godot Engine – Multi-platform 2D and 3D game engine

    Made with contrib.rocks.

    Some parameters can be added to the URL to customize the image:

    • max={number}: Max contributor count (100 by default)
    • columns={number}: Max columns (12 by default)
    • anon={0|1}: Include anonymous users (false by default)

    Add &max=10&columns=2 to the image URL https://contrib.rocks/image?repo=godotengine/godot and you get the following image with only the top 10 contributors and 2 columns:

    <a href="https://github.com/godotengine/godot/graphs/contributors">
  <img src="https://contrib.rocks/image?repo=godotengine/godot&max=10&columns=2" />
</a>

Made with [contrib.rocks](https://contrib.rocks).

    Made with contrib.rocks.