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	61
Total GIFs	682
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": 61,
  "total_gifs": 682,
  "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	7	.../airkiss/{1..7}.gif
angrystare	18	.../angrystare/{1..18}.gif
bite	13	.../bite/{1..13}.gif
bleh	7	.../bleh/{1..7}.gif
brofist	8	.../brofist/{1..8}.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	22	.../cry/{1..22}.gif
cuddle	20	.../cuddle/{1..20}.gif
dance	18	.../dance/{1..18}.gif
drool	10	.../drool/{1..10}.gif
evillaugh	10	.../evillaugh/{1..10}.gif
facepalm	5	.../facepalm/{1..5}.gif
handhold	10	.../handhold/{1..10}.gif
happy	11	.../happy/{1..11}.gif
headbang	8	.../headbang/{1..8}.gif
hug	17	.../hug/{1..17}.gif
kiss	21	.../kiss/{1..21}.gif
laugh	16	.../laugh/{1..16}.gif
lick	10	.../lick/{1..10}.gif
love	9	.../love/{1..9}.gif
mad	20	.../mad/{1..20}.gif
nervous	13	.../nervous/{1..13}.gif
nom	18	.../nom/{1..18}.gif
nuzzle	9	.../nuzzle/{1..9}.gif
nyah	7	.../nyah/{1..7}.gif
pat	18	.../pat/{1..18}.gif
peek	6	.../peek/{1..6}.gif
pinch	9	.../pinch/{1..9}.gif
poke	14	.../poke/{1..14}.gif
pout	17	.../pout/{1..17}.gif
punch	12	.../punch/{1..12}.gif
sad	5	.../sad/{1..5}.gif
scared	17	.../scared/{1..17}.gif
shout	9	.../shout/{1..9}.gif
shrug	3	.../shrug/{1..3}.gif
shy	13	.../shy/{1..13}.gif
sigh	8	.../sigh/{1..8}.gif
sip	10	.../sip/{1..10}.gif
slap	16	.../slap/{1..16}.gif
sleep	18	.../sleep/{1..18}.gif
slowclap	3	.../slowclap/{1..3}.gif
smack	16	.../smack/{1..16}.gif
smile	14	.../smile/{1..14}.gif
sneeze	4	.../sneeze/{1..4}.gif
sorry	4	.../sorry/{1..4}.gif
stare	16	.../stare/{1..16}.gif
surprised	14	.../surprised/{1..14}.gif
sweat	4	.../sweat/{1..4}.gif
thumbsup	6	.../thumbsup/{1..6}.gif
tickle	9	.../tickle/{1..9}.gif
tired	12	.../tired/{1..12}.gif
wave	15	.../wave/{1..15}.gif
wink	18	.../wink/{1..18}.gif
woah	8	.../woah/{1..8}.gif
yawn	9	.../yawn/{1..9}.gif
yay	7	.../yay/{1..7}.gif
yes	8	.../yes/{1..8}.gif

---

License

MIT © 2026 itsfizys