Des stats de code dans le README de votre profil GitHub, sans clé d'API

Une ligne de statistiques de code sur un profil GitHub dit dans quoi vous travaillez, plus honnêtement qu'une rangée de logos. L'y mettre revient surtout à savoir d'où viennent les chiffres et qui les tient à jour : un service qui dessine une image à la demande, ou une tâche planifiée qui réécrit votre README.

Comment un README de profil affiche des stats

GitHub affiche en haut de votre profil le README.md du dépôt public qui porte le nom de votre identifiant. Il y rend du Markdown et un peu de HTML, rien d'autre : aucun script n'y tourne, et GitHub ne va jamais chercher du Markdown sur un autre site. Les images font exception. Une adresse d'image dans le README passe par le proxy d'images de GitHub, qui la met en cache et la sert à chaque visiteur.

Une carte de statistiques est donc une image qu'un service dessine quand GitHub la demande. Le texte du README lui-même, un tableau de langages par exemple, ne change que si quelque chose commite une nouvelle version du fichier.

Trois façons de les y mettre

Chaque outil que vous trouverez fait l'une de ces trois choses. Ils diffèrent par ce que vous devez conserver et par ce qui garde les chiffres à jour.

L'image hébergée demande le moins d'entretien : rien ne change dans votre dépôt et il n'y a aucun secret à renouveler. Le Markdown réécrit donne du texte brut dans votre README, que certains préfèrent à une image, au prix d'un workflow et d'un commit par jour.

Installer la carte inlinr

La carte montre le temps qu'une extension inlinr enregistre dans votre éditeur : il lui faut un compte gratuit et une extension avant d'afficher quoi que ce soit.

1. Connectez-vous avec GitHub. Votre identifiant GitHub devient l'adresse de la carte : inlinr.com/u/votre-identifiant.
2. Installez une extension pour VS Code, Cursor, Windsurf ou Claude Code, ou pointez le plugin WakaTime de n'importe quel éditeur vers inlinr. Codez une minute et la première session apparaît.
3. Activez votre profil public dans Settings → Sharing. Cochez les sections que montre la carte : langages, éditeurs, outils d'IA, part de votre temps avec un assistant, jours actifs. Il est désactivé par défaut, et rien ne s'affiche tant que vous ne l'activez pas.
4. Ajoutez le bloc de la page de la carte README au README de votre profil : du texte par défaut (un tableau par liste, votre moyenne par jour et votre meilleur jour, les jours de la semaine si vous le voulez, réécrit par une tâche quotidienne), la carte, ou les deux. La page montre d'abord votre vrai bloc, dans les thèmes clair et sombre de GitHub. Connecté, Settings → README garde vos choix et coche chaque étape dès que GitHub la montre ; la tâche est alors l'action publique inlinrhq/readme-stats ↗, une ligne, sans secret.

Un profil gratuit montre les 7 derniers jours. En Pro, vous pouvez choisir 30 ou 90 jours, ou tout l'historique, pour le profil et pour chaque carte.

Clair et sombre

Les lecteurs de GitHub choisissent un thème clair ou sombre, et une carte dessinée pour l'un détonne sur l'autre. La façon documentée par GitHub de servir les deux est un élément picture : une source pour les lecteurs en mode sombre, l'image pour tous les autres. C'est la ligne que la page de la carte vous donne par défaut :

<a href="https://inlinr.com/u/votre-identifiant">
  <picture>
    <source media="(prefers-color-scheme: dark)" srcset="https://inlinr.com/u/votre-identifiant/stats?format=svg&theme=dark">
    <img alt="Statistiques de code inlinr" src="https://inlinr.com/u/votre-identifiant/stats?format=svg&theme=light">
  </picture>
</a>

Pour fixer un seul thème, choisissez Light ou Dark sur la page et collez l'image Markdown unique qu'elle vous donne.

Mises en page, statut et ce qu'on retire

La carte existe en trois mises en page, à choisir sur la page de la carte ou avec layout= dans son adresse :

• la carte classique, une colonne dans la couleur d'accent, par défaut ;
• layout=columns, plus large, avec les langages à gauche, chacun dans sa couleur sur GitHub, et les éditeurs et outils d'IA à droite ;
• layout=compact, trois lignes : votre total, la part avec l'IA et une barre de vos langages, pour un README déjà bien rempli.

