MAL-md: MyAnimeList Recently Watched/Read Cards

Show your 5 most recently watched anime or read manga from MyAnimeList in your GitHub README.

View Demo · Report Bug

Features ✨

• Show your 5 most recently watched anime or read manga from MyAnimeList
• Customizable card themes and layout (vertical/horizontal)
• Show/hide background cover image
• User profile picture and anime/manga cover thumbnails
• Easy to embed in your GitHub README

Usage ⚡️

Copy the markdown below and paste it in your Github Readme, replacing USERNAME with your MyAnimeList username.

[![MAL Recently Watched](https://mal-md.vercel.app/api?username=USERNAME&type=horizontal&theme=dark)](https://myanimelist.net/profile/USERNAME)

API Scopes (Query Parameters)

Parameter	Type	Default	Description
username	string	(none)	Your MyAnimeList username (required)
type	string	vertical	Card layout: vertical or horizontal
theme	string	default	Card theme (see below for available themes)
border	boolean	false	Show card border: true or false
manga	boolean	false	Show manga stats instead of anime: true or false
bg	boolean	true	Show background cover image: true (show) or false (hide, use theme color background)
count	number	5	Number of entries to show (1-10)
hide_pfp	boolean	false	Hide the user profile picture: true or false
title	string	(auto)	Custom card title (overrides default)
font_size	number	(auto)	Font size for card title and entries (in px)
rounded	boolean	true	Rounded card corners: true (rounded) or false (square)

Example URLs

Recently Watched Anime (default):

https://mal-md.vercel.app/api?username=USERNAME

Recently Read Manga:

https://mal-md.vercel.app/api?username=USERNAME&manga=true

Horizontal Card with Dark Theme:

https://mal-md.vercel.app/api?username=USERNAME&type=horizontal&theme=dark

Hide Background Image:

https://mal-md.vercel.app/api?username=USERNAME&bg=false

Show 3 entries, custom title, square corners:

https://mal-md.vercel.app/api?username=USERNAME&count=3&title=My%20Anime%20History&rounded=false

All Scopes Example:

https://mal-md.vercel.app/api?username=USERNAME&type=horizontal&theme=catppuccin_mocha&border=true&manga=true&bg=false

Themes

Available themes (use with theme parameter):

• default
• dark
• chartreuse_dark
• radical
• merko
• gruvbox
• tokyonight
• catppuccin
• catppuccin_latte
• catppuccin_frappe
• catppuccin_macchiato
• catppuccin_mocha
• algolia
• monokai
• dracula
• nord
• github
• graywhite
• moonlight
• hackerman
• shadow_red
• shadow_green
• shadow_blue

Development

Install dependencies:

pnpm install

Run locally:

npx vercel dev

Contributing 🤝

Contributions, issues and feature requests are welcome!

Feel free to check issues page.

Special Thanks ❤

• Inspired by AnuragHazra/github-readme-stats.
• Huge thanks to Jikan.moe for providing the API!

Show your support 🌈

Be sure to drop a 🌟 if you like the project!

Author 🤗

👤 SajagIN

• Website: https://SajagIN.thedev.id
• Twitter: @SajagIN1
• Github: @SajagIN

Made by SajagIN with ❤ and TypeScript