roleplay-gifs

A curated collection of high-quality anime roleplay GIFs, organized by action category and ready to use in bots, apps, or anything else.

---

Stats

Stat	Value
Total categories	70
Total GIFs	1114
Hosted on	GitHub Raw CDN
Index file	index.json

---

Direct URL pattern

https://raw.githubusercontent.com/itsfizys/roleplay-gifs/main/{category}/{n}.gif

Replace {category} with any category name and {n} with a number from 1 to the category's count.

---

index.json

The index.json file at the root of this repo contains all category names and their GIF counts. Fetch it once and use it to resolve valid ranges without hardcoding anything.

{
  "base_url": "https://raw.githubusercontent.com/itsfizys/roleplay-gifs/main",
  "total_categories": 70,
  "total_gifs": 1114,
  "categories": {
    "hug": 17,
    "slap": 16,
    ...
  }
}

---

Usage examples

JavaScript

async function randomGif(category) {
  const index = await fetch(
    "https://raw.githubusercontent.com/itsfizys/roleplay-gifs/main/index.json"
  ).then((r) => r.json());

  const count = index.categories[category];
  if (!count) throw new Error(`Unknown category: ${category}`);

  const n = Math.floor(Math.random() * count) + 1;
  return `${index.base_url}/${category}/${n}.gif`;
}

// Example
const url = await randomGif("hug");
console.log(url);
// https://raw.githubusercontent.com/itsfizys/roleplay-gifs/main/hug/7.gif

Python

import httpx
import random

def random_gif(category: str) -> str:
    index = httpx.get(
        "https://raw.githubusercontent.com/itsfizys/roleplay-gifs/main/index.json"
    ).json()

    count = index["categories"].get(category)
    if not count:
        raise ValueError(f"Unknown category: {category}")

    n = random.randint(1, count)
    return f"{index['base_url']}/{category}/{n}.gif"

# Example
print(random_gif("pat"))
# https://raw.githubusercontent.com/itsfizys/roleplay-gifs/main/pat/3.gif

Fetching a specific GIF

If you already know the category and want a specific GIF, you can construct the URL directly:

https://raw.githubusercontent.com/itsfizys/roleplay-gifs/main/hug/1.gif
https://raw.githubusercontent.com/itsfizys/roleplay-gifs/main/slap/4.gif
https://raw.githubusercontent.com/itsfizys/roleplay-gifs/main/cry/11.gif

---

npm package

An npm wrapper is also available if you prefer installing via a package manager.

npm install gifcdn

→ npmjs.com/package/gifcdn

import { random, get, list, categories } from "gifcdn";

await random("hug");        // → full URL to a random hug GIF
await get("slap", 3);       // → .../slap/3.gif
await list("cry");          // → array of all 22 cry GIF URLs
await categories();         // → ["airkiss", "angrystare", ...]

The package ships with TypeScript types and zero dependencies — it's a thin wrapper around the same raw CDN URLs above.

---

Categories

All categories listed alphabetically with their GIF count, URL pattern, and a preview.

Category	Count	URL pattern	Preview
airkiss	6	.../airkiss/{1..6}.gif
angrystare	32	.../angrystare/{1..32}.gif
bite	20	.../bite/{1..20}.gif
bleh	7	.../bleh/{1..7}.gif
blush	41	.../blush/{1..41}.gif
brofist	9	.../brofist/{1..9}.gif
celebrate	7	.../celebrate/{1..7}.gif
cheers	6	.../cheers/{1..6}.gif
clap	8	.../clap/{1..8}.gif
confused	8	.../confused/{1..8}.gif
cool	4	.../cool/{1..4}.gif
cry	46	.../cry/{1..46}.gif
cuddle	29	.../cuddle/{1..29}.gif
dance	33	.../dance/{1..33}.gif
drool	12	.../drool/{1..12}.gif
evillaugh	10	.../evillaugh/{1..10}.gif
facepalm	5	.../facepalm/{1..5}.gif
handhold	10	.../handhold/{1..10}.gif
happy	15	.../happy/{1..15}.gif
headbang	8	.../headbang/{1..8}.gif
hug	40	.../hug/{1..40}.gif
huh	6	.../huh/{1..6}.gif
kiss	36	.../kiss/{1..36}.gif
laugh	17	.../laugh/{1..17}.gif
lick	14	.../lick/{1..14}.gif
love	9	.../love/{1..9}.gif
mad	25	.../mad/{1..25}.gif
nervous	18	.../nervous/{1..18}.gif
no	8	.../no/{1..8}.gif
nom	46	.../nom/{1..46}.gif
nosebleed	5	.../nosebleed/{1..5}.gif
nuzzle	10	.../nuzzle/{1..10}.gif
nyah	8	.../nyah/{1..8}.gif
pat	27	.../pat/{1..27}.gif
peek	6	.../peek/{1..6}.gif
pinch	11	.../pinch/{1..11}.gif
poke	17	.../poke/{1..17}.gif
pout	29	.../pout/{1..29}.gif
punch	15	.../punch/{1..15}.gif
roll	7	.../roll/{1..7}.gif
run	26	.../run/{1..26}.gif
sad	5	.../sad/{1..5}.gif
scared	43	.../scared/{1..43}.gif
shout	9	.../shout/{1..9}.gif
shrug	3	.../shrug/{1..3}.gif
shy	17	.../shy/{1..17}.gif
sigh	8	.../sigh/{1..8}.gif
sing	19	.../sing/{1..19}.gif
sip	12	.../sip/{1..12}.gif
slap	25	.../slap/{1..25}.gif
sleep	34	.../sleep/{1..34}.gif
slowclap	3	.../slowclap/{1..3}.gif
smack	18	.../smack/{1..18}.gif
smile	20	.../smile/{1..20}.gif
smug	21	.../smug/{1..21}.gif
sneeze	4	.../sneeze/{1..4}.gif
sorry	4	.../sorry/{1..4}.gif
stare	20	.../stare/{1..20}.gif
stop	9	.../stop/{1..9}.gif
surprised	19	.../surprised/{1..19}.gif
sweat	4	.../sweat/{1..4}.gif
thumbsup	6	.../thumbsup/{1..6}.gif
tickle	9	.../tickle/{1..9}.gif
tired	15	.../tired/{1..15}.gif
wave	22	.../wave/{1..22}.gif
wink	32	.../wink/{1..32}.gif
woah	8	.../woah/{1..8}.gif
yawn	10	.../yawn/{1..10}.gif
yay	10	.../yay/{1..10}.gif
yes	9	.../yes/{1..9}.gif

---

License

MIT © 2026 itsfizys