L'adresse peut aussi retirer des éléments : hide=editors,ai (parmi languages, editors, ai, status, project, days) et rows=3. days est la bande sous le total, une barre par jour d'une période de 7, 14, 30 ou 90 jours, affichée tant que votre calendrier est public. Elle ne peut que retirer. Ce que vos réglages masquent reste masqué quoi que dise l'adresse : un lien copié depuis votre README ne peut pas montrer plus que ce que vous avez choisi.

Trois autres changent son allure, jamais ce qu'elle montre : lang=fr écrit la carte et le texte en français (dernière session · 28 oct.), accent= choisit sa couleur (blue, violet, orange, pink ou teal ; le vert par défaut) et border=0 retire son cadre, pour un README qui a déjà le sien. Settings → README propose les trois mêmes choix.

Le statut est désactivé tant que vous ne l'activez pas dans Settings → Sharing. Activé, la carte indique last session · 28 Oct, le jour de votre dernière session dans votre fuseau horaire, jamais une heure ; à son second niveau, elle indique coding now pendant que vous codez. Un badge à part, /u/votre-identifiant/status.svg, dit la même chose à côté de vos autres badges. Les caches le retardent de 5 à 10 minutes, un peu plus via GitHub.

Depuis waka-readme ou github-readme-stats

waka-readme est une Action qui réécrit le texte entre ses repères waka avec vos statistiques WakaTime, grâce à votre clé d'API WakaTime conservée en secret. Pour passer à inlinr :

• pour une image, supprimez les repères, le workflow et le secret WAKATIME_API_KEY, puis collez la ligne de la carte ;
• pour garder du texte, choisissez Texte sur la page de la carte : remplacez les repères par les deux d'inlinr ci-dessous, et le workflow par celui que donne la page. Il lit votre profil public, le secret peut donc disparaître.

<!--START_SECTION:inlinr-->
<!--END_SECTION:inlinr-->

Ou gardez waka-readme tel quel : réglez son API_BASE_URL sur https://inlinr.com/api/compat/wakatime et remplacez le secret par une clé WakaTime créée dans Settings → Editors. Le titre, le total et les langages passent. Attention : une clé lit toutes vos statistiques, projets privés compris, quoi que cache votre profil public.

github-readme-stats dessine une carte WakaTime à partir de votre profil WakaTime public. Remplacez sa ligne d'image par la carte inlinr ; rien d'autre ne change dans votre README. Votre historique peut suivre aussi : le guide pour quitter WakaTime l'importe, et vos plugins WakaTime peuvent continuer d'envoyer vers inlinr.

Ou gardez sa carte WakaTime en la faisant lire inlinr : ajoutez &api_domain=inlinr.com à l'adresse de l'image, après username=votre-identifiant. Elle lit votre profil public sans clé, donc elle montre ce que montre votre profil et rien de plus ; la même adresse sert le plugin WakaTime de metrics, avec plugin_wakatime_url: https://inlinr.com.

Ce que la carte montre, et ce qu'elle ne montre jamais

La carte montre des totaux et des pourcentages, sur la période choisie, pour les sections cochées. Elle ne montre jamais un nom de fichier, un client ou un montant, et aucun projet sauf si vous en cochez un dont le dépôt GitHub est public (dans les réglages du projet) : elle indique alors « Working on owner/repo » avec votre temps dessus, et le retire d'elle-même si le dépôt devient privé. Un projet masqué dans les réglages est aussi retiré des totaux, et un langage masqué disparaît de la liste. La page sécurité liste tout ce qui peut être public sur inlinr, et qui le voit.

Sources

• Gestion de votre README de profil, documentation GitHub : le dépôt qui porte votre nom d'utilisateur. Consulté le 29 octobre 2026.
• Spécifier le thème pour lequel une image est affichée, documentation GitHub : l'élément picture qui sert une image claire et une image sombre. Consulté le 29 octobre 2026.
• À propos des URL anonymisées, documentation GitHub : pourquoi GitHub sert les images des README par son propre proxy et les met en cache. Consulté le 29 octobre 2026.