explaingit

nvbn/mrw.wtf

Analysis updated 2026-08-04 · repo last pushed 2017-03-22

6ClojureAudience · developerComplexity · 4/5DormantSetup · hard

TLDR

A reaction GIF finder that lets you search with natural language and get matched to the perfect clip. It gathers GIFs from Reddit and Imgur and serves them through a web app, mobile apps, and a Telegram bot.

Mindmap

mindmap
  root((repo))
    What it does
      Natural language GIF search
      Reaction GIF discovery
      Matches text to GIFs
    Tech stack
      Clojure
      Elasticsearch
      Telegram bot
    Components
      Reddit and Imgur scraper
      Public API
      Web frontend
      Mobile apps iOS Android
    Use cases
      Find reaction GIFs fast
      Share GIFs in Telegram
      Reply with GIFs online
    Audience
      Reddit users
      Telegram users
      Frequent GIF users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Find the perfect reaction GIF by typing a natural-language description of how you feel.

USE CASE 2

Share reaction GIFs directly in Telegram chats via a bot.

USE CASE 3

Search for reaction GIFs from a web browser or mobile app on Android or iOS.

What is it built with?

ClojureElasticsearchTelegram Bot APIAndroidiOS

How does it compare?

nvbn/mrw.wtfnetb258/defn-systembenfleis/throttler
Stars67
LanguageClojureClojureClojure
Last pushed2017-03-222015-01-28
MaintenanceDormantDormant
Setup difficultyhardmoderateeasy
Complexity4/54/52/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

No setup guide or usage instructions are included, and the project requires Clojure, Elasticsearch, and multiple coordinated services to run.

The README does not include any license information, so the default terms of copyright apply and you should contact the author before using this code.

In plain English

This repository builds mrw.wtf, a service that helps people find the perfect reaction GIF. You know the feeling, someone says something online and you want to reply with a GIF that captures your reaction. Instead of scrolling endlessly through GIF libraries, this project lets you search with natural language and get matched to a relevant clip. The project is actually a collection of smaller services working together. One piece scans Reddit and Imgur to gather GIFs. Another analyzes the text you type so the system understands what kind of reaction you're looking for. A public API ties everything together, and there's a web frontend plus mobile apps for Android and iOS. There's also a Telegram bot, so you can find and share GIFs directly in chat. The search itself relies on Elasticsearch, which is a specialized tool for quickly finding relevant results from large collections of data. The main audience is people who frequently communicate with GIFs, anyone who hangs out on Reddit, Telegram, or similar platforms and wants a faster way to find the right reaction. "MRW" stands for "my reaction when," a common phrase people use when posting reaction GIFs, which is where the project gets its name. The README doesn't go into much detail beyond listing the components and mentioning Elasticsearch. There's no setup guide or usage instructions included, so getting it running would require some familiarity with the underlying technologies. The choice to split everything into separate services suggests the project was designed to be modular, but the README doesn't explain the reasoning behind that architectural decision.

Copy-paste prompts

Prompt 1
Help me set up the mrw.wtf reaction GIF finder. It is built in Clojure and uses Elasticsearch. Walk me through installing Clojure, setting up Elasticsearch locally, and running the main service so I can search for GIFs with natural language.
Prompt 2
I want to build a Telegram bot similar to mrw.wtf that lets users type a reaction description and get back a matching GIF. The original uses Clojure and Elasticsearch and scrapes Reddit and Imgur. Help me design the bot architecture and write the Telegram bot integration.
Prompt 3
I have the mrw.wtf project cloned but there is no setup guide. Based on what the README says, it uses Clojure, Elasticsearch, and has separate services for scraping Reddit and Imgur, help me figure out the project structure, infer how to start each service, and write a docker-compose file to bring up Elasticsearch and the Clojure app together.

Frequently asked questions

What is mrw.wtf?

A reaction GIF finder that lets you search with natural language and get matched to the perfect clip. It gathers GIFs from Reddit and Imgur and serves them through a web app, mobile apps, and a Telegram bot.

What language is mrw.wtf written in?

Mainly Clojure. The stack also includes Clojure, Elasticsearch, Telegram Bot API.

Is mrw.wtf actively maintained?

Dormant — no commits in 2+ years (last push 2017-03-22).

What license does mrw.wtf use?

The README does not include any license information, so the default terms of copyright apply and you should contact the author before using this code.

How hard is mrw.wtf to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is mrw.wtf for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.