Narwhal Bot

Narwhal Bot is a custom Discord bot that pulls random images from subreddit caches and lets you interact with them in fun ways.

📋 Cache System The bot doesn’t hit Reddit directly every time — instead, it builds a local cache of posts from each subreddit. A subreddit can only be used once it has been “ran against” (meaning the cache has been filled at least once). Until then, commands will return “No cache file found.” Once cached, images can be pulled instantly and repeatedly.

🔄 Feed Rotation & Resets The bot rotates through feeds: top day, top month, top year, hot, new. Daily feeds (day, hot, new) reset every new day. Monthly feed (month) resets when the calendar month changes. Yearly feed (year) resets when the year changes. This ensures caches stay fresh without losing long‑term pagination progress.

🎲 Commands /random subreddit → Pulls one random cached image. /faceoff subreddit → Shows two random cached images side‑by‑side. Vote with 🇦 or 🇧 to pick your favorite. /count subreddit → Shows how many images are currently cached.

📝 Notes Commands only work if the subreddit has been cached. The bot is designed for fun, voting, and sharing images — please keep interactions respectful. The bot will only allow posting of NSFW subreddit image URLs to Discord Channels that are marked 18+. Of course this system relies on the subreddit accurately being marked as NSFW. Additionally, a NSFW image can slip through in a SFW subreddit, so use discretion when using this app. This app is intended only for mature audiences, so use discretion.