Magic Eye

Magic Eye is an image detection and moderation bot.

Unlike other bots that purely detect image reposts, Magic Eye was developed to actively support moderators with complex and unique removal workflows. It also has several other general moderation features.

Check out r/MagicEyeApp for support.

---

• Magic Eye
  • Setup
  • Information
    • General info
    • Repost removal workflow
  • Features and Configuration
  • How does it work?
  • Credits

Setup

There is just one step to adding Magic Eye to your subreddit:

• Invite MagicEye.

---

Once you've added Magic Eye it will:

• Accept the invite
• Build a database from the /new and /top posts in your subreddit (can take up to an hour)
• Create a settings page in your wiki at r/YOUR_SUB_NAME/wiki/magic_eye
• Send you a modmail to let you know it has finished initialising and is active

Information

General info

• By default it will work on both images and animated media (videos/gifs)

• If users reply to u/magiceyeapp, by default it will report the comment so you can check it out.

• Magic Eye has customizable repost settings.

• Magic Eye checks for new submissions roughly every minute, so avoid moderating posts that are very new if you want Magic Eye to process them first. It will ignore posts that have already been approved.

• On rare occasions, Magic Eye can misdetect images and when it does the images may not look anything like each other. It isn't a bug, Magic Eye just doesn't see the image like our eyes and brain do. If an image is cropped in specific ways it also may no longer match. It's a trade off which I am unable to change.

• You can reply to a removal message by u/magiceyeapp with clear and it'll remove the image from it's database. There's generally no need to do this, except perhaps for rare problematic images (eg, they have lots of grey space).

• Because of memory limits on the server, images greater than 6000 pixels in height or width will be ignored.

Repost removal workflow

Magic Eye is designed so it is easy to override old decisions or fix mistakes.

• When a repost is detected, Magic Eye looks at the current state of the last submission of that image to figure out what to do.
• If the last submission is approved/unmoderated, Magic Eye acts based on your repost settings.
• If the last submission is removed by a moderator...
  • ...and it is blacklisted: Magic Eye will automatically remove it for you.
  • ...and it is not blacklisted: Magic Eye will ignore it and treat the repost as a new submission.

Because of this, most subreddits will want to blacklist images. See the blacklisting section for how to do it automatically with Toolbox.

Features and Configuration

Find the configuration details for all Magic Eye settings here.

By default Magic Eye will:

• Remove recent reposts (15-50 day repost period)
• Remove blacklisted images (see how to blacklist images)
• Remove broken image links

But it has several other moderation features, such as reporting images over a karma threshold or removing small images.

How does it work?

A technical explaination of the algorithm can be found here.

Credits

• Base code copied from u/MAGIC_EYE_BOT's github.